Skip to content

AGENT_PACKS.md

Latest commit

 

History

History
90 lines (72 loc) · 5.4 KB

AGENT_PACKS.md

File metadata and controls

90 lines (72 loc) · 5.4 KB
Raw

CAM Agent Packs

CAM Agent Packs make CAM usable from Claude Code, Gemini, and Grok Build without creating separate product forks.

Ownership

  • CAM_Codx owns this hub documentation, the generator, tests, and generated packs.
  • CAM_CAM owns runtime behavior, MCP tools, CLI commands, and local databases.
  • Host packs contain instructions and configuration examples only.

Architecture

CAM_CAM runtime/MCP/CLI
        |
        v
CAM_Codx shared capability contract
        |
        +--> agent-packs/claude-code
        +--> agent-packs/gemini
        +--> agent-packs/grok-build

Capability Summary

Capability Surface Tools Default Approval Safety
premine cli cam premine allow no read_only_remote
query_memory mcp claw_query_memory allow no read_only_local
store_finding mcp claw_store_finding deny yes local_mutation
verify_claim mcp claw_verify_claim allow no read_only_local
request_specialist mcp claw_request_specialist allow no routing_read_only
route_agent mcp_alias claw_request_specialist allow no routing_read_only
escalate mcp claw_escalate allow no local_mutation
decompose_task mcp claw_decompose_task allow no planning_read_only
build_application_packet mcp claw_build_application_packet allow no planning_local_read
get_run_connectome mcp claw_get_run_connectome allow no read_only_local
trace_failure mcp claw_trace_failure allow no read_only_local
promote_recipe mcp claw_promote_recipe deny yes local_mutation
queue_mining_mission mcp claw_queue_mining_mission deny yes local_mutation
request_specialist_packet mcp claw_request_specialist_packet allow no routing_read_only
export_specialist_exchange mcp claw_export_specialist_exchange deny yes local_mutation
import_specialist_exchange mcp claw_import_specialist_exchange deny yes local_mutation
list_specialist_exchanges mcp claw_list_specialist_exchanges allow no read_only_local
bridge_specialist_exchange mcp claw_bridge_specialist_exchange deny yes external_tool_call
submit_specialist_webhook mcp claw_submit_specialist_webhook deny yes external_network_mutation

Host Packs

Pack Use When Primary Setup Smoke Test
agent-packs/claude-code Claude Code should use CAM from a project. Project .mcp.json with local stdio. agent-packs/claude-code/smoke.sh
agent-packs/gemini Gemini CLI/API workflows should use CAM. Gemini settings.json for CLI; Remote MCP only after current API support is confirmed. agent-packs/gemini/smoke.sh
agent-packs/grok-build Grok Build should use CAM in TUI/headless/API flows. .grok/config.toml, AGENTS.md, skills, and optional hooks. agent-packs/grok-build/smoke.sh

Uniform Setup And Test Flow

Each pack follows the same order:

  1. Copy the pack files into the target project.
  2. Copy or merge the host MCP config example.
  3. Replace local CAM_CAM placeholders outside Git.
  4. Run host discovery commands.
  5. Run ./smoke.sh only after host credentials and CAM paths are configured.
  6. Record the discovery and smoke results before claiming the pack is verified.

Source Docs Checked

Source Checked URL Note
Claude Code MCP 2026-06-23 https://code.claude.com/docs/en/mcp Claude Code supports project .mcp.json files, local stdio servers, remote HTTP servers, deprecated SSE, WebSocket, plugins, and /mcp status checks.
Gemini API coding agents 2026-06-23 https://ai.google.dev/gemini-api/docs/coding-agents Google recommends Gemini Docs MCP plus Gemini API Skills for coding assistants.
Gemini CLI 2026-06-23 https://developers.google.com/gemini-code-assist/docs/gemini-cli Gemini CLI uses local or remote MCP servers and exposes /mcp in supported Gemini Code Assist surfaces.
Gemini Remote MCP 2026-06-23 https://ai.google.dev/gemini-api/docs/function-calling#remote_mcp_model_context_protocol Remote MCP support must be rechecked for transport and model constraints before API claims are finalized.
Gemini CLI MCP configuration 2026-06-23 https://geminicli.com/docs/tools/mcp-server/ Gemini CLI settings.json uses mcpServers and supports stdio, SSE, and Streamable HTTP transports.
Grok Build 2026-06-23 https://docs.x.ai/build/overview Grok Build supports TUI use, headless mode, config inspection, and API use of grok-build-0.1.
Grok Build skills/plugins/hooks 2026-06-23 https://docs.x.ai/build/features/skills-plugins-marketplaces Grok discovers skills, plugins, hooks, MCP servers, AGENTS.md, and Claude Code compatibility files.
xAI Remote MCP 2026-06-23 https://docs.x.ai/developers/tools/remote-mcp xAI Remote MCP supports Streaming HTTP and SSE remote transports with allowed tool filtering and authorization headers.

Maintenance

Run these after editing the contract or templates:

python tools/generate_agent_packs.py
python tools/generate_agent_packs.py --check
python -m pytest -q tests/test_agent_packs.py