agentleFS
goldenprofilegoldenprofile/llm-skills/skills/goal-pipeline/SKILL.md

goal-pipeline

Skill3 starsChanged 3 months agoMITView on GitHub

Планировщик-исполнитель поверх нативной /goal Claude Code: recon проекта, декомпозиция на фазы с измеримыми критериями, вшитые гейты качества по типу фазы, артефакты на диск и ОДНА готовая строка /goal — свежая сессия исполняет фазы с авто-ретраем, чекпоинтами на рискованных фазах и финальным аудитом. Заточен под brownfield. Используй когда пользователь говорит «прогон под goal», «разбей на фазы и запусти», «доведи до готового через goal», «автономно доделай». Для документа без исполнения — spec-writer; для greenfield — feature-dev.

  • Commits and pushes

The file

Files
SKILL.md

Goal Pipeline

Лёгкая обвязка вокруг нативной команды /goal Claude Code (платформенная привязка и механика команды — в references/claude-code-adapter.md).

Ключевое ограничение, из которого следует всё остальное: оценщик не запускает команды и не читает файлы — он судит только по тому, что исполнитель уже вывел в разговор. Поэтому условие должно проверяться по транскрипту, а доказательства обязаны быть в нём напечатаны. Автономность даёт хост, а не этот навык. Задача навыка — хорошо подготовить прогон (recon → фазы → измеримые критерии → вшитые гейты), выдать одну строку /goal для вставки и описать протокол, по которому исполняющая сессия читает фазы с диска и доводит задачу до конца.

Два актёра:

  • Планировщик — текущая сессия. Делает этапы 0–7, пишет артефакты, выдаёт строку /goal. На этом его работа заканчивается.
  • Исполнитель — свежая /goal-сессия, которую запускает твоя вставка. У неё нет контекста планировщика: всё, что ей нужно, лежит в файлах на диске.

Чем НЕ является (анти-коллизия)

Похоже наРазница
spec-writerТот только пишет документ (spec/plan/brief), ничего не исполняет. goal-pipeline планирует И запускает исполнение под /goal.
In-session петля (паттерн, не навык)Общая петля внутри текущей сессии, без хостового оценщика и фаз на диске. goal-pipeline отдаёт работу хостовому /goal — отдельная сессия, отдельный оценщик завершения.
feature-devТяжёлый greenfield-флоу design→architecture→build с суб-агентами. goal-pipeline легче, brownfield-first, опирается на /goal.

Когда брать / когда не брать

Брать: нетривиальная задача (≈ 3+ фазы, > часа работы) в существующем проекте, которую хочешь довести до конца без ручного пинка на каждом шаге — рефакторинг, миграция кода, новая фича поверх существующего, добавление тестов, сквозная правка по многим файлам.

Не брать:

  • Задача < 1 часа / 1–2 файла → просто сделай её, не разворачивай машинерию.
  • Нужен только проектный документ → spec-writer.
  • Задача — петля внутри одной сессии, без фаз и артефактов на диске → это не прогон, работай без этой обвязки.
  • Крупный greenfield с нуля → feature-dev.

Платформенный адаптер

Ядро навыка платформо-независимо: recon → декомпозиция на фазы с измеримыми критериями → артефакты на диске → вшитые гейты → ревью плана. Исполнение под хостовую /goal — привязка к Claude Code: доступность команды, trust dialog, auto mode / permissions.allow, hooks-оценщик, лимит аргумента (~4000 символов) и сборка строки /goal — предусловия и механика в references/claude-code-adapter.md.

Нет /goal в среде — автоматического прогона нет: скажи пользователю прямо и не изображай прогон. Дисциплина фаз переживает и без /goal: фазы исполняются по одной в обычных сессиях, сверяясь с .goalrun/ROADMAP.md и обновляя STATE.md.

Предусловия

Платформенные (доступность /goal, trust dialog, auto mode / permissions.allow, hooks-оценщик) — проверяются по references/claude-code-adapter.md. Отсюда общие для любой среды:

  1. Git-репозиторий — страховка. Прогон правит исходники автономно; без git откат болезненный. Если репо нет — предложи git init и первый коммит до старта.
  2. Понятные команды проекта (build/type/lint/test) — make-цели или прямые команды (ruff check ., pyright, pytest -q, python manage.py check).

Профили автономности

Выбирается в этапе 0 (дефолт — checkpoint-on-risky), пишется в STATE.md и зашивается в условие /goal. Рискованная фаза — та, чьи deliverables или mandatory-команды включают миграции БД, деплой/git push, destructive операции или смену публичного контракта. Полная таблица профилей и точное определение — в references/autonomy-and-gates.md.


