Больше, чем шаблон

Полноценная система для AI-разработки проектов

AI Development Harness переносит проектный контекст, правила и процесс разработки в репозиторий. ChatGPT и Codex получают понятную структуру работы — от идеи и требований до реализации, проверок, review и Git.

СтруктураКонтекст проекта в Git
ПроцессОт STEP до review
ДокументацияREQ, ADR и evidence
КонтрольПроверки вместо доверия
ai-development-harness/
main
PROJECT
.agents/skills
.codex/agents
docs/REQ · ADR
planning/STEP · review
tools/validation
AGENTS.mdprotocol
README.mdentrypoint
PROJECT FLOW
01BriefОпишите проект своими словамиready
02INIT PROJECTСоздать knowledge base и roadmaprun
03RUN STEP-001Plan → Implement → Reviewnext
STATUS PROJECT
source of truth
deterministic gates
Проблема

AI умеет писать код.
Но проекту этого мало.

Без устойчивого контекста каждая новая сессия снова выясняет архитектуру, договорённости и текущий план. Результат зависит от того, что осталось в чате — а не от состояния самого проекта.

Без Harness

Ручной процесс расползается

  • Промпты и решения живут в разных чатах
  • Требования смешиваются с планом и архитектурой
  • Review часто делает тот же контекст, что писал код
  • Мелкие задачи либо теряются, либо обрастают бюрократией
  • Новая сессия вынуждена восстанавливать историю
С Harness

Репозиторий помнит всё важное

  • REQ, ADR и STEP разделены по назначению
  • Implementation plan сохраняется рядом с задачей
  • Проверки дают evidence, а review остаётся независимым
  • QUICK FIX закрывает безопасные micro-change без лишних STEP
  • Любая новая сессия стартует с project state, а не с пересказа чата
Как это работает

От идеи до результата — по одному понятному процессу

Harness не пытается заменить разработчика. Он делает взаимодействие человека, AI и репозитория воспроизводимым.

01

Создайте проект

Используйте GitHub template и опишите цель, пользователей, ограничения и предпочтительный стек в локальном brief.

PROJECT_BRIEF.local.md
02

Инициализируйте контекст

Initializer превращает сырой brief в требования, архитектурный baseline, roadmap и связанные STEP.

INIT PROJECT
03

Запускайте STEP

Планирование, реализация, deterministic verification, независимый review и исправления идут по единому контракту.

RUN STEP-001
04

Продолжайте без потери контекста

Статус, решения и доказательства остаются в Git. Следующая сессия понимает проект без восстановления истории чата.

NEXT STEP
Небольшой пример

Вы формулируете задачу.
Harness превращает её в работу.

Не нужно вручную придумывать формат тикета, писать отдельный план реализации и объяснять следующему агенту, что произошло. Контекст сохраняется в проектных артефактах.

Важно

Production code не меняется на этапе создания STEP. Сначала Harness фиксирует контракт задачи, зависимости, acceptance criteria и verification.

Codex / ChatGPT project session
YOU ADD STEP: Добавить вход через GitHub OAuth
HARNESS

Создан STEP-012

Type FEATURE Priority HIGH Risk SECURITY
  • связаны существующие REQ
  • проверены dependencies
  • добавлены acceptance criteria
  • определены verification gates
nextPLAN STEP-012
YOU RUN STEP-012
PLANIMPLEMENTVERIFYREVIEWPASS
Почему это лучше старта с нуля

Меньше настройки.
Больше инженерной дисциплины.

Обычный новый репозиторий даёт пустое пространство. Harness сразу задаёт работающие границы: как хранить решения, как выполнять задачи, как проверять результат и как безопасно работать с Git.

Единый интерфейс команд

Стабильные команды вместо каждый раз новых промптов. Они одинаково читаются человеком и агентом.

INIT PROJECTADD STEPRUN STEPQUICK FIXSTATUS PROJECTRECONCILE

Traceability

Требование связано с работой, решение — с ограничениями, а выполненный STEP — с реальными доказательствами.

Проверяемое качество

AI-вердикт не заменяет build, tests, lint и остальные deterministic gates конкретного проекта.

Git без сюрпризов

GIT CHECK, COMMIT, PUSH и PR разделены и подчиняются repository policy.

Расширяемые skills

Ищите, инспектируйте, устанавливайте или создавайте project-specific skills без смешивания их с core protocol.

Контекст переживает чат

Главная идея Harness: репозиторий — source of truth. Новая сессия может продолжить работу, читая актуальные файлы проекта вместо пересказа предыдущего разговора.

REQADRSTEPCODEEVIDENCEREVIEW
Не только happy path

Реальная разработка состоит
не только из больших фич

Harness учитывает повседневные сценарии, на которых обычно ломаются слишком формальные процессы.

QUICK FIX

Исправили опечатку?

Без отдельного STEP, если изменение действительно локальное и low-risk.

micro-change
ADD STEP

Появилась новая задача?

Короткое описание превращается в связанный task contract с dependencies и критериями готовности.

planning
RECONCILE

Код и документация разошлись?

Harness сначала фиксирует drift и corrective work, а не переписывает проект молча.

audit
GENERATE GITHUB TEMPLATES

Стек проекта изменился?

Issue Forms и PR template можно пересобрать по актуальным технологиям и tooling.

tooling
Open Source · GitHub Template

Соберите проект вокруг процесса,
а не вокруг истории чата.

Возьмите AI Development Harness как основу нового репозитория, заполните brief и начните с INIT PROJECT.