Claude Sentry Workflow
graycyrus/claude-sentry-workflow
Triagem de bugs Sentry → análise → issues GitHub em workflow automático
Ver no GitHubAgent para triagem automática de bugs do Sentry com orquestração estruturada. Busca erros, classifica (código vs infraestrutura), analisa causas raiz e cria issues no GitHub — tudo integrado ao Claude Code.
Instalação
npx convez-ai graycyrus/claude-sentry-workflow1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Triagem contínua de erros do Sentry sem intervenção manual
- Classificação automática de bugs (código vs infra/rede) com deduplicação
- Criação estruturada de GitHub issues com contexto Sentry completo
- Priorização inteligente de bugs por impacto e complexidade
Veredito

Ferramenta sólida para equipes que usam Sentry + GitHub. Automatiza triagem repetitiva e integra bem no fluxo Claude Code, mas exige Sentry MCP tools e CLI configurados. Reduz overhead operacional significativamente.
README
A tradução para o português deste README ainda está na fila.
claude-sentry-workflow
AI-assisted Sentry bug triage workflow for Claude Code. Fetch errors from Sentry, categorize them (code-bug vs infra/network), analyze root causes, and raise well-structured GitHub issues for every issue — all with structured agent orchestration.
Companion to claude-workflow. That workflow picks up GitHub issues and ships PRs. This one creates those issues from Sentry errors.
What is this?
A set of Claude Code skills (slash commands) that give Claude a structured process for triaging Sentry bugs:
Workflow skills
| Skill | What it does |
|---|---|
/brb-sentry-workflow | Full orchestrator — Sentry fetch to GitHub issue |
/brb-sentry-triage | Categorize issues (code-bug vs infra/network), group by root cause, deduplicate, score priority — nothing dropped |
/brb-sentry-analyze | Deep-dive into a bug — map to source, identify root cause, assess complexity |
/brb-sentry-raise-issue | Create a well-structured GitHub issue with full Sentry context |
/brb-sentry-update | Pull latest skills from GitHub and update your install |
Prerequisites
- Claude Code CLI installed
- GitHub CLI (
gh) installed and authenticated - Sentry MCP tools configured in Claude Code (provides
find_organizations,find_projects,search_issues,search_issue_events)
Install
Option A: Interactive installer
bash <(curl -fsSL https://raw.githubusercontent.com/graycyrus/claude-sentry-workflow/main/install.sh)
Choose between:
- Copy — Global (
~/.claude/skills/) — works everywhere, update via/brb-sentry-update - Copy — Project (
.claude/skills/) — per-project, update via/brb-sentry-update - Symlink — Global — clones to
~/.claude/claude-sentry-workflow/, symlinks skills.git pull= instant updates.
Option B: One-liner (global copy, non-interactive)
curl -fsSL https://raw.githubusercontent.com/graycyrus/claude-sentry-workflow/main/install.sh | bash
Option C: Manual
git clone https://github.com/graycyrus/claude-sentry-workflow.git /tmp/claude-sentry-workflow
mkdir -p ~/.claude/skills
cp -r /tmp/claude-sentry-workflow/skills/* ~/.claude/skills/
rm -rf /tmp/claude-sentry-workflow
Usage
# Full workflow — fetches from Sentry, triages, analyzes, raises issues
/brb-sentry-workflow
# Full workflow for a specific Sentry project
/brb-sentry-workflow openhuman-tauri
# Individual steps
/brb-sentry-triage
/brb-sentry-analyze ISSUE-ID-123
/brb-sentry-raise-issue
Typical session
You: /brb-sentry-workflow
Claude: [connects to Sentry, finds org]
"I found 4 projects. Which one(s) should I pull issues from?"
You: openhuman-tauri and openhuman-react
Claude: "Should I show only issues assigned to you, or all unresolved?"
You: all
Claude: [fetches 47 unresolved issues]
[categorizes: 31 infra, 16 code-bugs — all carried forward]
[groups into 9 root causes]
[checks GitHub — 3 already have issues]
[scores remaining 6]
"Here are the bugs ranked by priority:
CRITICAL
| # | Issues | Error | Events |
|---|--------|-------|--------|
| 1 | BM, BK, BJ | Config TOML parse — blocks boot | 320+ |
HIGH
| # | Issues | Error | Events |
|---|--------|-------|--------|
| 2 | 20 | unknown param 'api_key' | 57 |
Proceed with analysis?"
You: yes
Claude: [reads Sentry events, maps to source code]
[identifies root cause, traces cascade]
[creates GitHub issue with full context]
"Created: fix(config): handle corrupted TOML — #234"
How it works
The workflow follows a structured pipeline:
- Fetch — Pull unresolved Sentry issues via MCP tools
- Triage — Categorize issues (code-bug vs infra/network) using pattern matching — nothing dropped
- Group — Combine related issues sharing the same root cause
- Deduplicate — Filter out bugs that already have GitHub issues
- Score — Rank by Events x Blast Radius
- Analyze — Deep-dive into source code, identify root cause
- Raise — Create GitHub issues with full context, scrubbed of sensitive data
Philosophy
- Ask before fetching. Always ask which project and assignee filter.
- Categorize, don't drop. Many Sentry issues are infrastructure/network — they're tagged
category:infraand raised like any other bug, not filtered out. Category informs priority, never discards. - One issue per root cause. Group related Sentry issues — don't create duplicates.
- Deduplicate against GitHub. Check existing issues before creating new ones.
- Scrub sensitive data. No tokens, PII, or internal URLs in public issue bodies.
- Read-only on Sentry. Never resolve, archive, or update Sentry issue status.
- Stop at issue creation. This workflow creates issues. Use claude-workflow to fix them.
Updating
If you installed via copy
Run /brb-sentry-update inside Claude Code.
If you installed via symlink
cd ~/.claude/claude-sentry-workflow && git pull
Docs
Detailed reference docs in docs/:
- Full workflow — complete step-by-step
- Triage — category patterns, priority scoring
- Analysis — root cause investigation
- Raising issues — issue format, labels, sensitive data
Uninstall
# Global
rm -rf ~/.claude/skills/brb-sentry-{workflow,triage,analyze,raise-issue,update}
# Per-project
rm -rf .claude/skills/brb-sentry-{workflow,triage,analyze,raise-issue,update}
# If symlink install, also remove the cloned repo
rm -rf ~/.claude/claude-sentry-workflow
Contributing
See CONTRIBUTING.md. PRs welcome.
License
MIT