"Deploy frontend and backend agents to ~/projects/my-app"

mcp__cami__deploy_agents({
  agent_names: ["frontend", "backend"],
  target_path: "/Users/you/projects/my-app",
  overwrite: false
})

{
  agents: Array<{
    name: string;           // Agent identifier(e.g., "frontend")
    version: string;        // Semantic version(e.g., "2.1.0")
    description: string;    // One-line purpose description
    category: string;       // Folder organization(e.g., "core")
    file_name: string;      // Source filename(e.g., "frontend.md")
  }>;
}

"What agents are available?"
"Show me all agents in the core category"
"List frontend-related agents"

Available agents (12 total):
## Core (3 agents)
• architect (v3.2.0)
  Expert application architect specializing in system design
• backend (v2.1.0)
  Back-end specialist for Node.js and API development
• frontend (v2.0.1)
  Front-end specialist for React and modern web UIs
## Specialized (2 agents)
• designer (v1.1.0)
  Visual design and UI/UX specialist
• qa (v1.0.0)
  Quality assurance and testing specialist

agent_sources:
  - name: my-agents        # Priority 10 (highest)
  - name: team-agents      # Priority 50 (medium)
  - name: official-agents  # Priority 100 (lowest)

{
  agent_names: string[];    // Required: Agent names to deploy
  target_path: string;      // Required: Absolute project path
  overwrite?: boolean;      // Optional: Replace existing(default: false)
}

{
  results: Array<{
    agent_name: string;     // Agent that was deployed
    success: boolean;       // Whether deployment succeeded
    message: string;        // Human-readable result message
    conflict?: boolean;     // True if file exists and overwrite=false
  }>;
}

"Deploy frontend and backend agents to ~/projects/my-app"
"Add the designer agent to this project"
"Update the architect agent to the latest version"

mcp__cami__deploy_agents({
  agent_names: ["frontend", "backend"],
  target_path: "/Users/you/projects/my-app",
  overwrite: false
})

Deployed 2 agents to /Users/you/projects/my-app
✓ frontend: Deployed successfully
✓ backend: Deployed successfully

✗ frontend: File already exists (use overwrite=true to replace)

✓ frontend: Deployed successfully (overwrote existing)

version: "1"
state: cami-native
normalized_at: 2025-11-24T10:30:00Z
agents:
  - name: frontend
    version: "2.0.1"
    source: official-agents
    source_path: /Users/you/cami-workspace/sources/official-agents/frontend.md
    priority: 50
    deployed_at: 2025-11-24T10:30:00Z
    content_hash: abc123...
    metadata_hash: def456...
    origin: cami

deployments:
  /Users/you/projects/my-app:
    state: cami-native
    normalized_at: 2025-11-24T10:30:00Z
    last_scanned: 2025-11-24T10:30:00Z
    agents:
      - name: frontend
        version: "2.0.1"
        # ... same fields as project manifest

{
  target_path: string;  // Required: Absolute path to project
}

{
  statuses: Array<{
    name: string;              // Agent name
    deployed_version: string;  // Version in project(empty if not deployed)
    available_version: string; // Latest version in sources
    status: string;            // "up-to-date" | "update-available" | "not-deployed"
  }>;
}

"What agents are deployed in this project?"
"Check if my agents need updating"
"Scan ~/projects/my-app for deployed agents"

Scanning /Users/you/projects/my-app
Found 3 deployed agents
✓ frontend: up-to-date (deployed: v2.0.1, available: v2.0.1)
⚠ backend: update-available (deployed: v1.5.0, available: v2.1.0)
○ designer: not-deployed

{
  target_path: string;  // Required: Absolute path to project
}

"Update CLAUDE.md with deployed agents"
"Document the agents in this project"
"Refresh the agent documentation"

Updated CLAUDE.md at /Users/you/projects/my-app
Documented 3 agents:
  • frontend (v2.0.1)
  • backend (v2.1.0)
  • designer (v1.1.0)

