x-bug-triage-plugin
X Bug Triage Plugin
Closed-loop bug triage pipeline for Claude Code: public X/Twitter complaints → structured bug candidates → clustered families → repo evidence → owner routing → terminal review → filed GitHub issues → future evidence auto-attaches.
Quick Start
bun install
bun run db:migrate
bun test
# In Claude Code terminal:
/x-bug-triage @AnthropicAI --window 24h
# Claude fetches, analyzes, clusters, displays results.
# You interact directly:
> details 1
> file 2
> dismiss 3 noise
> confirm file 2
That’s it. No Slack, no extra setup — just an X API token and bun install.
Architecture
flowchart LR
X[X API v2] --> I[Intake<br/>6 tools]
I --> N[Normalize<br/>parse, classify,<br/>redact, score]
N --> C[Cluster<br/>family-first,<br/>signature match]
C --> R[Repo Scan<br/>4 tools,<br/>Tier 1-4]
R --> O[Route<br/>5 tools,<br/>6-level]
O --> S[Severity<br/>escalation<br/>triggers]
S --> T[Terminal<br/>display]
T --> Rev[Review<br/>11 commands]
Rev --> D[Issue Draft<br/>3 tools,<br/>confirm gate]
D --> GH[GitHub<br/>Issues]
T -.->|optional| Sl[Slack<br/>peer plugin]
style X fill:#1da1f2,color:#fff
style T fill:#c4a5de,color:#000
style GH fill:#238636,color:#fff
style Sl fill:#4a154b,color:#fff,stroke-dasharray: 5 5
1 MCP server (triage) with 19 tools, orchestrated by a single SKILL.md playbook:
| Tool Group | Tools | Purpose |
|---|---|---|
| X Intake | 6 | X API v2 ingestion (mentions, search, conversations, quotes) |
| Repo Analysis | 4 | GitHub repo evidence scanning (issues, commits, paths, deploys) |
| Internal Routing | 5 | Ownership lookup with 6-level precedence |
| Issue Draft | 3 | Draft generation with confirmation gate and duplicate check |
| Review | 1 | Deterministic review command parsing |
Slack (Optional)
If you have the claude-code-slack-channel plugin installed, triage results are also delivered to Slack for async team review. Slack is a peer plugin — not bundled, not required.
See 000-docs/004-AT-REFF-slack-review-flow.md for the optional team workflow.
Project Structure
mcp/triage-server/ # Single MCP server (19 tools: server.ts + lib.ts)
lib/ # Shared library (types, db, config, audit)
db/ # SQLite schema and migrations
config/ # 8 operational config files
skills/x-bug-triage/ # Orchestration skill and policy references
agents/ # 4 subagent definitions
data/ # Runtime data (SQLite DB, reports, audit logs)
tests/fixtures/ # Mock API responses for deterministic testing
000-docs/ # Durable project documentation
License
Intent Solutions Proprietary — see LICENSE.