Conductor New Track
Overview
This skill facilitates the "Plan before you build" philosophy. It ensures that every task starts with clear requirements (spec.md) and a structured, actionable execution path (plan.md) that respects the project's established workflow. The entire track creation process runs within Plan Mode, providing a controlled environment for file creation and modification.
When to Use
- When a user says "Start a new feature," "Fix a bug," or "I have a new task."
- Before any implementation code is written.
Workflow
- Setup Check: Verify Conductor is set up and load project context (Product Definition, Tech Stack, Workflow).
- Enter Plan Mode: Call
enter_plan_modetool before proceeding. Get track description if not provided via args. - Interactive Spec: Ask targeted questions to define success. Batch up to 4 related questions in a single
ask_usertool call. Questions are classified as Additive (brainstorming/scope,multiSelect: true) or Exclusive Choice (foundational decisions,multiSelect: false). Draftspec.mdand get user approval via embedded content review. - Plan Generation: Create a phased to-do list based on the spec and the project's
workflow.md. Inject Phase Completion Tasks if defined in the workflow. Draftplan.mdand get user approval via embedded content review. - Artifact Scaffolding: Create the track directory and initialize index, metadata, spec, and plan files. Ensure unique short names by checking existing tracks.
- Exit Plan Mode: Call
exit_plan_modetool with the path to the track'sindex.md. - Registry Registration: Append the new track to the project's
tracks.mdin the format- [] **Track: <Description>**and commit the changes.
Implementation Details
Refer to the following protocols for detailed procedural instructions:
- Resolution Protocol: references/resolution-protocol.md - How to find and verify Conductor artifacts.
- Track Planning Protocol: references/track-planning.md - The interactive process for generating specs and plans, including Plan Mode handling.
Mandatory Constraints
- Plan Mode Execution: The entire newTrack process MUST run within Plan Mode. Enter via
enter_plan_modeat the start and exit viaexit_plan_modeafter artifacts are created. Onlywrite_file,replace, and authorizedrun_shell_commandare permitted. All file paths MUST useconductor/relative paths. Redirection (>or>>) is strictly prohibited inrun_shell_commandduring Plan Mode. - Question Classification: Every question MUST be classified as either Additive (
multiSelect: true, for brainstorming and scope definition) or Exclusive Choice (multiSelect: false, for foundational singular decisions). Each question MUST include: header (max 16 chars), type, multiSelect (for choice type), options with label and description, and placeholder (for text type). - Batch Questioning: Streamline the process by batching up to 4 related questions in a single
ask_usertool call. - Workflow Alignment: Plans MUST include TDD tasks (Write Tests -> Implement) and Phase Completion meta-tasks if required by the project workflow.
- Unique IDs: Verify that the track's short name is unique before generating the full ID.
- Git Hygiene: Every new track creation MUST conclude with a commit of the
tracks.mdfile.