new-track

plugin: conductor updated: 2026-01-20

<conductor_required>
  FIRST check if conductor/ directory exists with required files.
  If not, HALT and guide user to run conductor:setup first.
</conductor_required>

<context_awareness>
  ALWAYS read these files before planning:
  - conductor/product.md (understand project goals)
  - conductor/tech-stack.md (know technical constraints)
  - conductor/workflow.md (follow team processes)
</context_awareness>

<track_id_format>
  Format: {shortname}_{YYYYMMDD}
  Examples:
  - feature_auth_20260105
  - bugfix_login_20260105
  - refactor_api_20260105
</track_id_format>

</critical_constraints>

<core_principles> Always create spec.md BEFORE plan.md. Spec defines WHAT, Plan defines HOW.

<principle name="Hierarchical Plans" priority="critical">
  Plans must have:
  - 2-6 Phases (major milestones)
  - 2-5 Tasks per phase
  - 0-3 Subtasks per task (optional)
</principle>

<principle name="Actionable Tasks" priority="high">
  Each task must be:
  - Specific (clear outcome)
  - Estimable (roughly 1-4 hours)
  - Independent (minimal dependencies)
</principle>

</core_principles>

<phase number="2" name="Context Loading">
  <step>Read conductor/product.md</step>
  <step>Read conductor/tech-stack.md</step>
  <step>Read conductor/tracks.md for existing tracks</step>
</phase>

<phase number="3" name="Track Type">
  <step>Ask: What type of work? [Feature, Bugfix, Refactor, Task, Other]</step>
  <step>Ask: Short name for this track? (3-10 chars, lowercase)</step>
  <step>Generate track ID: {type}_{shortname}_{YYYYMMDD}</step>
</phase>

<phase number="4" name="Spec Generation">
  <step>Ask: What is the goal of this work? (1-2 sentences)</step>
  <step>Ask: What are the acceptance criteria? (list 3-5)</step>
  <step>Ask: Any technical constraints or dependencies?</step>
  <step>Ask: Any edge cases or error scenarios to handle?</step>
  <step>Generate conductor/tracks/{track_id}/spec.md</step>
</phase>

<phase number="5" name="Plan Generation">
  <step>Based on spec, propose 2-6 phases</step>
  <step>Ask user to confirm or modify phases</step>
  <step>For each phase, generate 2-5 tasks</step>
  <step>Add subtasks where complexity warrants</step>
  <step>Generate conductor/tracks/{track_id}/plan.md</step>
</phase>

<phase number="6" name="Finalization">
  <step>Create conductor/tracks/{track_id}/metadata.json</step>
  <step>Update conductor/tracks.md with new track</step>
  <step>Present summary to user</step>
</phase>