manual_slop/.claude/commands/conductor-new-track.md

description

description
Initialize a new conductor track with spec, plan, and metadata

/conductor-new-track

Create a new track in the conductor system. This is a Tier 1 (Orchestrator) operation.

Prerequisites

• Read conductor/product.md and conductor/product-guidelines.md for product alignment
• Read conductor/tech-stack.md for technology constraints

Steps

1. Gather Information

Ask the user for:

• Track name: descriptive, snake_case (e.g., add_auth_system)
• Track type: feat, fix, refactor, chore
• Description: one-line summary
• Requirements: functional requirements for the spec

2. Create Track Directory

conductor/tracks/{track_name}_{YYYYMMDD}/

Use today's date in YYYYMMDD format.

3. Create metadata.json

{
  "track_id": "{track_name}_{YYYYMMDD}",
  "type": "{feat|fix|refactor|chore}",
  "status": "new",
  "created_at": "{ISO8601}",
  "updated_at": "{ISO8601}",
  "description": "{description}"
}

4. Create index.md

# Track: {Track Title}

- [Specification](spec.md)
- [Implementation Plan](plan.md)

5. Create spec.md

# {Track Title} — Specification

## Overview
{Description of what this track delivers}

## Functional Requirements
1. {Requirement from user input}
2. ...

## Non-Functional Requirements
- Performance: {if applicable}
- Testing: >80% coverage for new code

## Acceptance Criteria
- [ ] {Criterion 1}
- [ ] {Criterion 2}

## Out of Scope
- {Explicitly excluded items}

## Context
- Tech stack: see `conductor/tech-stack.md`
- Product guidelines: see `conductor/product-guidelines.md`

6. Create plan.md

# {Track Title} — Implementation Plan

## Phase 1: {Phase Name}
- [ ] Task: {Description}
- [ ] Task: {Description}

## Phase 2: {Phase Name}
- [ ] Task: {Description}

Break requirements into phases with 2-5 tasks each. Each task should be a single atomic unit of work suitable for a Tier 3 Worker.

7. Update Track Registry

If conductor/tracks.md exists, add the new track entry.

8. Commit

conductor(track): Initialize track '{track_name}'

Important

• Do NOT start implementing — track initialization only
• Implementation is done via /conductor-implement
• Each task should be scoped for a single Tier 3 Worker delegation