Conductor Assistant

This skill automates the management of the conductor/ directory, which serves as the project's source of truth for feature planning and tracking.

Capabilities

1. Scaffold New Track

Creates the directory structure and files for a new feature track and registers it in conductor/tracks.md.

Command:

node .gemini/skills/conductor-assistant/scripts/scaffold_track.js <track-id> "<Track Title>"

Example:

node .gemini/skills/conductor-assistant/scripts/scaffold_track.js user-profile "User Profile & Settings"

2. Update Plan Status

Updates the status of a task in a track's plan.md.

Command:

node .gemini/skills/conductor-assistant/scripts/update_plan.js <track-id> <step-number> <status>

• •status: done, pending, skipped

Example:

node .gemini/skills/conductor-assistant/scripts/update_plan.js user-profile 1.2 done

Workflows

Starting a New Feature

1. •Run scaffold_track.js with a kebab-case ID and a title.
2. •Read the generated conductor/tracks/<track-id>/spec.md and plan.md to fill in details (the script generates placeholders).

Working on a Feature

1. •Retrieve Context: Read conductor/tracks/<track-id>/spec.md and plan.md to understand the goal.
2. •Execute: Implement the code.
3. •Update: Run update_plan.js to mark steps as complete.

File Structure

• •conductor/tracks.md: Registry of all tracks.
• •conductor/tracks/<track-id>/:
  • •metadata.json: Status, owner, dates.
  • •spec.md: Detailed requirements.
  • •plan.md: Step-by-step implementation plan.