Files
automaton/tasks/complete/add-goal-mode/DOC_REVIEW.md
T
Lap Tran 4a2301b077
CI / build (push) Has been cancelled
Archive completed tasks, add cleanup commands, self-documenting dashboard UI
- Archive 79 completed framework-dev tasks from tasks/ -> tasks/complete/
- status.py: add --cleanup-done and --install-cleanup-schedule commands
- Add scripts/automaton-cleanup.sh for periodic task archiving
- Dashboard: rename 'Background' tab -> 'Agent', 'Cleanup' agent -> 'Completed Task Archiver', remove redundant group headers and pill badges, dim inactive agent placeholders
- .rules.md: add Self-Documenting UI Names rule
- New tests: test_cleanup_done.py, expanded test_app.py and test_task.py
2026-06-24 22:43:33 -04:00

2.0 KiB

DOC_REVIEW: add-goal-mode

Reviewed doc impact for task add-goal-mode.

Doc edits in this task

1. design/loops/technical.md

Schema section (section 2) already updated with work_source and acceptance_criteria fields. Self-improvement example (section 9) already references work_source: {kind: "audit"}. No further changes needed.

2. design/loops/functional.md

Already documents work_source and acceptance_criteria in the loop.json field list (lines 96-97). No change needed.

3. templates/loops/ci-triage/loop.json

Updated with explicit "work_source": {"kind": "single"} and "acceptance_criteria": [...]. Matches SPEC R7. No further change.

4. AGENTS.md

The "State Enforcement -- Loops (v1)" section mentions --check-gate and the runner. No new CLI surface in this task (the --goal flag is deferred to v1.1 per SPEC Non-Goals). No change needed.

5. README.md

The loop engineering section already references work sources at a high level. The specific work_source.kind values (single, audit, backlog) are implementation details documented in design/loops/. No change needed for v1.

6. CHANGELOG.md

Add an [unreleased] entry for goal-mode work sources, verifier tokens, and audit --json. Action: apply.

7. prompts/

No loop prompts land in this task (deferred to task 6 per SPEC Non-Goals). No change.

8. contracts/harness-integration.md

No new harness integration surface in this task. No change.

Code-doc consistency check

  • technical.md section 2 schema: work_source.kind values match the _FIND_WORK_DISPATCH keys (single, audit, backlog). PASS
  • technical.md section 2 schema: acceptance_criteria described as "string OR list" matches _acceptance_criteria_text implementation. PASS
  • functional.md line 96-97: work_source shape matches implementation. PASS
  • ci-triage/loop.json: template fields match schema docs. PASS

Summary

Doc edits in this task:

  • CHANGELOG.md: new [unreleased] entry.

No code-doc mismatches found. READY for referee.