Arhellist

Witness Done — фабрика спецификаций для AI-агентов

Witness Done превращает техническое задание в исполнимую спецификацию: контракты, задания на разработку, критерии приёмки и машиночитаемые акты. Для Cursor, Claude Code, Codex, Gemini и других AI-агентов.

Witness Done (v1.29.0) — портативная каноническая фабрика инициализации программных проектов для AI-агентов: Cursor IDE, Claude Code, Codex, Gemini, Copilot, Cline, Devin/Windsurf и других. Фабрика превращает техническое задание в исполнимую спецификацию — набор контрактов, заданий на разработку, критериев приёмки и машиночитаемых актов. Это ответ на ambiguity, context rot, scope drift и fake done: артефакты вместо памяти чата и акт приёмки вместо обещания «готово».

Режимы greenfield и brownfield

В режиме greenfield вход — INPUT/TECH_SPEC.md; оркестратор ведёт волны A → B → C (включая C1–C4 и self-audit 10b) до OUTPUT/, затем автоматически переводит проект в brownfield через R01 baseline. В режиме brownfield сначала R00 reverse-engineer и R01 baseline в spec-state/, далее итерационный цикл R02 propose → R03 apply → R04 verify → R05 archive. Единственная точка входа агента — ORCHESTRATOR.md; любой запрос начинается с sp status → sp intake → sp next.

VerificationTax и доказательство готовности

Witness Done вводит VerificationTax: контекстная приёмка module/app/eco, acceptance_ids, review для L2/L3, plan-to-proof и runtime trace при необходимости. Статус done допустим только после sp-verify --gate pre_ci и связанных гейтов. Правила агента живут в корневом AGENTS.md; адаптеры IDE синхронизирует sp rules --sync. Политики стека, языка, полноты, CI/CD и комментариев описаны в catalogs/.

Для кого страница и где код

Лендинг на Arhellist описывает продукт для разработчиков, тимлидов и команд, которые строят ПО с AI-агентами и хотят воспроизводимую спецификацию. Исходники, VERSION, README, ORCHESTRATOR.md, PROFILES.md и шаблоны — в открытом репозитории https://github.com/arhellist/WitnessDone. Автор — Алексей Пасечник (Arhellist). Связь: Telegram https://t.me/arhellist_dev или форма на главной https://arhellist.ru. Внутренние разделы сайта: проекты (/#projects), блог (/blog/), контакты (/#contact). Страница отдаёт полный HTML с заголовками и текстом для поисковых систем без обязательного JavaScript.

Частые вопросы

Что такое Witness Done?

Witness Done — портативная каноническая фабрика инициализации программных проектов для AI-агентов. Она превращает техническое задание в исполнимую спецификацию: контракты, задания на разработку (D-промпты), критерии приёмки и машиночитаемые акты.

Чем Witness Done отличается от «просто хорошего промпта»?

Это не просьба к модели быть аккуратной, а детерминированный конвейер. Шаг нельзя закрыть без файла, задачу нельзя назвать готовой без доказательства (VerificationTax и sp-verify).

Какие режимы работы поддерживаются?

Greenfield — проектирование новой системы с нуля по INPUT/TECH_SPEC.md волнами A→B→C. Brownfield — эволюция существующего кода через spec-state/: reverse → baseline → propose → apply → verify → archive.

С какими IDE и агентами совместим Witness Done?

Канон один: Cursor IDE, Claude Code, Codex, Gemini, Copilot, Cline, Devin/Windsurf и др. Правила живут в AGENTS.md; адаптеры IDE генерирует команда sp rules --sync.

Где взять Witness Done и актуальную версию?

Открытый репозиторий: https://github.com/arhellist/WitnessDone. Версия фабрики указана в файле VERSION (сейчас 1.29.0). Точка входа агента — ORCHESTRATOR.md.

v1.29.0

Witness Done

Фабрика спецификаций, которая не даёт AI-агенту «додумать» продукт

Не «сделано» на словах, а свидетельство сделанного: контракты, задания на разработку, критерии приёмки и машиночитаемые акты — вместо памяти чата и обещания «готово».

Открыть на GitHubК проектам Arhellist
Witness Done — фабрика спецификаций для AI-агентов

Зачем это нужно

Агент пишет код быстро, но теряет середину длинного ТЗ, сам придумывает контракты и объявляет задачу готовой, когда тесты зелёные, а продукт ещё не работает. Witness Done лечит две болезни: потерю смысла на дистанции и приёмку на слово.

Ambiguity

В ТЗ «сделай кабинет» — агент сам выбирает 40 решений. Фабрика фиксирует договорённости до кода.

Fake done

«Готово» без доказательства. VerificationTax требует акт приёмки, а не отчёт в чате.

Context rot

На пятом шаге забыты инварианты с первого. Артефакты в файлах заменяют память диалога.

Два режима работы

Точка входа для агента — ORCHESTRATOR.md. Любой запрос начинается с status → intake → next.

MODE · greenfield

Новая система с нуля

INPUT/TECH_SPEC.md → волны A → B → C → сборка OUTPUT/ → автопереход в brownfield через baseline спецификаций.

MODE · brownfield

Эволюция живого кода

Реверс и baseline, затем цикл propose → apply → verify → archive в каталоге spec-state/.

Как устроен конвейер

Не «просьба к модели быть аккуратной», а детерминированный пайплайн: шаг нельзя закрыть без файла, задачу нельзя назвать готовой без доказательства.

  1. 01
    Сначала договоритьсяКонтракты, решения и границы scope фиксируются до написания кода.
  2. 02
    D-промпты порциямиТолстые задания режутся; у каждого — HOW, инварианты и acceptance.
  3. 03
    VerificationTaxПриёмка module/app/eco, review и proof debt — done только после sp-verify.
  4. 04
    ПортативностьCursor, Claude Code, Codex, Gemini, Copilot, Cline, Devin — один канон, адаптеры IDE через sp rules --sync.

Частые вопросы

Коротко о том, что это, зачем и где взять актуальный канон.

Что такое Witness Done?

Witness Done — портативная каноническая фабрика инициализации программных проектов для AI-агентов. Она превращает техническое задание в исполнимую спецификацию: контракты, задания на разработку (D-промпты), критерии приёмки и машиночитаемые акты.

Чем Witness Done отличается от «просто хорошего промпта»?

Это не просьба к модели быть аккуратной, а детерминированный конвейер. Шаг нельзя закрыть без файла, задачу нельзя назвать готовой без доказательства (VerificationTax и sp-verify).

Какие режимы работы поддерживаются?

Greenfield — проектирование новой системы с нуля по INPUT/TECH_SPEC.md волнами A→B→C. Brownfield — эволюция существующего кода через spec-state/: reverse → baseline → propose → apply → verify → archive.

С какими IDE и агентами совместим Witness Done?

Канон один: Cursor IDE, Claude Code, Codex, Gemini, Copilot, Cline, Devin/Windsurf и др. Правила живут в AGENTS.md; адаптеры IDE генерирует команда sp rules --sync.

Где взять Witness Done и актуальную версию?

Открытый репозиторий: https://github.com/arhellist/WitnessDone. Версия фабрики указана в файле VERSION (сейчас 1.29.0). Точка входа агента — ORCHESTRATOR.md.

Открытый канон на GitHub

Полное руководство, оркестратор, каталоги политик и шаблоны — в репозитории Witness Done. Версия фабрики 1.29.0. Автор — Алексей Пасечник.

github.com/arhellist/WitnessDoneСвязаться