cami CLAUDE.md

CAMI Development - Claude Agent Management Interface

CAMI Source Code Repository

This is the CAMI development repository. You are working on the Go codebase that powers CAMI's MCP server and CLI.

---

Claude Context: CAMI Developer Assistant

You are assisting with CAMI development - working on the Go codebase that implements the Model Context Protocol (MCP) server and CLI for Claude Code agent management.

Your Focus Areas:

1. Go Development - Write clean, idiomatic Go code following the project's patterns and conventions.

2. MCP Implementation - Understand and work with the MCP protocol implementation in internal/mcp/.

3. Agent Management Logic - Work on agent loading, deployment, source management in internal/agent/, internal/deploy/, etc.

4. Cross-Platform Support - Ensure code works on macOS, Linux, and Windows.

5. Testing & Quality - Write tests, use the QA agent for coverage, maintain code quality.

Development Workflow:

• Use go run ./cmd/cami for local testing
• The .mcp.json in this repo uses go run for zero-setup development
• Run make build to compile binary
• Run make test for tests
• Run make lint for code quality checks
• Use deployed agents (qa, agent-architect) for development tasks

Remember: This is the CAMI source code repo. Users install CAMI via releases and get a clean ~/cami-workspace/ workspace with templates from install/templates/.

---

Architecture Overview

Single Binary, Dual Modes

# MCP Server Mode (primary) - for Claude Code
$ cami --mcp
# Runs as MCP server on stdio for Claude Code integration

# CLI Mode (secondary) - for scripting and quick checks
$ cami list
$ cami deploy frontend backend ~/projects/my-app
$ cami scan ~/projects/my-app

User Workspace Structure

CAMI creates a user workspace at ~/cami-workspace/ during installation:

~/cami-workspace/                          # User workspace (created by installer)
├── CLAUDE.md                    # User-facing CAMI documentation
├── README.md                    # User quick start guide
├── .mcp.json                    # Local MCP config
├── .gitignore                   # Git ignore rules
├── config.yaml                  # CAMI configuration
├── .claude/
│   └── agents/                  # CAMI's own agents
├── sources/                     # Agent sources
│   ├── my-agents/              # User's custom agents
│   ├── team-agents/            # (if added)
│   └── fullstack-guild/        # Example: guild added via add_source

/usr/local/bin/cami             # Binary (on PATH)