initial commit

state/EVIDENCE_TEMPLATE.md

@@ -0,0 +1,12 @@
+# Evidence <TASK-ID>
+
+- Owner/reviewer and role:
+- Task outcome:
+- Changed files:
+- Acceptance item → observed result:
+- Commands and actual exit codes:
+- Relevant output / artifact paths:
+- Checks not executed, why, and required environment:
+- Remaining risks / limits:
+
+Не заменять фактический результат «должно работать». Не включать passwords, tokens, decrypted bodies или key fragments.

state/HANDOFF_TEMPLATE.md

@@ -0,0 +1,12 @@
+# Handoff <TASK-ID>
+
+- Owner / role:
+- State:
+- Current revision:
+- Goal / accepted contract:
+- Changed files:
+- Completed checks and evidence paths:
+- Unfinished work:
+- Exact next command/action:
+- Blocker and who/what can resolve it:
+- Known limitations (no secrets):

state/ISSUE_TEMPLATE.json

@@ -0,0 +1,14 @@
+{
+  "title": "Устранить одну конкретную причину блокера",
+  "reason": "Что невозможно выполнить и почему; без секретов",
+  "reproduction": "Команда/сценарий и наблюдаемый результат; ссылка на evidence",
+  "role": "orchestrator",
+  "reviewer_role": "qa",
+  "scope": ["docs/decisions/one-remediation.md"],
+  "outcome": "Один проверяемый результат, устраняющий именно эту причину",
+  "steps": ["Прочитать blocker report", "Воспроизвести причину", "Устранить причину в scope", "Проверить и передать в review"],
+  "acceptance": ["Причина устранена", "Нет обхода исходных требований"],
+  "checks": ["Позитивный сценарий", "Исходный сбой больше не воспроизводится"],
+  "depends_on": [],
+  "requires_user_input": false
+}

state/README.md

@@ -0,0 +1,11 @@
+# Состояние выполнения
+
+`tasks.json` — единственный mutable источник статусов, owners, revision и истории transitions. CLI пишет его через filesystem lock и atomic replace. В комплекте revision 0, все 275 задач todo; это честный исходный backlog.
+
+`evidence/` и `handoffs/` пополняются при реализации. Шаблоны рядом. Пустые папки могут отсутствовать после Git checkout; atomic writer/агент создают их по необходимости. Evidence/handoff должны быть реальными файлами до submit.
+
+`context-*.md` — disposable packet для выбранной задачи. Его можно восстановить из definitions/specs через CLI. Packet не содержит автоматически всё дерево исходников и не является источником статуса.
+
+Не включать реальные secrets, decrypted messages, file key fragments или tokens. Не синхронизировать state разных checkout простым overwriting: нужен согласованный coordinator и history-preserving merge.
+
+`issues/` — исходные bounded JSON проблемы; `blockers/` — generated reports; `runs/` — prompt/log/result отдельных fresh subprocesses. `plan-transaction.json` — временный recovery journal, не редактировать. Reporter retired и исходная задача возвращается в очередь только после reviewed done remediation.