Новый проект
AlanHuang168/AI-Project-Workflow
CLI и набор правил для поэтапной AI-разработки: от требований и архитектуры до реализации, проверки, публикации и ретроспективы.
- Stars
- ★ 27 ↗ +2 за 7 дней
- Forks
- ⑂ 4
- Язык
- JavaScript
- Статус
- В канале 1 янв. 1 г.
AI-разбор
AI Project Workflow задаёт формализованный процесс поставки программного обеспечения с помощью Cursor, Claude Code, Codex и других AI-инструментов. В основе находится каталог core/ как единый источник правил, навыков, ролей, шаблонов и схем, а для каждой платформы генерируется отдельный адаптационный слой. CLI устанавливает workflow в проект, отслеживает этапы через .ai-workflow/state.json, проверяет структуру и конфигурацию, синхронизирует адаптеры и поддерживает миграцию старого расположения файлов. Встроенный процесс включает восемь этапов: инициализацию, требования, архитектуру, детальное проектирование, реализацию, проверку, публикацию и ретроспективу; результаты должны сохраняться в docs/. Поддерживаются пользовательские последовательности этапов через project.yaml, несколько AI-инструментов в одном проекте и защитные режимы без перезаписи существующих файлов. Проверка подтверждена для Cursor, Claude Code, Codex CLI, TRAE, CodeBuddy и CatPaw, тогда как Qoder в README отмечен как ещё не проверенный. Ограничение проекта состоит в том, что соблюдение процесса зависит от контекста и правил конкретного AI-инструмента, поэтому иногда требуется ручное вмешательство.
Разработчики, технические лидеры и небольшие команды, использующие AI-кодировщики и которым нужны воспроизводимый процесс, документирование решений, контроль этапов и проверяемые результаты.
Что внутри
- Единый каталог core/ с правилами, навыками, ролями, шаблонами и JSON-схемами состояния
- CLI-команды init, install, sync, validate, status и migrate для установки и сопровождения workflow
- Восемь этапов разработки с условиями входа, результатами, критериями завершения и правилами отката
- Отслеживание текущего, завершённых и пропущенных этапов в .ai-workflow/state.json
- Адаптеры для Cursor, Claude Code, Codex, TRAE, CodeBuddy, CatPaw и других поддерживаемых платформ
- Проверка конфигурации, документов, frontmatter, состояния и синхронности сгенерированных файлов
Где применять
- Организация разработки веб-приложения небольшой командой с последовательным согласованием требований, архитектуры и реализации
- Настройка общего процесса работы нескольких AI-кодировщиков в одном репозитории
- Контроль полноты проектной документации и фактически выполненных проверок перед публикацией
- Миграция существующего проекта со старой структуры core/ или VERSION в скрытый каталог .ai-workflow
- Создание нестандартного процесса разработки с пользовательскими этапами и собственными навыками
Темы