Этап 0 — Контекст

  1. Профиль автономности — спроси одним AskUserQuestion, если не задан явно (дефолт checkpoint-on-risky). Запиши в STATE.md.

    Там же зафиксируй два ограничителя длины — без них full-auto не имеет верхней границы, кроме 3-strike, а петля «ретрай → fix → ретрай» жжёт токены:

    • Fix budget (дефолт 6) — сколько ремонтных раундов вправе потратить прогон (ретрай фазы, fix-спека, аудит-fix). Считает сам исполнитель; исчерпан → GP_HALT.
    • Turn cap (дефолт ≈ 8 ходов на фазу, минимум 20) — жёсткий потолок, он уходит прямо в условие /goal клаузой «ИЛИ пройдено N ходов». Его судит оценщик по разговору, а не исполнитель по своему счётчику, поэтому он переживает деградацию исполнителя.
  2. Git baseline — git rev-parse HEAD. Запиши в STATE.md как Baseline ref:; аудит диффает результат против него. Нет git → no-git, предложи инициализировать.
  3. Память — определи memory-каталог и подгрузи индекс. Путь бери из того, что харнесс показывает в начале сессии (он зависит от проекта — …\.claude\projects\<slug>\memory с MEMORY.md). Прочитай MEMORY.md, выборочно подними релевантные задаче файлы (предпочтения по стеку, project-факты). Не тащи всё. Применённые факты вынеси в ревью плана как «Из памяти: …».

Этап 1 — Интейк (0–2 вопроса)

Эхо задачи в одно предложение. Затем — только истинные пробелы, которые recon + память + промт не закрывают (brownfield почти всегда отвечает на стек, команды, конвенции сам):

  • граница scope («только этот модуль, или смежные тоже?»);
  • совместимость («ломаем старый путь или держим backward-compat?»);
  • развилка при двух равноправных существующих паттернах.

Если вопросов нет — скажи «Уточняющих вопросов нет, иду от промта + recon + памяти» и переходи к этапу 2. Микро-детали (имена, пути, формулировки) не спрашивай — они идут в ревью плана как предположения для правки в один клик.


Этап 2 — Recon (штатными инструментами, без скриптов)

Recon делает планировщик сам через Glob/Grep/Read и короткие команды в терминале твоей среды — не пиши для этого скриптов-файлов. Определи:

  • Стек и менеджер пакетов — pyproject.toml / requirements*.txt / Pipfile / package.json; Django (manage.py) / FastAPI / aiogram / прочее.
  • Команды build/type/lint/test — из Makefile (цели), pyproject.toml ([tool.ruff], [tool.pytest], [tool.mypy]), CI-конфига. Зафиксируй точные строки — они станут mandatory-командами фаз.
  • Релевантная область — модули/файлы, которые задача затронет; существующие конвенции, которые новый код обязан повторить.
  • Тонкие места — есть ли тесты на затрагиваемый код (если нет → нужна safety-net фаза), есть ли миграции, есть ли публичные контракты.

Выведи пользователю сводку в 5 строк: стек · менеджер · build/type/lint/test · затрагиваемая область · риск-зоны. Это доказывает, что ты понял проект до плана.


Этап 3 — Декомпозиция на фазы

Столько фаз, сколько реально нужно (нет фикс-лимита). Правила нарезки:

  • Каждая фаза проверяема сама по себе (билдится, проходит свои тесты, её можно показать как инкремент).
  • Явные зависимости между фазами.
  • Safety-net первой — если тесты на затрагиваемый код тонкие, первая фаза добавляет характеризующие тесты до изменения поведения (brownfield-страховка).
  • Polish & Harden последней — edge cases, error/empty/loading states, ввод, безопасность, перф, копирайт. Здесь «всё идеально» становится измеримым.

Каждая фаза описывается полями:

  • Имя (≤ 5 слов, действие-первым: «Add characterization tests»);
  • Зачем (1 предложение);
  • Deliverables (конкретные файлы/функции, которые появятся);
  • Критерии приёмки (5–10 измеримых, yes/no — не «работает», а проверяемый предикат);
  • Mandatory commands (что обязано пройти зелёным: make-цели или прямые команды);
  • Гейты (вшитые навыки/команды — таблица в references/autonomy-and-gates.md);
  • Evidence (что агент печатает в транскрипт как доказательство);
  • Зависимости (какие фазы должны быть готовы);
  • Risky? (да/нет — по определению из «Профили автономности»).

Вшитые гейты по типу фазы

Главное отличие от голого /goal: гейты ставятся точечно по типу фазы (не на каждую — чтобы не жечь токены) и финальным sweep в Polish-фазе. Таблица «фаза → гейт» и замена недоступных гейтов — references/autonomy-and-gates.md. Лёгкие проверки (build/type/lint/test) — каждую фазу; на этапе recon проверь наличие /code-review, /security-review, pyright и вшивай только доступное.


Этап 4 — Артефакты прогона на диск

