Goal Maker: Skill для Codex, который превращает расплывчатые долгосрочные цели в управляемый PM-цикл

Работать с большими, долгосрочными задачами в Codex (или аналогичных AI-агентах) — классическая проблема. Цель начинается размыто, агент быстро «ныряет» в реализацию, верификация устаревает, а весь процесс теряет направление.

Goal Maker от tolibear — это специализированный Codex Skill, который вводит чёткий finite-state PM-цикл (Project Manager loop). Он превращает любую большую цель в структурированную доску задач с ролями Scout, Judge, Worker и обязательными отчётами (receipts).

## Что решает Goal Maker?

• Дрейф целей — агент перестаёт блуждать и постоянно возвращается к charter.
• Преждевременная реализация — перед кодингом всегда идёт разведка (Scout) и оценка (Judge).
• Отсутствие доказательств — каждое выполненное задание оставляет компактный receipt.
• Устаревание верификации — board всегда содержит актуальное состояние.

Результат: Codex работает как настоящий проектный менеджер с чётким процессом.

## Основная модель и роли

Goal Maker построен вокруг четырёх ключевых примитивов:

• Charter (goal.md) — описание цели, ограничения, текущий транш (этап) и правило остановки.
• Board (state.yaml) — единственный источник правды о задачах, статусах и receipts.
• Task — в любой момент активно только одно задание.
• Receipt — компактное доказательство того, что было сделано, почему задача завершена/заблокирована или эскалирована.

Роли (агенты):

• Scout — разведчик: анализирует репозиторий, спецификации, находит кандидатов в задачи.
• Judge — судья: оценивает приоритеты, риски, scope, проверяет завершение.
• Worker — исполнитель: выполняет одну чётко ограниченную задачу.
• PM — главный поток /goal, который владеет доской, выбирает следующую задачу и ведёт процесс.

## Как это работает

1. Устанавливаете Skill:

   bash копировать

   npx goal-maker

2. В Codex вызываете:

   code копировать

   $goal-maker

   Skill создаёт папку docs/goals/<slug>/ с goal.md и state.yaml.

3. Запускаете основной цикл:

   code копировать

   /goal Follow docs/goals/<slug>/goal.md

Далее Codex работает в цикле: Размытая цель → Discovery (Scout) → Board → Одна активная задача → Receipt → Обновление доски → Повтор

## Структура папки цели

docs/goals/<slug>/
├── goal.md          # Charter
├── state.yaml       # Доска задач + receipts
└── notes/           # Дополнительные большие заметки

Большинство результатов хранится прямо в state.yaml. Большие отчёты выносятся в notes/.

## Преимущества

• Отлично подходит для многочасовых и многодневных целей (автор упоминал рекорд 71 час).
• Дисциплинирует агента: не даёт сразу писать код на большую цель.
• Прозрачность — всегда видно, что сделано и почему.
• Легко проверять состояние доски через встроенный скрипт.
• Версия 0.2.x с улучшенной моделью receipts (v1 не поддерживается).

## Кому подойдёт Goal Maker?

• Разработчикам, которые используют Codex для серьёзных рефакторингов, улучшения проектов или долгосрочных фич.
• Тем, кто хочет превратить AI из «быстрого кодера» в настоящего junior/senior-разработчика под управлением PM.
• Командам и соло-разработчикам, работающим с крупными кодовыми базами.

## Заключение

Goal Maker — мощный инструмент для тех, кто устал от хаотичных длинных сессий с AI. Вместо «напиши мне большую фичу» вы получаете структурированный, контролируемый процесс с разведкой, оценкой рисков и доказательствами выполненной работы.

Ссылка на репозиторий: https://github.com/tolibear/goal-maker