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
In this repository25 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- advanced-seo-optimizerSkill
- agent-workflowSkill
- aiogram-bot-auditorSkill
- change-reviewSkill
- codebase-reconSkill
- dependency-auditorSkill
- django-auditSkill
- docs-generatorSkill
- fastapi-architectSkill
- git-commit-plannerSkill
- harness-engineeringSkill
- migration-safety-auditorSkill
- obsidianSkill
- postgres-performanceSkill
- python-project-auditSkill
- ratchet-loopSkill
- release-managerSkill
- sageSkill
- session-catchupSkill
- spec-writerSkill
- test-coverage-auditorSkill
- ui-dnaSkill
- vps-opsSkill
The file
Files
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.
Отсюда общие для любой среды:
- Git-репозиторий — страховка. Прогон правит исходники автономно; без git
откат болезненный. Если репо нет — предложи
git initи первый коммит до старта. - Понятные команды проекта (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 — Контекст
Профиль автономности — спроси одним
AskUserQuestion, если не задан явно (дефолт checkpoint-on-risky). Запиши вSTATE.md.Там же зафиксируй два ограничителя длины — без них
full-autoне имеет верхней границы, кроме 3-strike, а петля «ретрай → fix → ретрай» жжёт токены:Fix budget(дефолт 6) — сколько ремонтных раундов вправе потратить прогон (ретрай фазы, fix-спека, аудит-fix). Считает сам исполнитель; исчерпан →GP_HALT.Turn cap(дефолт ≈ 8 ходов на фазу, минимум 20) — жёсткий потолок, он уходит прямо в условие/goalклаузой «ИЛИ пройдено N ходов». Его судит оценщик по разговору, а не исполнитель по своему счётчику, поэтому он переживает деградацию исполнителя.
- Git baseline —
git rev-parse HEAD. Запиши вSTATE.mdкакBaseline ref:; аудит диффает результат против него. Нет git →no-git, предложи инициализировать. - Память — определи 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.
.goalrun/ROADMAP.md— план: профиль автономности, baseline ref, список фаз с полями из этапа 3..goalrun/STATE.md— живой прогресс:Status,Current phase,Baseline ref,Profile,Fix budget(остаток),Turn cap, лог событий. Исполнитель обновляет после каждой фазы; по нему же он находит точку старта послеGP_HALTи ре-диспатча..goalrun/PROTOCOL.md— копияreferences/executor-protocol.md(цикл исполнителя, 3-strike, финальный аудит, маркеры, memory writeback). Исполнитель — свежая сессия; протокол обязан лежать на диске, а не в контексте планировщика..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», не театр):
- Фальсифицируемость — каждый критерий приёмки yes/no? Помечай «работает»,
«готово», «корректно» без измеримого предиката и перепиши на месте в
phase-N.md. - Атомарность — нет ли фазы, которая втайне две (имя с «и», deliverables без общего verify-гейта)?
- Слабейшая зависимость — где частичный провал каскадит хуже всего?
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).
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
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.

