- 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
2.7 KiB
Doc Review: add-status-brakes
Reviewed doc impact: AGENTS.md, README.md, prompts/, config.md, CHANGELOG.md.
Doc gaps to land in THIS task
Already updated in this task
- None ( изменения are in
status.py,tests/test_status_brakes.py,templates/loops/ci-triage/loop.json). No prompt or config doc touched.
To be updated (within this task's scope or follow-on)
-
AGENTS.mdBuild & Test Commands section — should mention:python3 -m pytest tests/test_status_brakes.py -v--versionflag exists
However, AGENTS.md is a framework-wide doc; per the project convention it covers the test suite as a whole, not per-test-file. Decision: do NOT pile per-test-file entries into AGENTS.md — the existing
python3 -m pytest tests/ -valready covers it. Leave alone. -
AGENTS.mdHarness Integration section — should add the new--can-edit --loop [--loop-worktree] --file Pmode. The current AGENTS.md describes modes 1–4 for--can-edit. Adding a 5th mode belongs here.Action: extend AGENTS.md's "Modes:" block under Harness Integration to describe the loop worktree scope mode. Will apply in this task.
-
AGENTS.mdConventions / State Enforcement section — should mention.state.loopand--approve --loop. Will add a short paragraph. -
README.md— user-facing. Should mention loop commands exist (high-level). Defer detailed user docs to task 6 (templates/onboarding); only the existence of loop commands is in scope here.Action: add a brief "Loop engineering (beta)" subsection in README.md.)
-
prompts/— no loop-specific prompts land in this task. Task 6 ownsprompts/loop-{implement,verifier,orchestrate}.md. No action. -
config.md— already has## Loop Role Models(task 1) and## Framework Version. The## Framework Versionsection is what--versionparses. Confirmed it parses correctly. No action. -
CHANGELOG.md— should get an[unreleased]entry for the brakes layer. Action: add.
Doc consistency observations (non-blocking, defer)
- The harness-integration contract at
contracts/harness-integration.mdlists--can-editmodes 1–4. Should add mode 5 (--loop worktree). Defer to a follow-on doc-rev task; touching the contract file is out of scope for this code task and risks destabilizing the contract. design/loops/technical.mddescribes--install-schedulesemantics; the implementation matches. No update needed.
Summary of doc edits in this task
AGENTS.md: extend Harness Integration modes list; brief.state.loopparagraph.README.md: one "Loop engineering (beta)" subsection.CHANGELOG.md: entry under[unreleased].
No code-doc mismatches found. READY for referee.