Claude Workspace Template

A full operational kit for bootstrapping Claude Code projects with orchestration, continuity, and MCP runtime.

What's Included

Component	Description
Orchestrator	Conductor philosophy for decomposing complex tasks into parallel agent work
Continuity System	Session state that survives /clear (ledgers, handoffs)
Rules	4 battle-tested operational guardrails
Hooks	Event-driven automation (session lifecycle, tool use)
MCP Runtime	Python harness for MCP server integration
Braintrust Plugin	Optional observability/tracing

Quick Start

1. Clone the template

git clone https://github.com/YOUR_USERNAME/claude-workspace-template my-project
cd my-project

2. Setup environment

# Copy example files
cp .env.example .env
cp mcp_config.json.example mcp_config.json
cp CLAUDE.local.md.example CLAUDE.local.md

# Edit .env with your API keys
# Edit mcp_config.json with your MCP servers

3. Install Python dependencies

# Create virtual environment
uv venv

# Install base dependencies
uv pip install -e .

# Optional: Install with dev tools
uv pip install -e ".[dev]"

# Optional: Install with tracing
uv pip install -e ".[tracing]"

4. Generate MCP wrappers (if using MCP servers)

uv run mcp-generate

5. Start Claude

claude

Project Structure

.
├── .claude/
│   ├── skills/           # SOPs and workflows
│   │   ├── orchestrator/ # The conductor system
│   │   ├── continuity_ledger/
│   │   ├── create_handoff/
│   │   └── resume_handoff/
│   ├── rules/            # Operational guardrails
│   ├── hooks/            # Event automation
│   ├── plugins/          # Optional plugins
│   └── settings.json     # Hook config
│
├── thoughts/             # Context persistence
│   ├── ledgers/          # Session state
│   └── shared/           # Handoffs and plans
│
├── src/runtime/          # MCP runtime
├── scripts/              # CLI workflows
├── servers/              # Generated MCP wrappers (gitignored)
├── samples/              # Test data schemas
├── references/           # Domain knowledge
│
├── CLAUDE.md             # Main instructions
├── CLAUDE.local.md       # Local config (gitignored)
├── .env                  # API keys (gitignored)
└── mcp_config.json       # MCP server config

Key Concepts

Orchestrator

The orchestrator skill (.claude/skills/orchestrator/SKILL.md) defines how Claude operates:

• Decompose complex tasks into parallel workstreams
• Spawn worker agents for execution
• Synthesize results into coherent output

Continuity

State that persists across context clears:

• Ledgers (thoughts/ledgers/) - Session state, auto-loads after /clear
• Handoffs (thoughts/shared/handoffs/) - Cross-session documentation

Domain Guides

Pre-built guides for common task types in .claude/skills/orchestrator/references/domains/:

• Software development
• Code review
• Testing
• Documentation
• DevOps
• Data analysis
• Research
• Project management

Customization

Adding Skills

1. Create: .claude/skills/[skill-name]-SKILL.md
2. Add YAML frontmatter with triggers
3. Reference in CLAUDE.md if frequently used

Adding MCP Servers

1. Add config to mcp_config.json
2. Add keys to .env
3. Run uv run mcp-generate

Adding Reference Docs

Create markdown files in references/ for domain knowledge Claude should access.

Commands

# MCP wrapper generation
uv run mcp-generate

# Run script with MCP
uv run python -m runtime.harness scripts/your_script.py --args

# Schema discovery
uv run mcp-discover

License

MIT