SKILL.md

When to Activate

  • User wants to create a structured task list or roadmap for a feature or project
  • User asks to plan out next steps in a persistent format
  • User needs a trackable task list saved to the repository

Skip When

  • Short-lived in-session task tracking — use TaskCreate instead of a persistent roadmap
  • Concrete implementation plan (file paths + TDD steps) — use codi-plan-writer
  • Design exploration before the roadmap — use codi-brainstorming first
  • Daily session log or end-of-day summary — use codi-session-log

Workflow

Step 1: Gather Requirements

[CODING AGENT] Understand the scope:

  • What feature, epic, or project is being planned?
  • What is the target completion or priority?
  • Are there dependencies or blockers to capture?

Step 2: Structure the Roadmap

[CODING AGENT] Organize tasks with:

  • Clear task descriptions
  • Priority levels (high / medium / low)
  • Status tracking (pending / in-progress / done)
  • Dependencies between tasks where relevant

Step 3: Save to File

[SYSTEM] Save the roadmap:

  • Use the template at docs/roadmap-template.json if it exists
  • Save to docs/roadmaps/ directory
  • Filename convention: YYYYMMDD_HHMM_roadmap_name.json