Всё в .goalrun/ в корне проекта (исполнитель читает их с диска — у /goal нет контекста планировщика). Напомни добавить .goalrun/ в .gitignore.

  1. .goalrun/ROADMAP.md — план: профиль автономности, baseline ref, список фаз с полями из этапа 3.
  2. .goalrun/STATE.md — живой прогресс: Status, Current phase, Baseline ref, Profile, Fix budget (остаток), Turn cap, лог событий. Исполнитель обновляет после каждой фазы; по нему же он находит точку старта после GP_HALT и ре-диспатча.
  3. .goalrun/PROTOCOL.md — копия references/executor-protocol.md (цикл исполнителя, 3-strike, финальный аудит, маркеры, memory writeback). Исполнитель — свежая сессия; протокол обязан лежать на диске, а не в контексте планировщика.
  4. .goalrun/phases/phase-N.md — по файлу-спеке на фазу. Любой длины (читается с диска, не идёт в аргумент /goal). Начинается маркер-блоком:
GP_PHASE_START
Phase: <N> of <total> — <имя>
Risky: <yes|no>
Mandatory commands: <список команд проекта>
Gates: <список вшитых гейтов или "none">
Acceptance criteria: <count>
Evidence required: <список>
Depends on: <фазы или "none">

[... полное описание работы, критерии, требования к доказательствам ...]

Пример полной спеки фазы и готовой строки /goal — references/phase-spec-example.md.


Этап 5 — Ревью плана (жёсткий гейт)

Прогон идёт без надзора — это последний дешёвый момент поправить курс.

5a. Self-critique (один проход). Перед печатью сводки ответь на 3 вопроса и покажи результат честно (находки ИЛИ «clean», не театр):

  1. Фальсифицируемость — каждый критерий приёмки yes/no? Помечай «работает», «готово», «корректно» без измеримого предиката и перепиши на месте в phase-N.md.
  2. Атомарность — нет ли фазы, которая втайне две (имя с «и», deliverables без общего verify-гейта)?
  3. Слабейшая зависимость — где частичный провал каскадит хуже всего?

5b. Сводка — компактно: число фаз · профиль автономности · список фаз (имя — однострочный deliverable, risky-фазы помечены ⚠) · стек и команды · ключевые предположения (правь любое) · топ-3 риска и митигейшн · что из памяти применено · находки self-critique · путь к артефактам.

5c. AskUserQuestion с одним вопросом «Старт?» и конкретными режимами правки (не размытое «исправить план»): Старт · Поправить предположение · Тронуть фазу (критерии/scope/команды) · Переструктурировать фазы. При правке — примени, обнови артефакты, пере-покажи сводку, спроси снова. Не диспатчь /goal, пока не выбрано «Старт». Никогда не считай молчание подтверждением.


Этап 6 — Pre-flight

После «Старт» и до выдачи строки /goal прогони объединённый (дедуплицированный) набор mandatory-команд один раз в терминале. Это ловит уже-сломанный baseline (например pytest красный ещё до фазы 1).

  • Всё зелёное → запиши Pre-flight green в STATE.md, переходи к этапу 7.
  • Что-то красное → покажи падающую команду (код выхода + последние ~5 строк), верни меню этапа 5 с опцией «Игнорировать pre-flight, диспатчить» (вдруг чинить красный baseline — и есть задача фазы 1). Любой другой выбор → обычная правка плана.

Этап 7 — Выдать строку /goal (одна вставка)

Слэш-команды срабатывают только от ввода пользователя — планировщик не может запустить /goal сам, поэтому финал планировщика — одна вставка. Обнови STATE.md (Status: READY_TO_DISPATCH, Current phase: 1, baseline ref, Fix budget, Turn cap), проверь, что все .goalrun/phases/phase-N.md существуют и содержат GP_PHASE_START, затем собери и напечатай fenced-блок с готовой строкой /goal по рецепту из references/claude-code-adapter.md: условие держит только точку входа (PROTOCOL.md + Current phase) и done-предикат — процедура лежит в протоколе на диске, поэтому строка не дублирует его и не расходится с ним при обновлении. Под блоком — ровно одна строка инструкции пользователю, затем стоп: больше ничего не выводи, прогон начинается с вставки пользователя.


Протокол исполнителя, маркеры, память

Полный цикл исполнителя, таблица маркеров GP_* и memory writeback — в references/executor-protocol.md; планировщик копирует его в .goalrun/PROTOCOL.md на этапе 4 — исполнитель читает протокол с диска, а не из контекста.


Связанные навыки

  • spec-writer — если перед прогоном нужен проектный документ (spec/plan), напиши его, затем скорми goal-pipeline как вход. spec-writer не исполняет.
  • feature-dev — для крупного greenfield с архитектурным дизайном.
  • harness-engineering — вшитые здесь гейты (migration-safety-auditor, /code-review, test-coverage-auditor, pyright) — те же, что harness-engineering кладёт в Definition of Done проекта. goal-pipeline исполняет DoD внутри прогона.
  • migration-safety-auditor / change-review / python-project-audit / test-coverage-auditor — вызываются как гейты по типу фазы (таблица в references/autonomy-and-gates.md).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.