Skip to content

docs: agent guide — MCP API reference, Claude skill, APG tuning - #4

Open
fr0zenK wants to merge 1 commit into
nullmastermind:masterfrom
fr0zenK:docs/agent-guide
Open

fr0zenK wants to merge 1 commit into
nullmastermind:masterfrom
fr0zenK:docs/agent-guide

Conversation

@fr0zenK

@fr0zenK fr0zenK commented Oct 16, 2026

Copy link
Copy Markdown

Agents (Claude Code etc.) struggle to use the MCP tools correctly: wrong workspace paths, misread degrade messages, blind APG turn increases. This adds a tested agent-facing guide.

Contents

  • docs/MCP-API.md — transports + handshake (Streamable HTTP/SSE), the 2 MCP tools with schemas, workspace rules, full degrade table with actions, REST endpoints
  • .claude/skills/context-engine/SKILL.md — query SOP, APG when/how-much presets, live config for Claude Code agents
  • docs/AGENTIC-RAG.md — loop mechanics (query/add_chunks/grep/read budgets, guardrails), OFF-baseline evidence (lookup: OFF suffices; explore: ON-5 best recall; ON-9 can drop chunks), benchmark protocol (server timing, warm-up discard, median reps), cut diagnosis (LoopExit vs 300s abort)
  • scripts/ce-tune.sh + scripts/ce-benchmark.sh — live APG tune (no restart) + off/turns benchmark matrix with auto-restore

Verification

  • API surface verified live against v0.1.66 (tools/list, /api/repos, /api/query timing) + source (mcp.rs, reranker.rs, readiness.rs, query_gate.rs)
  • Benchmark evidence measured on a mid-size Rust repo; scripts syntax-checked, benchmark auto-restores config
  • Docs-only + scripts; no engine code touched

- docs/MCP-API.md: transports/handshake, 2 MCP tools, workspace rules,
  degrade table, REST endpoints
- .claude/skills/context-engine/SKILL.md: query SOP, APG presets,
  live config for Claude Code agents
- docs/AGENTIC-RAG.md: loop mechanics, OFF-baseline evidence, benchmark
  protocol, cut diagnosis (LoopExit vs 300s abort)
- scripts/ce-tune.sh + ce-benchmark.sh: live APG tune + benchmark matrix,
  auto-restore config
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant