mirror of
https://github.com/wshobson/agents.git
synced 2026-03-18 09:37:15 +00:00
fix(conductor): move plugin to plugins/ directory for proper discovery
Conductor plugin was at root level instead of plugins/ directory, causing slash commands to not be recognized by Claude Code.
This commit is contained in:
109
plugins/conductor/README.md
Normal file
109
plugins/conductor/README.md
Normal file
@@ -0,0 +1,109 @@
|
||||
# Conductor - Context-Driven Development Plugin for Claude Code
|
||||
|
||||
Conductor transforms Claude Code into a project management tool by implementing **Context-Driven Development**. It enforces a structured workflow: **Context → Spec & Plan → Implement**.
|
||||
|
||||
## Philosophy
|
||||
|
||||
By treating context as a managed artifact alongside code, teams establish a persistent, project-aware foundation for all AI interactions. The system maintains:
|
||||
|
||||
- **Product vision** as living documentation
|
||||
- **Technical decisions** as structured artifacts
|
||||
- **Work units (tracks)** with specifications and phased plans
|
||||
- **TDD workflow** with verification checkpoints
|
||||
|
||||
## Features
|
||||
|
||||
- **Specification & Planning**: Generate detailed specs and actionable task plans before implementation
|
||||
- **Context Management**: Maintain style guides, tech stack preferences, and product goals
|
||||
- **Safe Iteration**: Review plans before code generation, keeping humans in control
|
||||
- **Team Collaboration**: Project-level context documents become shared foundations
|
||||
- **Project Intelligence**: Handles both greenfield (new) and brownfield (existing) projects
|
||||
- **Semantic Reversion**: Git-aware revert by logical work units (tracks, phases, tasks)
|
||||
- **State Persistence**: Resume setup across multiple sessions
|
||||
|
||||
## Commands
|
||||
|
||||
| Command | Description |
|
||||
| ---------------------- | ---------------------------------------------------------------------------------- |
|
||||
| `/conductor:setup` | Initialize project with product definition, tech stack, workflow, and style guides |
|
||||
| `/conductor:new-track` | Create a feature or bug track with spec.md and plan.md |
|
||||
| `/conductor:implement` | Execute tasks from the plan following workflow rules |
|
||||
| `/conductor:status` | Display project progress overview |
|
||||
| `/conductor:revert` | Git-aware undo by track, phase, or task |
|
||||
|
||||
## Generated Artifacts
|
||||
|
||||
```
|
||||
conductor/
|
||||
├── index.md # Navigation hub
|
||||
├── product.md # Product vision & goals
|
||||
├── product-guidelines.md # Standards & messaging
|
||||
├── tech-stack.md # Technology preferences
|
||||
├── workflow.md # Development practices (TDD, commits)
|
||||
├── tracks.md # Master track registry
|
||||
├── setup_state.json # Resumable setup state
|
||||
├── code_styleguides/ # Language-specific conventions
|
||||
└── tracks/
|
||||
└── <track-id>/
|
||||
├── spec.md # Requirements specification
|
||||
├── plan.md # Phased task breakdown
|
||||
├── metadata.json # Track metadata
|
||||
└── index.md # Track navigation
|
||||
```
|
||||
|
||||
## Workflow
|
||||
|
||||
### 1. Setup (`/conductor:setup`)
|
||||
|
||||
Interactive initialization that creates foundational project documentation:
|
||||
|
||||
- Detects greenfield vs brownfield projects
|
||||
- Asks sequential questions about product, tech stack, workflow preferences
|
||||
- Generates style guides for selected languages
|
||||
- Creates tracks registry
|
||||
|
||||
### 2. Create Track (`/conductor:new-track`)
|
||||
|
||||
Start a new feature or bug fix:
|
||||
|
||||
- Interactive Q&A to gather requirements
|
||||
- Generates detailed specification (spec.md)
|
||||
- Creates phased implementation plan (plan.md)
|
||||
- Registers track in tracks.md
|
||||
|
||||
### 3. Implement (`/conductor:implement`)
|
||||
|
||||
Execute the plan systematically:
|
||||
|
||||
- Follows TDD red-green-refactor cycle
|
||||
- Updates task status markers
|
||||
- Includes manual verification checkpoints
|
||||
- Synchronizes documentation on completion
|
||||
|
||||
### 4. Monitor (`/conductor:status`)
|
||||
|
||||
View project progress:
|
||||
|
||||
- Current phase and task
|
||||
- Completion percentage
|
||||
- Identified blockers
|
||||
|
||||
### 5. Revert (`/conductor:revert`)
|
||||
|
||||
Undo work by logical unit:
|
||||
|
||||
- Select track, phase, or task to revert
|
||||
- Git-aware: finds all associated commits
|
||||
- Requires confirmation before execution
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
claude --plugin-dir /path/to/conductor
|
||||
```
|
||||
|
||||
Or copy to your project's `.claude-plugin/` directory.
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
Reference in New Issue
Block a user