# Nguyensitrung Conductor Beads Conductor > Conductor: Context-Driven Development - Skill: `tomevault-io/nguyensitrung-conductor-beads-conductor` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/nguyensitrung-conductor-beads-conductor` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/nguyensitrung-conductor-beads-conductor/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/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](references/workflows.md#parallel-execution). ## 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//spec.md` - `conductor/tracks//plan.md` - `conductor/tracks//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](references/learnings-system.md). ### Key Files - `conductor/patterns.md` - Project-level consolidated patterns - `conductor/tracks//learnings.md` - Per-track discoveries ### Templates - [references/patterns-template.md](references/patterns-template.md) - Full patterns.md template - [references/learnings-template.md](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](references/beads-integration.md). For Beads overview within workflow context (sync behavior, configuration, graceful degradation), see [references/workflows.md](references/workflows.md#beads-integration). ### Quick Detection (MUST check before using bd commands) ```bash 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 | User Intent | Command | |-------------|---------| | "Set up this project" | `/conductor-setup` | | "Create a new feature" | `/conductor-newtrack [desc]` | | "Start working" / "Implement" | `/conductor-implement [id]` | | "What's the status?" | `/conductor-status` | | "Undo that" / "Revert" | `/conductor-revert` | | "Check for issues" | `/conductor-validate` | | "This is blocked" | `/conductor-block` | | "Skip this task" | `/conductor-skip` | | "This needs revision" / "Spec is wrong" | `/conductor-revise` | | "Save context" / "Handoff" / "Transfer to next section" | `/conductor-handoff` | | "Archive completed" | `/conductor-archive` | | "Export summary" | `/conductor-export` | | "Docs are outdated" / "Sync with codebase" | `/conductor-refresh` | | "List templates" / "Show formulas" | `/conductor-formula` | | "Quick exploration" / "Ephemeral track" | `/conductor-wisp [formula]` | | "Extract template" / "Create reusable pattern" | `/conductor-distill [track_id]` | ## Command Execution When a user invokes any `/conductor-*` command, **read the corresponding command reference** for the full step-by-step protocol: | Command | Full Protocol | |---------|---------------| | `/conductor-setup` | [references/commands/setup.md](references/commands/setup.md) | | `/conductor-newtrack` | [references/commands/newtrack.md](references/commands/newtrack.md) | | `/conductor-implement` | [references/commands/implement.md](references/commands/implement.md) | | `/conductor-status` | [references/commands/status.md](references/commands/status.md) | | `/conductor-revert` | [references/commands/revert.md](references/commands/revert.md) | | `/conductor-validate` | [references/commands/validate.md](references/commands/validate.md) | | `/conductor-block` | [references/commands/block.md](references/commands/block.md) | | `/conductor-skip` | [references/commands/skip.md](references/commands/skip.md) | | `/conductor-revise` | [references/commands/revise.md](references/commands/revise.md) | | `/conductor-archive` | [references/commands/archive.md](references/commands/archive.md) | | `/conductor-export` | [references/commands/export.md](references/commands/export.md) | | `/conductor-handoff` | [references/commands/handoff.md](references/commands/handoff.md) | | `/conductor-refresh` | [references/commands/refresh.md](references/commands/refresh.md) | | `/conductor-formula` | [references/commands/formula.md](references/commands/formula.md) | | `/conductor-wisp` | [references/commands/wisp.md](references/commands/wisp.md) | | `/conductor-distill` | [references/commands/distill.md](references/commands/distill.md) | **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](references/workflows.md) - Commands table, Beads overview, state files, status markers, parallel execution - **Command protocols**: [references/commands/](references/commands/) - Full step-by-step execution details for all 16 commands - **Directory structure**: [references/structure.md](references/structure.md) - File layout and status markers - **Beads integration**: [references/beads-integration.md](references/beads-integration.md) - Session protocol, CLI commands, chemistry patterns - **Learnings system**: [references/learnings-system.md](references/learnings-system.md) - Ralph-style knowledge capture details - **Patterns template**: [references/patterns-template.md](references/patterns-template.md) - Template for conductor/patterns.md - **Learnings template**: [references/learnings-template.md](references/learnings-template.md) - Template for track learnings.md --- > Source: [NguyenSiTrung/Conductor-Beads](https://github.com/NguyenSiTrung/Conductor-Beads) — distributed by [TomeVault](https://tomevault.io).