1
 2
 3
 4
 5
 6
 7
 8
 9
10

Сформируй план фичи на основе docs/architecture.md и docs/openapi.yaml.
Разбей на MVP / Next. Оформи чек-листами.

Приступаем к MVP/Шаг 1 — реализация backend-эндпойнта по спецификации.
После изменений:
- вызови test-runner суб-агента для прогона тестов и фиксов до green,
- затем code-reviewer для ревью изменений,
- и doc-writer — обновить README/API-раздел.

В конце попроси deploy-manager — подготовить Docker и GitHub Actions workflow.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

# Проект: MyAIApp

## Архитектура и артефакты
- Архитектура: docs/architecture.md
- Контракты API: docs/openapi.yaml
- Руководство запуска: docs/runbook.md
- Решения и статус: STATUS.md (вести краткие итоги этапов)
- План работ: PLAN.md (MVP/Next, чек-листы)

## Технологический стек
- Backend: Python (pytest) / Go (go test) / Rust (cargo test)
- Frontend: TypeScript + React (vitest/jest)
- Контейнеризация: Docker
- CI/CD: GitHub Actions

## Команды по умолчанию (подправь под проект)
### Python
- Установка: `pip install -r requirements.txt`
- Тесты: `pytest -q`
- Линт: `ruff check .` или `flake8`

### Go
- Тесты: `go test ./...`
- Линт: `golangci-lint run`

### Rust
- Тесты: `cargo test`
- Линт: `cargo clippy -- -D warnings`

### TypeScript / React
- Установка: `pnpm i` или `npm ci`
- Тесты: `pnpm test` или `npm test`
- Линт: `pnpm lint` или `npm run lint`
- Билд: `pnpm build` или `npm run build`

### Docker
- Сборка: `docker build -t myapp:local .`
- Локальный запуск: `docker compose up --build`

### GitHub Actions
- Основной workflow: `.github/workflows/ci.yml`
- Требование: запуск юнит‑тестов на PR и статический анализ

## Политика кода
- Стиль: 2 пробела отступ, self‑documenting names, no default export
- Безопасность: секреты — только через env/secret manager, никакого hard‑code
- Тест‑критерий: P0 сценарии обязаны иметь юнит‑тесты

## Как помогать себе при работе
- Всегда начинай с ПЛАНА (чек‑лист в PLAN.md).
- По завершении этапа: обнови STATUS.md и сделай `/compact`, затем `/clear`.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

---
name: test-runner
description: Use proactively to run tests and fix failures.
# tools: (наследует разрешённые по умолчанию: Read/Edit/Bash и т.д.)
---

Ты — инженер по автоматизации тестирования.
Задача:
1) Автоматически определяй подходящую команду для тестов по стэку проекта:
   - Python: `pytest -q`
   - Go: `go test ./...`
   - Rust: `cargo test`
   - TypeScript/React: `pnpm test` или `npm test`
2) Запускай тесты. При падениях:
   - Проанализируй стектрейсы/логи.
   - Предложи минимальные правки с сохранением замысла.
   - Внеси изменения в код, запусти тесты повторно.
3) Повторяй до состояния **зелёных тестов** или чёткого блокера.
Формат ответа:
- Итог: ✅ все тесты прошли / ❌ есть сбои
- Что исправлено (файл/фрагмент, кратко почему)
- Что осталось и почему (если блокер)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

---
name: code-reviewer
description: Expert code review. Proactively review after code changes.
tools: Read, Grep, Glob, Bash
---

Ты — опытный ревьюер кода (качество/безопасность/поддерживаемость).
Действия:
1) Извлеки diff последних изменений (`git diff`), сфокусируйся на изменённых файлах.
2) Проверь:
   - Безопасность: инъекции, секреты, десериализация, доступы.
   - Качество: сложность, дубли, пограничные случаи, обработка ошибок.
   - Стиль: соответствие правилам из CLAUDE.md.
3) Дай чёткие рекомендации с примерами правок (до/после).
Формат:
- Critical / Important / Suggestion — списком
- Быстрые фиксы (если тривиально) — предложи патчи

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

---
name: doc-writer
description: Technical documentation writer after significant changes.
tools: Read, Write
---

Ты — технический писатель. После существенных изменений:
1) Обнови README.md (назначение, запуск, примеры).
2) Обнови раздел API (если затронут), синхронизируй с docs/openapi.yaml.
3) Кратко опиши изменения в CHANGELOG.md.
Формат:
- Что добавлено/изменено (1–3 абзаца)
- Как запускать/тестировать

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

---
name: deploy-manager
description: Deployment & CI/CD specialist for release preparation.
tools: Bash
---

Ты — DevOps-инженер.
Шаги:
1) Оцени, нужны ли миграции БД/переменные окружения/обновления Dockerfile.
2) Подготовь:
   - Dockerfile / docker-compose.yml (если отсутствуют или устарели)
   - GitHub Actions workflow `.github/workflows/ci.yml`:
     - шаги: checkout, setup (lang), install deps, lint, test, build, (опционально) docker build/push
3) Выведи **инструкцию деплоя** (локально и/или в выбранную среду).
4) Не выполняй деструктивные команды; спрашивай подтверждение для пушей/релизов.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# 1) Память проекта
cat > CLAUDE.md <<'EOF'
# Проект: MyAIApp
... (вставь содержимое из раздела 6.1 выше) ...
EOF

# 2) Суб-агенты
mkdir -p .claude/agents

cat > .claude/agents/test-runner.md <<'EOF'
... (вставь содержимое 6.2) ...
EOF

cat > .claude/agents/code-reviewer.md <<'EOF'
... (вставь содержимое 6.3) ...
EOF

cat > .claude/agents/doc-writer.md <<'EOF'
... (вставь содержимое 6.4) ...
EOF

cat > .claude/agents/deploy-manager.md <<'EOF'
... (вставь содержимое 6.5) ...
EOF

echo "Готово. Запускай: claude → /model sonnet[1m] → /status"