Tyler King
dffa821c38
MCP server connecting Claude Code to the Guildhouse ecosystem. Tools (23): Forgejo: repos, files, branches, PRs, CI status Chronicle: events, epochs, verify, emit GSAP proxy: request_ac, check_operation, get_posture, delegate Capstone: agents, tenants Tasks: list, get, create, update_status, submit_for_review, submit_review Multi-agent topology: Lead Agent — plans work, delegates, reviews proposals Worker Agents — implement in parallel, submit PRs with confidence Reviewer Agent — QA's worker output, submits review confidence Confidence Gate — auto-merge/flag/propose/reject based on combined score Confidence thresholds (configurable): >= 85: auto-merge (no human needed) >= 70: flag-merge (merged, flagged for post-review) >= 50: proposal (Tyler reviews) < 50: reject (worker revises) Reviewer can override: 'reject' always rejects, 'request_changes' caps at propose. Task definitions (TOML) with phased prompts, success criteria, and delegation scopes. Every tool call emits Chronicle MCP_TOOL_CALL (0x3020). Every gate decision emits Chronicle events (0x4010-0x4013). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
34 lines
1.3 KiB
Markdown
34 lines
1.3 KiB
Markdown
# CLAUDE.md — Guildhouse MCP Server
|
|
|
|
## What is this?
|
|
|
|
MCP server connecting Claude Code to the Guildhouse ecosystem: Forgejo, Capstone, GSAP governance, Chronicle audit, and K8s/Flux.
|
|
|
|
## Structure
|
|
|
|
- `src/guildhouse_mcp/server.py` — FastMCP server with 25+ tools
|
|
- `src/guildhouse_mcp/tools/` — Backend implementations (forgejo, chronicle, capstone, gsap_proxy, tasks)
|
|
- `src/guildhouse_mcp/agents/` — Multi-agent orchestration (confidence gate, topology)
|
|
- `tasks/` — TOML task definitions with phased prompts
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
pip install -e ".[dev]"
|
|
python -m guildhouse_mcp # Run MCP server (stdio)
|
|
python -m pytest tests/ # Run tests
|
|
```
|
|
|
|
## Key Concepts
|
|
|
|
- **Confidence gate**: Combined worker (40%) + reviewer (60%) score decides auto-merge/flag/propose/reject
|
|
- **Chronicle recording**: Every tool call emits MCP_TOOL_CALL (0x3020) event
|
|
- **GSAP proxy**: Forwards governance tool calls to existing GSAP MCP broker
|
|
- **Task definitions**: TOML files with phases, success criteria, delegation scopes
|
|
|
|
## Thresholds (configurable via env)
|
|
|
|
- `GUILDHOUSE_AUTO_MERGE_THRESHOLD=85` — No human needed
|
|
- `GUILDHOUSE_FLAG_MERGE_THRESHOLD=70` — Merged, flagged for post-review
|
|
- `GUILDHOUSE_PROPOSAL_THRESHOLD=50` — Tyler reviews
|
|
- Below 50 — Rejected, worker revises
|