<!-- CAMI-MANAGED: DEPLOYED-AGENTS | Last Updated: 2025-11-24T10:30:00Z -->
## Deployed Agents
The following Claude Code agents are available in this project:
### frontend (v2.0.1)
Front-end specialist for React and modern web UIs with TypeScript expertise.
### backend (v2.1.0)
Back-end specialist for Node.js API development with database integration.
### designer (v1.1.0)
Visual design and UI/UX specialist ensuring aesthetic excellence.
<!-- /CAMI-MANAGED: DEPLOYED-AGENTS -->

<!-- CAMI-MANAGED: SECTION-NAME | Last Updated: timestamp -->
... managed content ...
<!-- /CAMI-MANAGED: SECTION-NAME -->

# CLAUDE.md
Project documentation for Claude Code.
<!-- CAMI-MANAGED: DEPLOYED-AGENTS | ... -->
...
<!-- /CAMI-MANAGED: DEPLOYED-AGENTS -->

{
  project_path: string;  // Required: Absolute path to project
  dry_run?: boolean;     // Optional: Preview without changes(default: false)
}

{
  project_path: string;
  agents_found: number;
  agents_imported: number;  // 0 if dry_run=true
  agents: Array<{
    name: string;
    version: string;
    file_path: string;
    origin: string;        // "cami" | "external"
    source_match: string;  // Source name if matched, empty otherwise
    content_hash: string;
    metadata_hash: string;
  }>;
  dry_run: boolean;
}

"Import agents from ~/projects/legacy-app"
"Preview what would be imported from this project"
"Bring existing agents into CAMI tracking"

mcp__cami__import_agents({
  project_path: "/Users/you/projects/legacy-app",
  dry_run: true
})

# Import Agents: /Users/you/projects/legacy-app
**Agents Found:** 5
## Matched to CAMI Sources
- **frontend** (v2.0.1) - Source: `official-agents`
- **backend** (v2.1.0) - Source: `official-agents`
## External Agents (No Source Match)
- **custom-agent** (v1.0.0)
- **legacy-helper** (no version)
- **temp-script** (v0.1.0)
---
**This is a dry run - no changes were made.**
To import these agents, call this tool again with `dry_run=false`.

mcp__cami__import_agents({
  project_path: "/Users/you/projects/legacy-app",
  dry_run: false
})

# Import Agents: /Users/you/projects/legacy-app
**Agents Found:** 5
## Matched to CAMI Sources
- **frontend** (v2.0.1) - Source: `official-agents`
- **backend** (v2.1.0) - Source: `official-agents`
## External Agents (No Source Match)
- **custom-agent** (v1.0.0)
- **legacy-helper** (no version)
---
Import Complete!
- Imported 5 agents
- 2 matched to sources
- 3 external agents
- Created project manifest
- Updated central deployment tracking
These agents are now tracked by CAMI for version management and updates!

// Pseudo-code for matching
for each deployed_agent:
  for each available_agent in sources:
    if deployed_agent.name == available_agent.name:
      deployed_hash = hash(deployed_agent.content)
      source_hash = hash(available_agent.content)
      if deployed_hash == source_hash:
        // Exact match - originated from this source
        origin = "cami"
        source_match = source.name
        break

{
  url: string;       // Required: Git URL(HTTPS or SSH)
  name?: string;     // Optional: Source name(derived from URL if omitted)
  priority?: number; // Optional: Priority(default: 50)
}

"Add agent source from git@github.com:company/agents.git"
"Clone the official agents library"
"Add team agents with priority 10"

mcp__cami__add_source({
  url: "git@github.com:company/agents.git",
  name: "company-agents",  // Optional
  priority: 50             // Optional
})

✓ Cloned company-agents to ~/cami-workspace/sources/company-agents
✓ Added source with priority 50
✓ Found 12 agents
## Source Compliance Check
✓ **Source is fully compliant!**

✓ Cloned team-agents to ~/cami-workspace/sources/team-agents
✓ Added source with priority 50
✓ Found 8 agents
## Source Compliance Check
This source has compliance issues:
- Missing .camiignore file
- 3 agents with issues:
  - old-agent.md: missing version, missing description
  - legacy.md: missing version
