Files
automaton/tasks/complete/readme-upgrade-docs/IMPLEMENTATION.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

1.2 KiB

Implementation: README and Upgrade Docs

Changes Made

1. Quick Reference (README.md)

  • Added --project /path/to/project to every status.py command example
  • Added --upgrade and --can-edit commands with all 4 modes
  • Added note about --project being required with multiple projects

2. Untracked Tasks Section

  • Documents that tasks without .state files are refused by all commands
  • Shows how to upgrade single tasks or all tasks at once

3. Enforcement Section

  • Documents 3 enforcement layers: harness pre-edit hook, git pre-commit hook, prompt rules
  • References contracts/harness-integration.md for details

4. Upgrading Section (rewritten)

  • "Updating the framework" (git pull) separated from "Upgrading to v2.0" (upgrade.sh)
  • Step-by-step upgrade.sh usage with what it does
  • Manual pre-commit hook installation
  • --can-edit verification step

5. Project Setup Section

  • Option B (Manual Way) now includes pre-commit hook installation

6. Key Components

  • Added scripts/git-hooks/pre-commit
  • Added contracts/harness-integration.md
  • Added plugins/automaton-guard/
  • Updated scripts/status.py description to mention --can-edit