Tool Integration

┌─────────────────────────────────────────────────────────────────────────┐
│                          Primer System                                  │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  primer.schema.json          Defines WHAT a primer can contain          │
│         │                    • Section structure                        │
│         │                    • Value dimensions (safety/efficiency/etc) │
│         │                    • Capabilities registry                    │
│         │                    • Selection algorithms                     │
│         ▼                                                               │
│  primer.defaults.json        The DEFAULT section library                │
│         │                    • ~35 fine-grained sections                │
│         │                    • Multi-dimensional values                 │
│         │                    • Dynamic modifiers                        │
│         │                    • Format templates (markdown/compact/json) │
│         ▼                                                               │
│  acp primer CLI              ASSEMBLES primers on demand                │
│         │                    • --budget for token limits                │
│         │                    • --weights for dimension tuning           │
│         │                    • --preview/--compare for analysis         │
│         │                    • --tool for capability auto-detection     │
│         ▼                                                               │
│  acp sync                    DISTRIBUTES to tool configs                │
│         │                    • Calls primer internally per tool         │
│         │                    • Merges with existing files               │
│         │                    • Auto-runs on init/index                  │
│         ▼                                                               │
│  .cursorrules, CLAUDE.md,    Tool-specific output files                 │
│  copilot-instructions.md,    • Auto-read by each tool                   │
│  AGENTS.md, etc.             • User never copies/pastes                 │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

{
  "id": "lock-frozen",
  "name": "Lock Level: Frozen",
  "category": "constraints",
  "priority": 11,
  "tokens": 18,
  "required": false,
  "requiredIf": "constraints.frozenCount > 0",
  "capabilities": ["shell"],
  "dependsOn": ["constraint-concept"],
  "value": {
    "safety": 100,
    "efficiency": 30,
    "accuracy": 40,
    "base": 60,
    "modifiers": [
      {
        "condition": "constraints.frozenCount > 0",
        "add": 40,
        "reason": "Project has frozen files"
      }
    ]
  },
  "formats": {
    "markdown": { "template": "**`frozen`**: Never modify under any circumstances." },
    "compact": { "template": "frozen=NEVER modify" },
    "json": null
  }
}

score = (safety × w_safety) + (efficiency × w_efficiency) + 
        (accuracy × w_accuracy) + (base × w_base)

{
  "modifiers": [
    {
      "condition": "hacks.count == 0",
      "multiply": 0,
      "reason": "No hacks exist, section worthless"
    },
    {
      "condition": "hacks.expiredCount > 0",
      "add": 50,
      "dimension": "safety",
      "reason": "Expired hacks need attention"
    }
  ]
}

function selectSections(budget, projectState, capabilities, weights):
    selected = []
    remaining = budget
    
    // Phase 1: Required sections (non-negotiable)
    for section in sections.filter(s => isRequired(s, projectState)):
        if section.tokens > remaining:
            ERROR("Budget too small for required sections")
        selected.push(section)
        remaining -= section.tokens
    
    // Phase 2: Conditionally required
    for section in sections.filter(s => isRequiredIf(s, projectState)):
        if meetsCondition(s.requiredIf, projectState):
            selected.push(section)
            remaining -= section.tokens
    
    // Phase 3: Safety-critical (safety >= 80)
    candidates = sections.filter(s => 
        !selected.includes(s) && 
        meetsCapabilities(s, capabilities) &&
        s.value.safety >= 80
    )
    for section in candidates.sortBy(s => calculateScore(s, weights)):
        if section.tokens <= remaining:
            selected.push(section)
            remaining -= section.tokens
    
    // Phase 4: Value-optimized (fill remaining budget)
    candidates = sections.filter(s => 
        !selected.includes(s) && 
        meetsCapabilities(s, capabilities) &&
        meetsDependencies(s, selected)
    )
    for section in candidates.sortBy(s => calculateScore(s, weights) / s.tokens):
        if section.tokens <= remaining:
            selected.push(section)
            remaining -= section.tokens
    
    return selected

acp sync [options]

acp init
# Creates .acp.config.json
# Runs acp index
# Runs acp sync  ← automatic

acp index --sync
# Equivalent to: acp index && acp sync

acp watch --sync
# Re-syncs when cache updates

acp primer [options]

$ acp primer --budget 500 --preview
 
