Руководства
Новый проект
От спецификации до работающего кода — пошаговое руководство
Новый проект: от спеки до кода
Шаг 1: Создать проект и SPEC.md
mkdir my-project && cd my-project
git initСоздать SPEC.md с описанием:
# My Project
## Technology Stack
- TypeScript, Node.js
- PostgreSQL with Prisma
- Vitest for testing
## Architecture
- REST API with Express
- 3-layer: routes → services → repositories
## Features
### Phase 1: Auth
- User registration
- Login with JWT
### Phase 2: CRUD
- Items CRUD endpoints
- Validation middlewareШаг 2: Инициализация
dev-workflow initШаг 3: Заполнить vault из спеки
В Claude Code:
/vault:from-spec4 фазы с approval. После завершения — vault заполнен, задачи созданы, файлы фаз сгенерированы.
Шаг 4: Проверить состояние
dev-workflow status
dev-workflow task listШаг 5: Реализовать Phase 1
/workflow:dev .dev-vault/phases/phase-1-auth.mdPipeline в phase mode:
- READ — сканирует проект
- PLAN — разбивает фазу на подзадачи с pseudo-code
- PLAN_REVIEW — 9 критериев
- CODER (для каждой подзадачи, test-first)
- REVIEW×3 (security + quality + coverage)
- TEST (после каждой подзадачи)
- VERIFY — соответствие спеке
- COMMIT — один коммит на фазу
Шаг 6: Записать находки
/session:handover
/vault:adr # если было архитектурное решениеШаг 7: Phase 2 и далее
dev-workflow task done <task-id>/workflow:dev .dev-vault/phases/phase-2-crud.mdПовторить для каждой фазы.