Nguyensitrung Conductor Beads Conductor

Conductor: Context-Driven Development

Measure twice, code once.

Overview

Conductor enables context-driven development by:

1. Establishing project context (product vision, tech stack, workflow)
2. Organizing work into "tracks" (features, bugs, improvements)
3. Creating specs and phased implementation plans
4. Executing with TDD practices and progress tracking
5. Parallel execution of independent tasks using sub-agents

For parallel execution details (annotations, state schema, when to use), see references/workflows.md.

Context Loading

When this skill activates, load these files to understand the project:

1. conductor/product.md - Product vision and goals
2. conductor/tech-stack.md - Technology constraints
3. conductor/workflow.md - Development methodology (TDD, commits)
4. conductor/tracks.md - Current work status
5. conductor/patterns.md - Codebase patterns (read before starting work)

Important: Conductor commits locally but never pushes. Users decide when to push to remote.

For active tracks, also load:

• conductor/tracks/<track_id>/spec.md
• conductor/tracks/<track_id>/plan.md
• conductor/tracks/<track_id>/learnings.md - Patterns/gotchas from this track

Learnings System (Ralph-style)

Conductor captures and consolidates learnings across tracks. For full details, see references/learnings-system.md.

Key Files

• conductor/patterns.md - Project-level consolidated patterns
• conductor/tracks/<id>/learnings.md - Per-track discoveries

Templates

• references/patterns-template.md - Full patterns.md template
• references/learnings-template.md - Full learnings.md template

Knowledge Flywheel

1. Capture - After each task, append to track's learnings.md
2. Elevate - At phase/track completion, promote reusable patterns to patterns.md
3. Archive - Extract remaining patterns before archiving
4. Inherit - New tracks read patterns.md to prime context

Beads Integration

Beads integration is always attempted for persistent task memory. If bd CLI is unavailable or fails, the user can choose to continue without it. All conductor commands work normally without Beads.

For full Beads details (availability check, CLI commands, session protocol, chemistry patterns), see references/beads-integration.md.

For Beads overview within workflow context (sync behavior, configuration, graceful degradation), see references/workflows.md.

Quick Detection (MUST check before using bd commands)

if which bd > /dev/null 2>&1 && [ -f conductor/beads.json ]; then
  BEADS_ENABLED=$(cat conductor/beads.json | grep -o '"enabled"[[:space:]]*:[[:space:]]*true' || echo "")
  if [ -n "$BEADS_ENABLED" ]; then
    # Beads is available and enabled - use bd commands (requires Dolt server: bd dolt start)
  fi
fi

Proactive Behaviors

1. On new session: Check for in-progress tracks, offer to resume
2. On task completion: Suggest next task or phase verification
3. On blocked detection: Alert user and suggest alternatives
4. On all tasks complete: Congratulate and offer archive/cleanup
5. On stale context detected: If setup >2 days old or significant codebase changes detected, suggest /conductor-refresh
6. On Beads available: If bd CLI detected during setup, offer integration
7. On implement start: Read patterns.md and announce pattern count
8. On task complete: Prompt for learnings capture
9. On phase complete: Offer pattern elevation to patterns.md
10. On archive: Extract remaining patterns before archiving
11. On refresh: Consolidate learnings across all tracks

Intent Mapping

Command Execution

When a user invokes any /conductor-* command, read the corresponding command reference for the full step-by-step protocol:

Important: Always read the full command reference before executing. Each file contains the complete protocol with error handling, Beads integration, and user interaction flows.

References

• Workflow overview: references/workflows.md - Commands table, Beads overview, state files, status markers, parallel execution
• Command protocols: references/commands/ - Full step-by-step execution details for all 16 commands
• Directory structure: references/structure.md - File layout and status markers
• Beads integration: references/beads-integration.md - Session protocol, CLI commands, chemistry patterns
• Learnings system: references/learnings-system.md - Ralph-style knowledge capture details
• Patterns template: references/patterns-template.md - Template for conductor/patterns.md
• Learnings template: references/learnings-template.md - Template for track learnings.md

Source: NguyenSiTrung/Conductor-Beads — distributed by TomeVault.