От спеки до тикета в main

Финальный Lab курса. Вы соберёте весь путь большой задачи в одном месте: спека в трекере, тикеты вертикальными срезами, один тикет, доведённый агентом до коммита, — и ваше собственное решение о том, как работать с агентом дальше.

Что получится

В конце у вас есть:

• issue со спекой фичи «аналитика для инструктора» в вашем форке Cadence;
• 3–6 sub-issues — тикетов, каждый из которых проходит через все слои приложения;
• коммит в рабочей ветке, который закрывает первый тикет, с тестами и отчётом ревью по двум осям;
• файл MY_AGENT_PLAN.md с вашим решением, как вы будете использовать coding-агента.

Подготовка

• Стенд курса: Claude Code, форк ai-hero-dev/ai-coding-crash-course с Cadence, Node 24+, pnpm, запущенная локальная база.
• Трекер из этого раздела: gh авторизован, репозиторий настроен на GitHub Issues.
• Рабочая ветка, отличная от main.
• 15–30 минут без переключений: grilling требует вашего внимания.

Шаги

1. Поставьте skill-ы спеки. В корне форка выполните npm run reset и выберите шаг to-spec-skill. В .agents/skills/ появится to-spec.

2. Проведите grilling. Запустите claude и выполните /grill-me, описав задачу: инструктор (Sarah Chen) открывает дашборд и не видит ни числа студентов, ни выручки, ни процента завершения, ни результатов квизов. Отвечайте на вопросы агента, пока он не перестанет их задавать. Следите, чтобы объём не расползался: «аналитика» легко становится бесконечной.

3. Создайте спеку. В той же сессии выполните /to-spec. Агент опубликует issue со спекой и меткой ready-for-agent. Откройте её на GitHub и прочитайте: проблема, решение, user stories, решения по реализации, тестам и что вне scope.

4. Нарежьте тикеты. Выполните npm run reset, выберите шаг to-tickets-skill, вернитесь в ту же сессию (/resume, если вы её закрыли) и выполните /to-tickets. Агент предложит разбиение. Отклоняйте горизонтальные тикеты вроде «сделать схему БД» и слишком большие. Утвердите, когда каждый тикет — тонкий срез через все слои. Тикеты появятся как sub-issues спеки.

5. Очистите контекст. Посмотрите заполненность окна через /context, затем выполните /clear: решения уже записаны в спеку и тикеты.

6. Поставьте skill-ы выполнения. Выполните npm run reset и выберите шаг implement-skill. В .agents/skills/ появятся implement, tdd и code-review.

7. Включите auto mode. Нажимайте Shift+Tab, пока в статусной строке не появится auto mode on.

8. Выполните первый тикет. Скопируйте ссылку на первый незаблокированный sub-issue и выполните:

   /implement <issue-url>

   Агент предложит seams для тестов — подтвердите или поправьте. Дальше он пишет падающие тесты, реализацию, прогоняет typecheck и тесты, запускает ревью и коммитит.

9. Прочитайте ревью. В отчёте найдите ось Standards и ось Spec. Если Spec говорит о недостающем требовании или о лишнем коде, попросите агента исправить и повторить ревью.

10. Закройте тикет. Закройте sub-issue на GitHub вручную или попросите агента.

11. Запишите решение. Создайте в своём рабочем репозитории (не в Cadence) MY_AGENT_PLAN.md и ответьте в нём на три вопроса:

    • какие задачи вы будете отдавать агенту и каким способом: один промпт, спека и тикеты, /goal;
    • где агенту не место в вашей работе и почему;
    • какое первое правило вы запишете в CODING_STANDARDS.md своего проекта.

Проверка результата

• gh issue list --state all показывает спеку и её тикеты; первый тикет закрыт.
• git log --oneline -3 показывает коммит агента, который ссылается на работу первого тикета.
• Тесты проходят: npm test завершается без ошибок.
• В отчёте ревью есть обе оси, и по оси Spec нет невыполненных требований тикета.
• MY_AGENT_PLAN.md отвечает на все три вопроса — и хотя бы один ответ называет задачу, которую вы агенту не отдадите.

Если не получилось

• /to-spec или /implement не находится. Skill-ы появляются после npm run reset на нужном шаге. Проверьте, что .agents/skills/<name>/SKILL.md существует, и перезапустите сессию.
• Спека не появилась в трекере. Проверьте gh auth status и что форк настроен на GitHub Issues.
• Тикеты получились горизонтальными. Скажите агенту, какой тикет — слой, а не срез, и попросите собрать каждый тикет из всех слоёв.
• /review дал «чужой» отчёт. /review — алиас встроенного ревью Claude Code. Вызывайте /code-review: project skill с этим именем заменяет встроенную команду.
• Агент спрашивает разрешение на каждую команду. Вы не в auto mode — вернитесь к шагу 7.

Проверь себя

Источники

• Anthropic, Commands — /clear, /context, /resume, /code-review, /review
• Anthropic, Choose a permission mode — auto mode и Shift+Tab
• Anthropic, Extend Claude with skills — «Resolve skills that share a name»
• По мотивам AI Coding Crash Course, AI Hero: «Write Great Specs With This Skill», «Split Features Across Context Windows With Tickets», «Executing Your Tickets»