convez.ai
AgenteDevOps & InfraestruturaIntermediário
graycyrus

Claude Sentry Workflow

graycyrus/claude-sentry-workflow

Triagem de bugs Sentry → análise → issues GitHub em workflow automático

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent 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-workflow

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

SkillWhat it does
/brb-sentry-workflowFull orchestrator — Sentry fetch to GitHub issue
/brb-sentry-triageCategorize issues (code-bug vs infra/network), group by root cause, deduplicate, score priority — nothing dropped
/brb-sentry-analyzeDeep-dive into a bug — map to source, identify root cause, assess complexity
/brb-sentry-raise-issueCreate a well-structured GitHub issue with full Sentry context
/brb-sentry-updatePull 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:

  1. Copy — Global (~/.claude/skills/) — works everywhere, update via /brb-sentry-update
  2. Copy — Project (.claude/skills/) — per-project, update via /brb-sentry-update
  3. 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:

  1. Fetch — Pull unresolved Sentry issues via MCP tools
  2. Triage — Categorize issues (code-bug vs infra/network) using pattern matching — nothing dropped
  3. Group — Combine related issues sharing the same root cause
  4. Deduplicate — Filter out bugs that already have GitHub issues
  5. Score — Rank by Events x Blast Radius
  6. Analyze — Deep-dive into source code, identify root cause
  7. 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:infra and 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/:

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

Ver o original no GitHub

Bom para

Relacionados