**UNIVERSAL TRIGGER**: Use when user wants to START/CONTINUE/MANAGE a long-running development project across multiple sessions.
Common patterns:
- "start/init/begin new project [description]"
- "continue/resume working on [project]"
- "начать/инициализировать проект", "продолжить работу над проектом"
- "set up harness for [project]", "create project scaffolding"
Session types supported:
🚀 **Initialize (first run)**:
- "init long-running project", "start new multi-session project"
- "set up project harness", "create progress tracking"
- "initialize [web-app/api/cli] project", "начать долгий проект"
🔄 **Continue (subsequent sessions)**:
- "continue project", "resume work", "продолжить работу"
- "pick up where I left off", "what's next", "следующая фича"
- "next feature", "continue implementation"
📊 **Status & Progress**:
- "show project progress", "what features are done"
- "project status", "статус проекта", "что сделано"
- "remaining features", "what's left to do"
🔧 **Management**:
- "mark feature as d
Входные данные: Не требуются (читаем из артефактов).
Обновляемые артефакты:
progress.md — добавляется новая запись
features.json — passes: false → true для завершённых фич
Git commit с описательным сообщением
3. status — Просмотр прогресса
Когда использовать: Посмотреть что сделано/осталось.
Формат артефактов
.claude/features.json
{"project":"claude-clone","type":"web-app","created_at":"2025-12-02T10:00:00Z","total_features":47,"completed":12,"features":[{"id":"F001","category":"core","priority":1,"description":"User can send message and receive AI response","verification_steps":["Open app in browser","Type message in input field","Press Enter or click Send","Verify AI response appears within 5 seconds"],"passes":false,"completed_at":null,"session_id":null},{"id":"F002","category":"core","priority":1,"description":"Conversation history persists after page reload","verification_steps":["Send a message","Reload the page","Verify conversation is still visible"],"passes":true,"completed_at":"2025-12-02T14:30:00Z","session_id":"session-003"}]}
Правила для features.json:
❌ НИКОГДА не удалять фичи
❌ НИКОГДА не редактировать description уже существующих фич
✅ ТОЛЬКО менять passes: false → true после верификации
✅ ТОЛЬКО добавлять новые фичи в конец списка
.claude/progress.md
# Project Progress Log## Project: claude-clone**Type**: web-app
**Stack**: Next.js, TypeScript, Tailwind CSS
**Started**: 2025-12-02
---
## Session 5 | 2025-12-02 14:30 | session-005**Focus**: Dark mode implementation
**Duration**: ~45 min
### Completed Features- ✅ F012: Dark mode toggle button
- ✅ F013: Theme persistence in localStorage
### In Progress- 🔄 F014: System theme detection (80% done, need media query listener)
### Blockers- None
### Technical Decisions- Used CSS variables for theming (easier to maintain)
- Chose `prefers-color-scheme` media query over JS detection
### Next Session Should1. Complete F014 (system theme detection)
2. Start F015 (conversation sidebar)
3. Run full E2E test suite
### Git Commits This Session-`a3f2b1c` feat: add dark mode toggle component
-`e5d4c3b` feat: persist theme in localStorage
-`f7e8d9a` refactor: extract theme utils
---
## Session 4 | 2025-12-02 12:00 | session-004
...
scripts/init.sh
Назначение: Setup окружения чтобы агент мог сразу начать работу.
НЕ путать с: Запуском dev-сервера. init.sh — это подготовка, не запуск.
Что делает init.sh:
Устанавливает зависимости (bundle/npm/yarn)
Настраивает базу данных (migrations, seeds)
Копирует .env файлы из примеров
Запускает smoke tests для проверки что всё работает
Человек → Claude:
"Инициализируй долгосрочный проект: [описание проекта].
Тип: web-app. Стек: Next.js + TypeScript."
Claude выполнит:
1. Создаст структуру .claude/ с артефактами
2. Сгенерирует 30-200 фич на основе описания
3. Создаст init.sh скрипт
4. Сделает initial git commit
Как запустить CONTINUE сессию
Вариант 1 — Простой запуск:
Человек → Claude:
"Продолжи работу над проектом"
Claude выполнит startup checklist автоматически.
Вариант 2 — С указанием фокуса:
Человек → Claude:
"Продолжи проект, сфокусируйся на фичах авторизации"
Вариант 3 — Проверка статуса перед работой:
Человек → Claude:
"Покажи статус проекта и что делать дальше"
Когда завершать сессию
Оператор должен завершить сессию когда:
⏰ Прошло 30-45 минут активной работы
✅ Завершена 1-2 фичи
🔄 Claude начинает делать много изменений без коммитов
⚠️ Контекст становится длинным (Claude начинает забывать)
Команда для завершения:
Человек → Claude:
"Заверши сессию. Обнови progress.md, закоммить изменения,
напиши что делать в следующей сессии."
Startup Checklist (автоматический)
При каждом continue Claude ОБЯЗАН выполнить:
┌─────────────────────────────────────────────────────────────┐
│ SESSION STARTUP CHECKLIST │
├─────────────────────────────────────────────────────────────┤
│ 1. ☐ pwd → подтвердить рабочую директорию │
│ 2. ☐ git status → проверить чистоту репозитория │
│ 3. ☐ git log -5 → последние коммиты │
│ 4. ☐ cat .claude/progress.md → что было сделано │
│ 5. ☐ cat .claude/features.json → статус фич │
│ 6. ☐ ./scripts/init.sh → setup environment + smoke test │
│ 7. ☐ Выбрать ОДНУ фичу (highest priority, passes=false) │
│ 8. ☐ Объявить какую фичу будем делать │
└─────────────────────────────────────────────────────────────┘
Session End Checklist (автоматический)
Перед завершением сессии Claude ОБЯЗАН:
┌─────────────────────────────────────────────────────────────┐
│ SESSION END CHECKLIST │
├─────────────────────────────────────────────────────────────┤
│ 1. ☐ Все изменения закоммичены (git status clean) │
│ 2. ☐ features.json обновлён (passes=true для готовых) │
│ 3. ☐ progress.md обновлён (новая запись сессии) │
│ 4. ☐ Указано что делать в следующей сессии │
│ 5. ☐ Нет TODO комментариев в коде │
│ 6. ☐ Базовый smoke test проходит │
└─────────────────────────────────────────────────────────────┘
Failure Modes & Solutions
Проблема
Как предотвращаем
Claude объявляет проект готовым слишком рано
features.json с полным списком фич
Баги и недокументированный прогресс
Обязательный smoke test + progress.md
Фичи помечаются готовыми без тестирования
Verification steps в каждой фиче
Время тратится на понимание как запустить
init.sh скрипт
Потеря контекста между сессиями
progress.md + git log
Попытка сделать слишком много за раз
Правило "1 фича за сессию"
Примеры использования
Пример 1: Инициализация web-app
Человек: "Инициализируй долгосрочный проект: клон Notion с
базовыми функциями - страницы, блоки, drag-and-drop.
Тип: web-app. Стек: Next.js, TypeScript, Prisma, PostgreSQL."
Claude:
1. Создаёт .claude/features.json с ~50 фичами
2. Создаёт .claude/progress.md
3. Создаёт scripts/init.sh
4. git init && git add . && git commit -m "Initial project setup"
5. Выводит summary и рекомендации для первой continue сессии
Пример 2: Continue сессия
Человек: "Продолжи работу"
Claude:
1. Выполняет startup checklist
2. Читает progress.md: "Session 3 закончилась на F007"
3. Читает features.json: F008 = "User can create new page"
4. Запускает init.sh, проверяет smoke test
5. Объявляет: "Буду работать над F008: создание новой страницы"
6. Реализует фичу инкрементально
7. Тестирует end-to-end
8. Обновляет features.json: passes=true
9. git commit -m "feat: implement page creation (F008)"
10. Обновляет progress.md
