ACP Steering System

Generates AI steering guidance from codebases to help agents discover and use correct abstractions.

repomap.py — Analyzes a codebase and generates:

1. Repository structure map (for context)
2. Steering guidance (when/why/how to use abstractions)
3. API documentation (function signatures, parameters, types)

acp_steering_mcp.py — MCP server exposing three tools:

• query_steering — Get when/why/how guidance
• query_api_docs — Get function signatures and docs
• list_repos — List available repositories

Requires Python 3.10+ and uv.

make install
source .venv/bin/activate

repomap /path/to/repo --repo-name <name>

This writes steering content to ~/.acp/repos/<name>/. Use --output <path> to override.

acp-steering-mcp

The server indexes all repos under ~/.acp/repos/.

Add to your MCP client settings (Claude Desktop, Claude Code, etc.):

{
  "mcpServers": {
    "acp-steering": {
      "command": "/path/to/steering/.venv/bin/acp-steering-mcp"
    }
  }
}

Or use make deploy which prints the config for you:

make deploy REPO=platform PATH_TO_REPO=~/repos/platform

Re-run repomap after code changes:

repomap /path/to/repo --repo-name <name>

• Python: Full (AST-based, types, docstrings)
• TypeScript/JavaScript: Basic (tree-sitter)
• Go: Basic (tree-sitter)
• Bash: Basic (tree-sitter)

• mcp >= 1.26.0 (FastMCP)
• pydantic >= 2.0.0
• tree-sitter >= 0.25.0
• Language grammars: tree-sitter-python, tree-sitter-javascript, tree-sitter-typescript, tree-sitter-go, tree-sitter-bash

• Python gets full analysis (AST-based)
• Other languages get basic symbol extraction (tree-sitter)
• Steering files are auto-generated but can be manually edited
• MCP server uses keyword search (semantic search possible future enhancement)
• Generated content follows structured format for agent consumption