ai-workflow-skill/docs/roadmaps/archive/add-execution-roadmap-workflow.md

Add Execution Roadmap Workflow

Status

• completed

Owner

• codex

Started At

• 2026-03-19

Goal

• introduce a repository-level execution-roadmap workflow so substantial agent work leaves a durable trace while active and a completion record after archiving

Scope

• update AGENTS.md with active/archive roadmap rules
• create docs/roadmaps/README.md
• create docs/roadmaps/TEMPLATE.md
• create tracked active/ and archive/ directories
• update docs/implementation-roadmap.md

Checklist

• define the execution-roadmap workflow and naming rules
• update AGENTS.md to require active roadmap files for substantial multi-step work
• add docs/roadmaps/README.md
• add docs/roadmaps/TEMPLATE.md
• create tracked docs/roadmaps/active/ and docs/roadmaps/archive/
• update docs/implementation-roadmap.md

Files

• AGENTS.md
• docs/roadmaps/README.md
• docs/roadmaps/TEMPLATE.md
• docs/roadmaps/active/.gitkeep
• docs/roadmaps/archive/.gitkeep
• docs/implementation-roadmap.md

Decisions

• use docs/roadmaps/active/ and docs/roadmaps/archive/ rather than a single mixed directory
• keep project-level roadmaps separate from per-workstream execution traces
• require one roadmap file per substantial workstream rather than one file per tiny action

Blockers

• none

Next Step

• use docs/roadmaps/TEMPLATE.md as the starting point for the next substantial multi-step task

Completion Summary

• the repository now has a documented execution-roadmap workflow, tracked directories for active and archived workstreams, and a reusable template for future agents