Lap Tran
4a2301b077
- 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.2 KiB
DOC_REVIEW: add-loop-templates-onboarding
Reviewed Documentation
README.md-- new "Loop Engineering" onboarding section (Quick Start, Tick Cycle, Configuration, Monitoring, Halt/Resume)CHANGELOG.md-- task 6 entry under[unreleased]design/loops/technical.mdsection 8 -- prompt resolution and token substitution documentationAGENTS.md-- no changes needed (already documents loop runner and status.py commands)
Findings
1. README.md onboarding section
The new section adds:
- Quick Start with 3 commands (create, install-schedule, monitor)
- Tick Cycle diagram (11-step flow summary)
- Configuration table with all
loop.jsonfields - Monitoring commands
- Halt/Resume commands
Accuracy: All commands and field names match the actual implementation. The configuration table correctly documents use_worktree (not worktree), work_source.kind values (single, audit, backlog), and the role prompt fields.
Completeness: Covers all R7 sub-requirements from the SPEC.
Verdict: PASS
2. CHANGELOG.md
Entry accurately describes all changes: _resolve_prompt, _invoke_harness extension, new prompt files, template updates, new self-improvement template, README section, technical.md section 8, new tests (18), test infrastructure updates.
Verdict: PASS
3. design/loops/technical.md section 8
New "Prompt Resolution and Token Substitution" subsection documents:
- File search order (loop-local then framework)
- Content-level token substitution
{artifact_content}special handling- Temp file write and return path
- Loop-local override capability
Accuracy: Matches the implementation in _resolve_prompt.
Verdict: PASS
4. Cross-reference check
AGENTS.md"Loop runner" bullet referencesdesign/loops/technical.md§7 for the tick flow -- still accurate.config.mdmentions role-to-prompt binding inloop.json-- still accurate.prompts/directory now has 3 new files (loop-implement.md,loop-verifier.md,loop-orchestrate.md) -- not listed in any index (there is no prompts/ index file), so no update needed.
Summary
All documentation is accurate, complete, and consistent with the implementation. No doc gaps found.
Verdict: APPROVED