Lab: фича в цикле grill → execute → clear

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

В Cadence появятся комментарии к урокам: студенты и преподаватели оставляют их на странице урока, и комментарии видны другим пользователям. Решения о фиче — кто может писать, нужны ли ответы, что с HTML — вы примете в допросе с агентом, а не узнаете из готового кода.

К концу у вас будут:

• commit с фичей в вашей ветке Cadence;
• записанный список решений из допроса;
• три замера /context: после допроса, после реализации и после /clear.

Подготовка

• Стенд из раздела 1: Claude Code с подпиской или API-ключом, Node 24+, pnpm.
• Клон учебного репозитория ai-hero-dev/ai-coding-crash-course с установленными зависимостями.
• Bite-ы 4.6–4.9: plan mode, цикл grill → execute → clear, compaction, граница этапа.
• 30–40 минут без перерыва: допрос и реализация идут в одной session.

Шаги

1. Переведите репозиторий на стартовую точку урока. Запустите pnpm run reset и выберите в списке урок с grill-me-skill. В репозитории появится skill grill-me в каталоге .agents/skills/.

2. Запустите claude в корне репозитория. Наберите / и найдите grill-me в списке. Если его нет, смотрите «Если не получилось».

3. Начните допрос с короткой, неполной постановки:

   /grill-me I want to add comments to lessons so students can ask questions and discuss. Instructors should be able to comment too.

   Агент начнёт исследовать код и задаст первый раунд вопросов.

4. Отвечайте раунд за раундом. В каждом раунде ответьте на все вопросы. Записывайте в отдельный файл вне репозитория каждое принятое решение одной строкой: «Кто может комментировать — студенты с доступом к уроку и преподаватели». Продолжайте, пока агент не скажет, что открытых вопросов не осталось.

5. Запустите /context и запишите, сколько токенов занято. Это замер после допроса.

6. В той же session попросите реализовать фичу:

   Implement lesson comments exactly as we agreed. Run the tests when you are done.

   Следите, как агент работает: какие файлы трогает, запускает ли тесты, спрашивает ли о чём-то, что вы уже решили.

7. Когда агент закончит, снова запустите /context и запишите цифру. Это замер после реализации.

8. Запустите приложение командой pnpm run dev в отдельном терминале и проверьте фичу руками: откройте урок вроде «Connecting to a Database», оставьте комментарий от студента, переключитесь на другого пользователя и вернитесь к тому же уроку. Пройдите по своему списку решений и проверьте каждое, которое можно увидеть в интерфейсе: пустое состояние, кто может писать, как отображается текст с HTML-тегами.

9. Если что-то не работает, опишите агенту симптом в той же session и дайте ему исправить. Повторите проверку.

10. Попросите агента закоммитить изменения:

    Commit these changes with a descriptive message.

11. Запустите /clear, затем /context. Запишите третий замер.

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

• git log -1 показывает commit с комментариями к урокам, git status чистый.
• Комментарий, оставленный от студента, виден другому пользователю на той же странице урока.
• Каждое решение из вашего списка либо видно в интерфейсе, либо вы можете показать, где оно в коде.
• Третий замер /context намного меньше второго: в новом разговоре нет ни допроса, ни реализации.

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

• grill-me нет в списке после /. Claude Code ищет skill-ы проекта в .claude/skills/<skill-name>/SKILL.md. Если skill лежит только в .agents/skills/, скопируйте его каталог в .claude/skills/ или создайте там symlink и перезапустите claude.
• Агент сразу начал писать код вместо вопросов. Остановите его клавишей Esc, откатите изменения через git checkout . и начните заново с /grill-me, проверив, что skill выбран из списка.
• Session сжалась посреди реализации. Это auto-compaction. Проверьте, не забыл ли агент пункты из вашего списка решений, и напомните о пропущенных. В следующий раз начинайте реализацию с меньшим контекстом.
• Агент спрашивает то, что вы уже решили. Значит, ответ был неоднозначным. Ответьте ещё раз конкретно и добавьте решение в свой список.

Проверь себя

Источники

• Anthropic, Extend Claude with skills
• Anthropic, Commands
• Anthropic, Interactive mode
• По мотивам AI Coding Crash Course, AI Hero: «The Grill-Execute-Clear Loop»