tking/guildhouse-mcp
SHA256
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
guildhouse-mcp/CLAUDE.md
Tyler King dffa821c38 feat: Guildhouse MCP server + multi-agent governed dev pipeline 
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>
2026-04-06 03:24:01 -04:00

1.3 KiB
Raw Blame History

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

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