**Recommendation:** Use `normalize_source` to fix these issues automatically.
This will add missing versions, descriptions, and create .camiignore.

git@github.com:company/agents.git → "agents"
https://github.com/lando/official-agents.git → "official-agents"
git@gitlab.com:team/custom.git → "custom"

~/cami-workspace/sources/<name>/

$CAMI_DIR/sources/<name>/

agent_sources:
  - name: company-agents
    type: local
    path: /Users/you/cami-workspace/sources/company-agents
    priority: 50
    git:
      enabled: true
      remote: git@github.com:company/agents.git

{
  sources: Array<{
    name: string;
    path: string;
    priority: number;
    agent_count: number;
    git_remote?: string;      // Present if git enabled
    git_enabled: boolean;
    is_compliant: boolean;    // True if passes compliance checks
    issue_count?: number;     // Number of compliance issues
    issues_summary?: string;  // Summary of issues
  }>;
}

"What agent sources are configured?"
"Show me all sources with their priorities"
"List sources that need updates"

Agent Sources (3 total):
• ✓ official-agents (priority 50)
  Path: /Users/you/cami-workspace/sources/official-agents
  Agents: 15
  Git: git@github.com:lando/official-agents.git
  Compliance: ✓ Compliant
• ⚠️ team-agents (priority 30)
  Path: /Users/you/cami-workspace/sources/team-agents
  Agents: 8
  Git: git@github.com:company/team-agents.git
  Compliance: ⚠️ Issues (3 agents with issues)
• ✓ my-agents (priority 10)
  Path: /Users/you/cami-workspace/sources/my-agents
  Agents: 2
  Compliance: ✓ Compliant
**Note:** 1/3 sources have compliance issues.
Use `detect_source_state` and `normalize_source` to fix issues.

{
  name?: string;  // Optional: Specific source name(updates all if omitted)
}

"Update all agent sources"
"Pull latest changes for official-agents"
"Update the team-agents source"

mcp__cami__update_source({})

Updating official-agents...
  ✓ Updated
Updating team-agents...
  ✓ Up to date
Updating my-agents...
Updated: official-agents
Skipped (no git remote): my-agents

mcp__cami__update_source({
  name: "official-agents"
})

Updating official-agents...
  ✓ Updated
Updated: official-agents

agent_sources:
  - name: official-agents
    git:
      enabled: true
      remote: git@github.com:lando/agents.git

"Check git status of agent sources"
"Do I have uncommitted changes in my sources?"
"Show source status"

Agent Source Status:
• official-agents
  Git: ✓ clean
• team-agents
  Git: ⚠ 3 uncommitted changes
    M frontend.md
    M backend.md
    ?? new-agent.md
    ... and 0 more
• my-agents
  Git: not enabled

You: "Update all sources"
Claude: "Let me check for uncommitted changes first..."
[Runs source_status]
Claude: "I see you have uncommitted changes in team-agents.
        Would you like to commit them before updating?"

{
  source_name: string;  // Required: Name of source to analyze
}

{
  path: string;
  agent_count: number;
  is_compliant: boolean;
  missing_camiignore: boolean;
  issues: Array<{
    agent_file: string;
    problems: string[];  // e.g., ["missing version", "missing description"]
  }>;
}

"Check compliance of team-agents source"
"Analyze official-agents for issues"
"Is my-agents source compliant?"

# Source Analysis: official-agents
**Path:** /Users/you/cami-workspace/sources/official-agents
**Agent Count:** 15
**Compliant:** true
✓ **All agents are compliant!**

# Source Analysis: team-agents
**Path:** /Users/you/cami-workspace/sources/team-agents
**Agent Count:** 8
**Compliant:** false
Missing .camiignore file
## Issues Found (3)
**legacy-agent.md:**
  - missing version
  - missing description
**old-helper.md:**
  - missing version
**temp-script.md:**
  - missing description
