Standardize on the .agents/ directory across all phased-execution
skills (phase state, reports, sessions, validate.sh, PLAN.md, and
per-story/feature/workflow trees). Legacy dot-less agent/ fallbacks
in migration scripts are untouched.
- A phase is now a directory: 00_phase.md (overview + task index) plus
small, quick NN_task.md task files; complete/ mirrors todo/
- Task is the unit of execution: run-task.sh (one unit), run-phase.sh
(phase to completion incl. 00_phase.md final pass), auto-phase.sh
(all units in order); validate.sh gate runs after every task
- PHASE_COMMIT commits at phase boundaries (00_phase.md / legacy file moves)
- Legacy flat todo/NN_name.md files still execute as a single unit;
new migrate-phases-to-tasks.sh converts them to the directory layout
- phase-status.sh reports per-task state and the next unit
- New task-template.md; phase templates now carry a Tasks index
- retries now resume the failed executor's session (pre/post session
tracking replaces the broken mtime-vs-ref check)
- report recovery from the session file when the JSON stream loses its
tail (child signaled mid-flush)
- progress.mjs: thinking indicators (◐ thinking… / ◑ thought for Ns),
compaction (⧉ …) and provider auto-retry lines; trims trailing
whitespace so no blank lines after LLM text; exits 1 on truncated
stream, model error, or missing final text (pi --mode json always
exits 0 even on errors)
- explicit ✗ ERROR lines + exit codes: 0 ok, 1 phase failed, 130/143
interrupted (INT/TERM traps; post-pipeline check covers the case
where bash suppresses the INT trap after a job dies from SIGINT)
- PIPESTATUS captured in a single statement (any following command
resets it)
- skills dir: .gitignore README.md so pi's skill scanner (which honors
.gitignore) stops warning 'description is required'
ducoterra