track-management

name track-management description Use this skill when creating, managing, or working with Conductor tracks - the logical work units for features, bugs, and refactors. Applies to spec.md, plan.md, and track lifecycle operations. version 1.0.0 Track Management Guide for creating, managing, and completing Conductor tracks - the logical work units that organize features, bugs, and refactors through specification, planning, and implementation phases. When to Use This Skill Creating new feature, bug, or refactor tracks Writing or reviewing spec.md files Creating or updating plan.md files Managing track lifecycle from creation to completion Understanding track status markers and conventions Working with the tracks.md registry Interpreting or updating track metadata Detailed patterns and worked examples Detailed pattern documentation lives in references/details.md . Read that file when the navigation tier above is insufficient. Best Practices One track, one concern : Keep tracks focused on a single logical change Small phases : Break work into phases of 3-5 tasks maximum Verification after phases : Always include verification tasks Update markers immediately : Mark task status as you work Record SHAs : Always note commit SHAs for completed tasks Review specs before planning : Ensure spec is complete before creating plan Link dependencies : Explicitly note track dependencies Archive, don't delete : Preserve completed tracks for reference Size appropriately : Keep tracks between 1-5 days of work Clear acceptance criteria : Every requirement must be testable