## Recommended Action
Use `normalize_source` to fix these issues automatically.

{
  source_name: string;         // Required: Source to normalize
  add_versions: boolean;       // Add "1.0.0" to agents missing version
  add_descriptions: boolean;   // Add placeholder descriptions
  create_camiignore: boolean;  // Create .camiignore file
}

{
  success: boolean;
  agents_updated: number;
  backup_path: string;      // Where backup was created
  changes: string[];        // List of changes made
}

"Normalize team-agents source"
"Fix compliance issues in my-agents"
"Add missing versions to legacy-agents"

mcp__cami__normalize_source({
  source_name: "team-agents",
  add_versions: true,
  add_descriptions: true,
  create_camiignore: true
})

# Source Normalization: team-agents
**Status:** ✓ Success
**Agents Updated:** 3
**Backup Created:** /Users/you/cami-workspace/sources/.backups/team-agents-20251124-103045
## Changes Made
- Added version "1.0.0" to legacy-agent.md
- Added version "1.0.0" to old-helper.md
- Added description to temp-script.md
- Created .camiignore file

// Only add versions, don't touch descriptions
mcp__cami__normalize_source({
  source_name: "team-agents",
  add_versions: true,
  add_descriptions: false,
  create_camiignore: false
})

~/cami-workspace/sources/.backups/
  team-agents-20251124-103045/
    frontend.md
    backend.md
    legacy-agent.md
    ...

---
name: legacy-agent
description: Helper for legacy systems
---

---
name: legacy-agent
version: "1.0.0"
description: Helper for legacy systems
---

---
name: api-helper
version: "1.0.0"
---

---
name: api-helper
version: "1.0.0"
description: Agent for api-helper tasks (update this description)
---

# Documentation files
README.md
LICENSE.md
LICENSE
CHANGELOG.md
# Drafts and work in progress
*-draft.md
*-wip.md
*.draft
*.wip
# Templates and examples
templates/
examples/
*.template
# Hidden files
.git/
.github/
.DS_Store
# Config files
*.json
*.yaml
*.yml

