# Ag Analisar Contexto

> Analisa padroes de codigo, debitos tecnicos, riscos arquiteturais. Produz diagnostico com prioridades P0-P3. Use when analyzing code quality, tech debt, or architectural risks.

- **Type:** Skill
- **Install:** `agentstack add skill-andregusman-raiz-a-gusman-claude-ag-analisar-contexto`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [andregusman-raiz](https://agentstack.voostack.com/s/andregusman-raiz)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [andregusman-raiz](https://github.com/andregusman-raiz)
- **Source:** https://github.com/andregusman-raiz/a-gusman-claude/tree/main/skills/ag-analisar-contexto

## Install

```sh
agentstack add skill-andregusman-raiz-a-gusman-claude-ag-analisar-contexto
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ag-analisar-contexto — Analisar Contexto

Spawn the `ag-analisar-contexto` agent to diagnose code patterns, tech debt, and architectural risks.

## Invocation

Use the **Agent tool** with:
- `subagent_type`: `ag-analisar-contexto`
- `mode`: `auto`
- `run_in_background`: `true`
- `prompt`: Compose from template below + $ARGUMENTS

## Prompt Template

```
Projeto: [CWD or user-provided path]

Analisar o codebase produzindo diagnostico com prioridades P0-P3:
- Consistencia de padroes
- Debito tecnico (TODOs, any, magic numbers)
- Riscos arquiteturais (acoplamento, single points of failure)
- Cobertura de testes
- Seguranca superficial

Salvar incrementalmente em docs/ai-state/findings.md.
```

## Important
- ALWAYS spawn as Agent subagent — do NOT execute inline
- After spawning, confirm to the user that the agent is running in background
- Requires ag-explorar-codigo output (project-profile.json, codebase-map.md) for best results

## Output
- findings.md em docs/ai-state/ com prioridades P0-P3
- Inventario de tech debt: TODOs, tipos `any`, magic numbers, duplicacao, deps desatualizadas
- Riscos arquiteturais: single points of failure, dependencias circulares, gaps de seguranca

## Anti-Patterns
- NUNCA diagnosticar sem ler codigo — findings do ag-explorar-codigo sao ponto de partida, nao substituto
- NUNCA classificar tudo como P0 — se tudo e critico, nada e critico; usar P0-P3 rigorosamente
- NUNCA misturar diagnostico com prescricao — diagnostico e ag-analisar-contexto, solucao e ag-especificar-solucao

## Escalacao: Issues para Tech Debt P0

Findings P0 (blocking production) DEVEM ser registrados como GitHub Issues:

```
Agent({
  subagent_type: "ag-registrar-issue",
  name: "issue-registrar",
  model: "haiku",
  run_in_background: true,
  prompt: "Repo: [detectar]\nOrigem: ag-analisar-contexto\nSeveridade: P0-critical\nTitulo: [Tech Debt] descricao do problema\nContexto: [descricao completa, impacto, arquivos afetados, risco se nao resolvido]\nArquivos: [arquivos afetados]\nLabels: tech-debt"
})
```

- P0: SEMPRE criar issue (risco iminente)
- P1-P3: apenas documentar em findings.md

## Quality Gate
- [ ] Cada debt tem severidade (P0-P3)?
- [ ] Riscos de seguranca verificados?
- [ ] findings.md atualizado incrementalmente?
- [ ] Findings P0 registrados como GitHub Issues via ag-registrar-issue?

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [andregusman-raiz](https://github.com/andregusman-raiz)
- **Source:** [andregusman-raiz/a-gusman-claude](https://github.com/andregusman-raiz/a-gusman-claude)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-andregusman-raiz-a-gusman-claude-ag-analisar-contexto
- Seller: https://agentstack.voostack.com/s/andregusman-raiz
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.