Архитектура

ArchiDev превращает PDLC в исполняемый граф: закрепляет за Task стадии, роли, артефакты, гейты, модели и инструменты. Он синхронизирует Git и tracker, распределяет работу между инстансами, валидирует каждую границу артефакта и связывает все вызовы в один OTel audit trail.

Встроенный локальный индексатор объединяет AST, embeddings и Leiden-кластеры в branch-aware граф знаний. AgentProvider, LlmProvider, Jira, GitLab, Jenkins, Confluence, Figma, TestOps, MCP и project-local tools подключаются через capability-контракты и DI.

Почему ArchiDev

• Процесс исполняется, а не остаётся схемой. Task получает неизменяемый snapshot стадий, ролей, артефактов, инструментов и критериев готовности.
• AI работает внутри инженерных границ. Права, budget, tool grants, HITL и независимое review проверяются harness до мутации, а не описываются надеждой в prompt.
• Команда не привязана к одной модели. Codex, Qwen Code и другие Agent/Llm providers выбираются по capability; локальные модели берут embeddings, фильтрацию и дешёвые операции.
• Контекст следует за веткой. Граф знаний соединяет код, спецификации и зависимости, сохраняя отдельное состояние каждой Task и мультирепозиторного workspace.
• Корпоративный стек собирается как конструктор. Jira можно сочетать с GitLab и Jenkins, дополняя процесс MCP и типизированными project-local tools без форка ArchiDev.
• Новичок начинает с интерфейса, не с TOML. Первый запуск ведёт через readiness, выбор или настройку PDLC и точный preview до единственной записи.
• Одна модель работы — три полноценных интерфейса. CLI/TUI, локальный Web workspace и native VS Code extension используют одинаковые revisions, receipts, permissions и read models из core.

Быстрый старт

npm install -g archidev-pdlc
cd my-project
archidev

В ненастроенном репозитории archidev сам откроет мастер: покажет preview, предложит готовый PDLC или конструктор, подключит tracker/интеграции и создаст подписанный bootstrap commit. Запуск без записи изменений — archidev --help.

Текущий release gate поддерживает macOS и Linux с glibc >= 2.38 (например, Ubuntu 24.04+); требуется Node.js 22+. Windows пока исключён из release gate, полный onboarding отложен до закрытия WIN-3.

Открыть Web workspace

Из уже настроенного репозитория выполните:

cd my-project
archidev web

ArchiDev запустит локальный daemon, откроет браузер и покажет одноразовый код. Введите код на открывшейся странице — путь проекта и daemon token в браузер не передаются. На машине без автоматического открытия используйте archidev web --no-open; остановка фонового процесса — archidev daemon stop.

Установить VS Code extension

Сначала установите CLI, затем extension из Marketplace:

npm install -g archidev-pdlc
code --install-extension archidev-pdlc.archidev-vscode
code my-project

Доверьте workspace, откройте значок ArchiDev в Activity Bar и выберите Open project workspace. Экран Start here показывает Plans, активные Tasks, блокировки и следующее действие; Ask ArchiDev открывает диалог в Secondary Sidebar с контекстом выбранной Task и стадии. Те же действия доступны через Command Palette (ArchiDev:). Для локальной проверки исходников: pnpm --filter archidev-vscode package, затем code --install-extension ./vscode_extention/archidev-pdlc.vsix --force.

Web workspace · VS Code extension · Контракт интерфейсов

Сценарии в реальном CLI

Анимации показывают реальные CLI-прогоны. В flow-*.gif личность пользователя обезличена при рендере исходных терминальных записей; действия и результаты проверок сохранены.

1. Начать работу в существующем или новом репозитории

CLI сам распознаёт состояние Git-проекта, не печатает JSON-логи в экран и не требует знать команды. Пользователь проходит readiness и подтверждает ровно то, что будет создано.

2. Выбрать и настроить PDLC до начала Task

Конструктор показывает допустимые роли, execution mode, HITL, skills, входные/промежуточные/выходные артефакты и validators. Процесс компилируется до работы, а выбранный snapshot закрепляется за Task.

3. Видеть ход агента и вмешаться в любой момент

Экран показывает текущую фазу, шаг, события tools, расход и возраст последней активности. Из того же экрана можно остановить run, добавить guidance или повторить bounded attempt без потери audit trail.

4. Управлять планами, задачами и входящими в одном экране

Архитектор, РП, аналитик и разработчик видят одинаковое состояние Plan/Task, но разные разрешённые действия. Inbox показывает, что взять в работу, какой gate блокирует переход и куда провалиться за evidence.

Дальше

Первый запуск · Настройка PDLC · Агенты и модели · Граф знаний · Развёртывание · Вся документация