# Manual undo
cp -r ~/cami-workspace/sources/.backups/team-agents-20251124-103045/* \
      ~/cami-workspace/sources/team-agents/

{
  name: string;  // Required: Friendly location name
  path: string;  // Required: Absolute path to project
}

"Add my-app as a deployment location at ~/projects/my-app"
"Register this project directory"
"Save ~/projects/api-backend as 'api-backend'"

mcp__cami__add_location({
  name: "my-app",
  path: "/Users/you/projects/my-app"
})

Added location 'my-app' at /Users/you/projects/my-app
Total locations: 3

deploy_locations:
  - name: my-app
    path: /Users/you/projects/my-app
  - name: api-backend
    path: /Users/you/projects/api-backend

"Deploy frontend to /Users/you/projects/my-long-project-name-here"

"Deploy frontend to my-app"  # Claude looks up path

{
  locations: Array<{
    name: string;
    path: string;
  }>;
}

"What locations are configured?"
"Show me saved project directories"
"List deployment locations"

Configured locations (3 total):
• my-app
  /Users/you/projects/my-app
• api-backend
  /Users/you/projects/api-backend
• landing-page
  /Users/you/projects/landing-page

Configured locations (0 total):
No locations configured yet. Use add_location to register a project directory.

You: "Deploy frontend to my-app"
Claude: [Looks up "my-app" → /Users/you/projects/my-app]
        [Calls deploy_agents with full path]

{
  name: string;  // Required: Location name to remove
}

"Remove the my-app location"
"Unregister api-backend"
"Delete the landing-page location"

mcp__cami__remove_location({
  name: "my-app"
})

Removed location 'my-app'
Remaining locations: 2

{
  name: string;              // Required: Project name(kebab-case for directory)
  path?: string;             // Optional: Directory path(defaults to ~/projects/{name})
  description: string;       // Required: High-level project description(2-3 paragraphs)
  agent_names: string[];     // Required: Agents to deploy
  vision_doc?: string;       // Optional: CLAUDE.md content(vision, not implementation)
}

{
  project_path: string;      // Where project was created
  agents_deployed: string[]; // Successfully deployed agent names
  success: boolean;
}

"Create a new project called my-api-backend"
"Start a new React app with frontend and designer agents"
"Set up a project for building a dashboard"

You: "Create a new project"
Claude: "I'll help you create a new project. Let me gather some information..."
[Uses AskUserQuestion to gather requirements]
You: [Provides: "api-backend", "REST API for mobile app", "Node.js + PostgreSQL"]
Claude: "Let me see what agents are available..."
[Calls list_agents]
Claude: "I recommend these agents for your Node.js API project:
        - backend (v2.1.0) - API development specialist
        - database (v1.5.0) - Database design expert
        - qa (v1.0.0) - Testing specialist
        Does this look good?"
You: "Yes, looks great"
Claude: [Creates project with create_project tool]
Project Created Successfully!
**Project**: api-backend
**Location**: /Users/you/projects/api-backend
**Agents Deployed**: 3
**Deployed Agents:**
- backend
- database
- qa
**Next Steps:**
1. Navigate to project: `cd /Users/you/projects/api-backend`
2. Review CLAUDE.md for project vision
3. Start building with your specialized agents!

~/projects/api-backend/
├── .claude/
│   ├── agents/
│   │   ├── backend.md
│   │   ├── database.md
│   │   └── qa.md
│   └── .cami/
│       └── manifest.yaml
└── CLAUDE.md

# api-backend
[Vision doc content if provided...]
<!-- CAMI-MANAGED: DEPLOYED-AGENTS | Last Updated: 2025-11-24T10:30:00Z -->
## Deployed Agents
### backend (v2.1.0)
Back-end specialist for Node.js API development with database integration.
### database (v1.5.0)
Database design expert for PostgreSQL and data modeling.
### qa (v1.0.0)
Quality assurance and testing specialist.
<!-- /CAMI-MANAGED: DEPLOYED-AGENTS -->

deploy_locations:
  - name: api-backend
    path: /Users/you/projects/api-backend

{
  project_path: string;  // Required: Absolute path to project
}

{
  path: string;
  state: string;              // Project state classification
  has_agents_dir: boolean;    // Has .claude/agents/
  has_manifest: boolean;      // Has .claude/.cami/manifest.yaml
  agent_count: number;
  agents: Array<{
    name: string;
    version: string;
    matches_source: string;   // Source name if matched
    needs_upgrade: boolean;   // True if newer version available
  }>;
  recommendations: {
    minimal_required: boolean;     // Should create manifests
    standard_recommended: boolean; // Should link to sources
    full_optional: boolean;        // Should rewrite with agent-architect
  };
}

"Analyze this project's CAMI state"
"What's the normalization status of ~/projects/my-app?"
"Check if this project needs normalization"

# Project Analysis
**Path:** /Users/you/projects/my-app
**State:** cami-aware
**Has Agents Directory:** true
**Has Manifest:** false
**Agent Count:** 3
## Deployed Agents
**frontend** (v2.0.1) - matches official-agents
**backend** (v1.5.0) - matches official-agents (update available)
**custom-helper** (no version) - not in sources
## Recommendations
✓ **Minimal normalization required:** Create manifests for tracking
✓ **Standard normalization recommended:** Link agents to sources

# Project Analysis
**Path:** /Users/you/projects/my-app
**State:** cami-native
**Has Agents Directory:** true
**Has Manifest:** true
**Agent Count:** 3
## Deployed Agents
**frontend** (v2.0.1) - matches official-agents
**backend** (v2.1.0) - matches official-agents
**designer** (v1.1.0) - matches official-agents
## Recommendations
✓ **Project is fully normalized!**

{
  project_path: string;  // Required: Absolute path to project
  level: string;         // Required: "minimal" | "standard" | "full"
}

{
  success: boolean;
  state_before: string;      // State before normalization
  state_after: string;       // State after normalization
  backup_path: string;       // Where backup was created
  changes: string[];         // List of changes made
  undo_available: boolean;   // Whether undo is possible
}

"Normalize this project"
"Apply standard normalization to ~/projects/my-app"
"Create manifests for agent tracking"

mcp__cami__normalize_project({
  project_path: "/Users/you/projects/my-app",
  level: "minimal"
})

# Project Normalization
**Status:** ✓ Success
**State Before:** cami-aware
**State After:** cami-legacy
**Backup Created:** /Users/you/projects/my-app/.claude/.cami/.backups/20251124-103045
## Changes Made
- Created project manifest
- Added 3 agents to manifest
- Updated central deployment tracking

mcp__cami__normalize_project({
  project_path: "/Users/you/projects/my-app",
  level: "standard"
})

# Project Normalization
**Status:** ✓ Success
**State Before:** cami-aware
**State After:** cami-native
**Backup Created:** /Users/you/projects/my-app/.claude/.cami/.backups/20251124-103045
## Changes Made
- Created project manifest
- Matched 2 agents to sources:
  - frontend → official-agents (priority 50)
  - backend → official-agents (priority 50)
- Marked 1 agent as external:
  - custom-helper (no source match)
- Updated central deployment tracking
**Undo available:** Use backup.RestoreFromBackup to revert changes

mcp__cami__normalize_project({
  project_path: "/Users/you/projects/my-app",
  level: "full"
})

.claude/.cami/.backups/20251124-103045/
  agents/
    frontend.md
    backend.md
    custom-helper.md
  manifest.yaml  # If existed

non-cami → [normalize minimal] → cami-legacy
cami-aware → [normalize minimal] → cami-legacy
cami-aware → [normalize standard] → cami-native
cami-legacy → [normalize standard] → cami-native

{
  target_path: string;  // Required: Project path or source path
  keep_recent: number;  // Required: Number of backups to keep(default: 3)
}

{
  removed_count: number;
  freed_bytes: number;
  kept_backups: string[];  // Paths to remaining backups
}

"Clean up old backups"
"Remove old backups, keep the 3 most recent"
"Free up space by deleting old backups"

mcp__cami__cleanup_backups({
  target_path: "/Users/you/projects/my-app",
  keep_recent: 3
})

# Backup Cleanup
**Total Backups:** 15
**Total Size:** 12.50 MB
## Cleanup Results
**Removed:** 12 backups
**Freed:** 10.00 MB
**Kept:** 3 backups
**Remaining backups:**
- 20251124-103045
- 20251123-150230
- 20251122-091500

# Backup Cleanup
**Total Backups:** 2
**Total Size:** 1.80 MB
No cleanup needed - only 2 backups exist (keeping 3)

<project>/.claude/.cami/.backups/
  20251124-103045/
  20251123-150230/
  ...

~/cami-workspace/sources/.backups/
  team-agents-20251124-103045/
  team-agents-20251123-150230/
  ...

{
  state: {
    config_exists: boolean;
    is_fresh_install: boolean;
    source_count: number;
    location_count: number;
    has_agent_architect: boolean;
    total_agents: number;
    deployed_agents: number;
    recommended_next: string;  // Personalized next step
  };
}

"Help me get started with CAMI"
"What should I do next?"
"I'm new to CAMI"

# Welcome to CAMI!
I see this is a fresh installation. Let me guide you through getting started.
## Your CAMI Setup
**CAMI Workspace** (Agent Building): `~/cami-workspace/`
  → Where agent sources and configuration live
  → Manage and create agents globally
**Development Workspace** (Projects): `~/projects/`
  → Where your projects live
  → Where agents get deployed
---
## Three Paths Forward
**Path 1: Add Agent Library** (Recommended for new users)
  → Get pre-built professional agents from a Git repository
  → I can help you find and add agent sources
  → Tell me: 'Add agent source from <git-url>'
**Path 2: Create Custom Agents**
  → Work with agent-architect to build specialized agents
  → Best if you have specific needs
  → Tell me: 'Create a new agent for [task]'
**Path 3: Import Existing Agents**
  → Already have agents deployed in other projects?
  → I can scan and track them in CAMI
  → Tell me: 'Import agents from [project-path]'
**Which path interests you?**

# CAMI Setup Status
## Your CAMI Setup
**CAMI Workspace**: `~/cami-workspace/`
  → Where agent sources and config live
**Development Workspace**: `~/projects/`
  → Where your projects live
**Tracked Projects**: 3
  → Projects CAMI knows about
---
## Agent Sources
✓ 2 source(s) configured
✓ 15 agents available
## Available Agents
You have access to 15 agents.
- Use `mcp__cami__list_agents` to see all available agents
- Use `mcp__cami__deploy_agents` to add agents to projects
## Deployed Agents (Current Project)
**No agents deployed in this project yet**
## Quick Commands
**List agents:** `mcp__cami__list_agents`
**Deploy agents:** `mcp__cami__deploy_agents`
**Scan current project:** `mcp__cami__scan_deployed_agents`
**Add agent source:** `mcp__cami__add_source`
**Update sources:** `mcp__cami__update_source`
**Recommended next step:** Deploy agents to current project

1. User: "Help me get started with CAMI"
   Tool: onboard
2. User: "Add agent source from git@github.com:lando/agents.git"
   Tool: add_source
3. User: "What agents are available?"
   Tool: list_agents
4. User: "Deploy frontend and backend to ~/projects/my-app"
   Tool: deploy_agents
5. User: "Update the documentation"
   Tool: update_claude_md

1. User: "Create a new project"
   [Claude uses AskUserQuestion to gather requirements]
2. Tool: list_agents (Claude checks available specialists)
3. [Claude recommends agents based on requirements]
   User confirms
4. Tool: create_project
   Result: Project created with agents and CLAUDE.md

1. User: "Update my agents"
   Tool: scan_deployed_agents (check current versions)
2. Tool: update_source (pull latest from Git)
3. Tool: scan_deployed_agents (verify updates available)
4. Tool: deploy_agents (with overwrite=true)
5. Tool: update_claude_md (document new versions)

1. User: "Bring this project into CAMI"
   Tool: detect_project_state (analyze current state)
2. [Claude shows analysis and recommendations]
3. User: "Normalize it"
   Tool: normalize_project (level: "standard")
4. Tool: scan_deployed_agents (verify normalization)
5. Tool: update_claude_md (document agents)

1. Tool: add_source (clone new source)
   Response: "This source has compliance issues"
2. Tool: detect_source_state (detailed analysis)
3. User: "Fix the issues"
   Tool: normalize_source (add versions, descriptions, .camiignore)
4. Tool: list_sources (verify compliance: ✓)

"Deploy frontend to my-app"
→ Looks up "my-app" in locations
→ Calls deploy_agents with full path
"Add designer to this project"
→ Uses current working directory
→ Calls deploy_agents
"Update frontend and backend"
→ Interprets as deploy with overwrite=true
→ Calls deploy_agents with overwrite=true

"Add agent source from <url>"
→ Calls add_source with URL
→ Auto-detects compliance
→ Suggests normalize_source if needed
"Update all sources"
→ Calls update_source with no name
→ Updates all git-enabled sources
"Pull latest changes for team-agents"
→ Calls update_source with name="team-agents"

"Create a new project"
→ Asks questions to gather requirements
→ Calls list_agents to check availability
→ Recommends agents
→ Calls create_project with user-confirmed agents
"What projects are registered?"
→ Calls list_locations

"What agents are available?"
→ Calls list_agents
"What's deployed in this project?"
→ Calls scan_deployed_agents
"What should I do next?"
→ Calls onboard

You: [In ~/projects/my-app]
You: "What agents are deployed here?"
Claude: [Calls scan_deployed_agents with current directory]

You: "Deploy frontend to my-app"
Claude: [Looks up "my-app" in locations]
        [Uses full path: /Users/you/projects/my-app]
        [Calls deploy_agents]

You: "Update the frontend agent"
Claude: [Interprets "update" as overwrite=true]
        [Calls deploy_agents with overwrite=true]

Tool: deploy_agents fails (agent not found)
Claude: "The 'frontent' agent doesn't exist. Did you mean 'frontend'?"
        [Suggests correction based on list_agents]

Error: "agents not found: ['frontent']"

I couldn't find the 'frontent' agent. Did you mean 'frontend'?
Available agents: frontend, backend, designer, qa

Error: "invalid target path: path does not exist: /Users/you/projects/typo"

The path /Users/you/projects/typo doesn't exist.
Did you mean one of these registered locations?
- my-app: /Users/you/projects/my-app
- api-backend: /Users/you/projects/api-backend

{
  results: [{
    agent_name: "frontend",
    success: false,
    conflict: true,
    message: "File already exists (use overwrite=true to replace)"
  }]
}

The frontend agent is already deployed. Would you like me to:
1. Overwrite with the latest version
2. Keep the existing version
3. Compare the versions first

Error: "no agent sources configured - run 'cami source add <git-url>'"

You don't have any agent sources configured yet.
I can help you add an agent source! Just tell me:
- The Git URL of your agent repository
Or if you don't have one, I can guide you through creating custom agents.

agent_sources:
  - name: my-agents
    priority: 10      # Highest priority
  - name: team-agents
    priority: 50      # Medium priority
  - name: official-agents
    priority: 100     # Lowest priority

• frontend (v3.0.0-custom)
  [From my-agents source]

You: "Which frontend agent is active?"
Claude: [Calls list_agents]
        [Shows: "frontend (v3.0.0-custom) from my-agents"]

version: "1"
state: cami-native  # non-cami | cami-aware | cami-legacy | cami-native
normalized_at: 2025-11-24T10:30:00Z
agents:
  - name: frontend
    version: "2.0.1"
    source: official-agents        # Source that provided this agent
    source_path: /Users/you/cami-workspace/sources/official-agents/frontend.md
    priority: 50                   # Priority of source
    deployed_at: 2025-11-24T10:30:00Z
    content_hash: abc123def456...  # SHA-256 of agent content
    metadata_hash: def456abc123... # SHA-256 of frontmatter
    origin: cami                   # "cami" | "external"

deployments:
  /Users/you/projects/my-app:
    state: cami-native
    normalized_at: 2025-11-24T10:30:00Z
    last_scanned: 2025-11-24T10:30:00Z
    agents:
      - name: frontend
        version: "2.0.1"
        # ... same fields as project manifest
  /Users/you/projects/api-backend:
    state: cami-native
    normalized_at: 2025-11-24T10:35:00Z
    last_scanned: 2025-11-24T10:35:00Z
    agents:
      - name: backend
        version: "2.1.0"
        # ...

~/cami-workspace/              # Or $CAMI_DIR
├── config.yaml                # Global configuration
├── central-manifest.yaml      # All deployments tracking
└── sources/                   # Agent source repositories
    ├── official-agents/
    │   ├── .camiignore
    │   ├── frontend.md
    │   ├── backend.md
    │   └── ...
    ├── team-agents/
    │   ├── .camiignore
    │   └── ...
    └── .backups/              # Source normalization backups
        └── team-agents-20251124-103045/

~/projects/                    # Or custom projects dir
└── my-app/
    ├── .claude/
    │   ├── agents/            # Deployed agents
    │   │   ├── frontend.md
    │   │   └── backend.md
    │   └── .cami/
    │       ├── manifest.yaml  # Project manifest
    │       └── .backups/      # Project normalization backups
    │           └── 20251124-103045/
    └── CLAUDE.md              # Project documentation

export CAMI_DIR=~/my-custom-cami-workspace

1. Run with dry_run=true (preview)
2. Review changes
3. Run with dry_run=false (execute)

{
  "mcpServers": {
    "cami": {
      "command": "cami",
      "args": ["--mcp"]
    }
  }
}