Установка
Как установить и настроить dev-workflow
Установка
Требования
- Node.js 20+
- Git-репозиторий
- Claude Code (VS Code extension или CLI)
Установка
npm install -g @engramm/dev-workflowИз исходников (для разработки)
cd dev-workflow
pnpm install
pnpm run build
npm linkИнициализация в проекте
cd your-project
dev-workflow initКоманда init создаёт:
| Что | Где | Назначение |
|---|---|---|
| CLAUDE.md | ./CLAUDE.md | Инструкции для Claude Code (команды, vault, workflow) |
| Vault | .dev-vault/ | Хранилище знаний (stack, conventions, knowledge, gameplan, phases, plans) |
| Хуки | .claude/settings.json | 5 хуков: SessionStart, SessionEnd, PostToolUse, TaskCompleted, PreCompact |
| Permissions | .claude/settings.json | Разрешения: файлы, тесты, git, агенты, MCP |
| MCP-сервер | .mcp.json | Программный доступ к vault (23 tools) |
| Slash-команды | .claude/commands/ | 4 группы: vault/ (8), session/ (3), git/ (4), workflow/ (1) |
| StatusLine | .claude/settings.json | Статус проекта в нижней строке Claude Code |
| .gitignore | .gitignore | Записи по стеку (node_modules, target/, __pycache__ и т.д.) |
Permissions
init добавляет permissions в .claude/settings.json:
| Allow | Deny |
|---|---|
| Read, Edit, Write | .env файлы |
| npm/pnpm test, run, build | git push |
| node, npx | git reset --hard |
| git status, diff, log, add, commit | rm -rf |
| Agent spawning, MCP tools |
MCP-сервер
MCP конфигурация в .mcp.json (Claude Code автоматически обнаруживает):
{
"mcpServers": {
"dev-workflow": {
"command": "node",
"args": ["/path/to/dist/cli/index.js", "serve"]
}
}
}Путь вычисляется автоматически при init — абсолютный, работает для npm link, глобальной установки и локальной зависимости.
Engram (если используется)
Сокет ищется в порядке: ENGRAM_SOCKET_PATH env var → ./.engram/engram.sock (per-project) → ~/.engram/engram.sock (legacy fallback). Для миграции legacy memories запустите engram migrate из корня проекта.
Проверка
dev-workflow doctorПокажет состояние каждого компонента: vault, агенты, задачи, workflows, MCP config.
dev-workflow doctor --fixАвтоматическое исправление: перезапускает init --force.
Следующий шаг
- Новый проект со спекой:
/vault:from-spec - Существующий проект:
/vault:analyze