Conductor Setup
Overview
This skill transforms a standard repository into a Conductor-managed project. It establishes the "Source of Truth" by creating structured documentation for the product vision, technical standards, and development workflows.
Workflow Overview
The setup process runs entirely within Plan Mode and follows these sequential phases:
- Pre-Initialization Overview (Section 1.1): Present a high-level overview of the setup steps to the user.
- Project Audit (Section 1.2): Check for existing Conductor artifacts and determine the resume point using a priority table.
- Project Discovery (Section 2.0): Determine if the project is New (Greenfield) or Existing (Brownfield). Resume from the audit target if applicable.
- Product Documentation (Sections 2.1-2.3): Collaborative creation of
product.md,product-guidelines.md, andtech-stack.mdwith Interactive/Autogenerate mode selection. - Configuration (Sections 2.4-2.5): Selection of code style guides and customization of
workflow.mdwith Default/Customize options. - Finalization (Section 2.6): Generate
conductor/index.mdand summarize all actions. - Track Generation (Sections 3.1-3.3): Collect product requirements (Greenfield only), propose and create the first Track with
spec.md,plan.md,metadata.json, andindex.md. - Final Announcement (Section 3.4): Commit all files and inform the user of next steps.
State Management
Setup progress is tracked via Project Audit (Section 1.2). Instead of a state file, the agent checks for existing Conductor artifacts and uses a priority table to determine the resume point:
| Artifact Exists | Target Section | Announcement |
|---|---|---|
All files in tracks/<track_id>/ (spec, plan, metadata, index) | HALT | "The project is already initialized. Use /conductor:newTrack or /conductor:implement." |
index.md (top-level) | Section 3.0 | "Resuming setup: Scaffolding is complete. Next: generate the first track." |
workflow.md | Section 2.6 | "Resuming setup: Workflow is defined. Next: generate project index." |
code_styleguides/ | Section 2.5 | "Resuming setup: Guides/Tech Stack configured. Next: define project workflow." |
tech-stack.md | Section 2.4 | "Resuming setup: Tech Stack defined. Next: select Code Styleguides." |
product-guidelines.md | Section 2.3 | "Resuming setup: Guidelines are complete. Next: define the Technology Stack." |
product.md | Section 2.2 | "Resuming setup: Product Guide is complete. Next: create Product Guidelines." |
| (None) | Section 2.0 | (None) |
After determining the target section, the agent MUST proceed to Section 2.0 to establish Greenfield/Brownfield context before jumping to the target.
Implementation Details
Refer to the following protocols for detailed procedural instructions:
1. Initialization and Resolution
- Resolution Protocol: references/resolution-protocol.md - How to find Conductor artifacts.
- Project Discovery: references/project-discovery.md - Brownfield vs Greenfield detection with improved indicators and git status checking.
2. Product Documentation
- Product and Tech Stack: references/product-setup.md - Interactive/Autogenerate mode selection, question batching, and user confirmation loops.
3. Standards and Workflow
- Configuration: references/configuration.md - Code style guide selection via shell commands, workflow customization, and index generation.
4. Planning the First Track
- Track Generation: references/track-generation.md - Product requirements collection, track proposal, artifact creation, and phase completion tasks.
Mandatory Constraints
- Plan Mode Execution: The entire setup process runs within Plan Mode. The agent MUST call
enter_plan_modeat the start. All file operations MUST use relative paths starting withconductor/(e.g.,conductor/product.md). Do NOT use absolute paths. Redirection operators (>,>>) are NOT allowed inrun_shell_commandcalls while in Plan Mode. - Self-Correction: If a tool call fails (e.g., due to a policy restriction or path error), the agent MUST attempt to intelligently self-correct by reviewing the error message. If the failure is unrecoverable after a self-correction attempt, halt immediately and await user instructions.
- Relative Paths: In Plan Mode, all file write and replace operations MUST use relative paths starting with
conductor/. Absolute paths will be blocked by Plan Mode security policies. - TDD Integration: When generating
plan.md, you MUST adhere to the TDD principles defined inworkflow.md(Red/Green/Refactor tasks). - Universal File Resolution: ALWAYS use the protocol in
references/resolution-protocol.mdto find or verify files. - Git Hygiene: Setup concludes with a commit of all
conductor/files.
Assets
Templates used during setup are located in assets/templates/:
workflow.md: The base development workflow.code_styleguides/: Language-specific style guides (Python, TypeScript, Go, etc.).
Policies for Plan Mode file access are located in assets/policies/:
conductor.toml: Defines Plan Mode permissions for writing Conductor files and running authorized shell commands.