┌─────────────────────────────────────────────────────────────────────────┐
│ Primer Budget: 500 tokens                                               │
├─────────────────────────────────────────────────────────────────────────┤
│  Category      Section                  Tokens   Score   V/T    Status  │
│  ─────────────────────────────────────────────────────────────────────  │
│  🚀 bootstrap  acp-exists                  15     245  16.33   ✓ req    │
│  🚀 bootstrap  acp-location                25     222   8.88   ✓ req    │
│  🔒 constraints constraint-concept         35     240   6.86   ✓ req    │
│  🔒 constraints lock-frozen                18     210  11.67   ✓ cond   │
│  🔒 constraints protected-files-list      120     189   1.58   ✓        │
│  ⚡ interface   cli-overview               35     142   4.06   ✓         │
│  ─────────────────────────────────────────────────────────────────────  │
│  TOTAL                                    355             USED          │
│  Remaining: 145 tokens                                                  │
└─────────────────────────────────────────────────────────────────────────┘

{
  "$schema": "https://acp-protocol.dev/schemas/v1/sync.schema.json",
  "version": "1.0.0",
  "enabled": true,
  "auto": true,
  "tools": ["cursor", "claude-code", "generic"],
  "primer": {
    "defaultBudget": 500,
    "preset": "safe"
  },
  "custom": {
    "cursor": {
      "primer": {
        "budget": 2000,
        "capabilities": ["shell", "file-read", "file-write"]
      }
    },
    "claude-code": {
      "primer": {
        "budget": 4000,
        "capabilities": ["shell", "mcp", "file-read", "file-write"],
        "weights": { "safety": 1.5, "efficiency": 1.2 }
      }
    }
  }
}

{
  "$schema": "https://acp-protocol.dev/schemas/v1/primer.schema.json",
  "version": "1.0.0",
  "sections": [
    {
      "id": "project-architecture",
      "category": "structure",
      "priority": 39,
      "tokens": 50,
      "value": { "safety": 30, "efficiency": 60, "accuracy": 80, "base": 50 },
      "formats": {
        "markdown": {
          "template": "This is a microservices architecture using gRPC."
        }
      }
    }
  ],
  "selectionStrategy": {
    "weights": { "safety": 2.0, "efficiency": 1.0, "accuracy": 1.5, "base": 0.8 }
  }
}

interface ToolAdapter {
    readonly name: string;
    readonly outputPath: string;
    readonly capabilities: Capability[];
    readonly defaultBudget: number;
    readonly format: OutputFormat;
    
    detect(projectRoot: string): Promise<boolean>;
    generate(primer: AssembledPrimer): Promise<string>;
    validate(content: string): Result<void, ValidationError>;
    merge(existing: string, generated: string): string;
}

{
  "customAdapters": [
    {
      "name": "my-ide",
      "displayName": "My Custom IDE",
      "outputPath": ".my-ide/context.md",
      "format": "markdown",
      "detect": { "files": [".my-ide/config.json"] },
      "mergeStrategy": "section",
      "sectionMarker": "<!-- ACP-CONTEXT -->",
      "primer": {
        "budget": 2000,
        "capabilities": ["shell", "file-read"]
      }
    }
  ]
}

<!-- BEGIN ACP GENERATED CONTENT - DO NOT EDIT -->
[generated primer content]
<!-- END ACP GENERATED CONTENT -->

# Install knowledge store
acp knowledge install
 
# Query ACP documentation
acp knowledge "how do I check constraints"

# Core only
npm install -g @acp-protocol/cli
 
# With semantic search
npm install -g @acp-protocol/cli @acp-protocol/knowledge
# OR
acp knowledge install

{
  "id": "acp-self-expand",
  "template": "For more context: `acp primer --budget N` or `acp knowledge \"question\"`"
}

# Initialize project (includes sync)
acp init
 
# Files created:
# - .acp.config.json
# - .acp/acp.cache.json
# - .acp/acp.vars.json
# - .cursorrules (if Cursor detected)
# - CLAUDE.md (if Claude Code detected)
# - AGENTS.md (always)
 
# User opens any AI tool - context is already there

# Safety-focused for security-critical project
acp sync --primer-preset safe
 
# Or configure in .acp/acp.sync.json
{
  "primer": {
    "weights": { "safety": 3.0, "efficiency": 0.5 }
  }
}

# Compare what different budgets include
acp primer --compare 250,500,1000,2000
 
# Preview specific budget
acp primer --budget 500 --preview --tool cursor