ag-analisar-contexto

Analyze code patterns and tech debt to produce P0-P3 prioritized findings.

19|4|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/andregusman-raiz/a-gusman-claude --skill ag-analisar-contexto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ag-analisar-contexto
Source: https://github.com/andregusman-raiz/a-gusman-claude/tree/main/skills/ag-analisar-contexto
Command: npx skills add https://github.com/andregusman-raiz/a-gusman-claude --skill ag-analisar-contexto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This capability helps engineering teams quickly identify code quality issues, tech debt, and architectural risks within a codebase, providing prioritized diagnostics to guide remediation and planning.

Core Features & Use Cases

  • Spawn an autonomous ag-analisar-contexto agent to diagnose code patterns, tech debt indicators, and architectural risks.
  • Generate findings with priorities P0-P3 and save them incrementally to docs/ai-state/findings.md; produce an inventory of tech debt such as TODOs, usage of any, magic numbers, duplication, and outdated dependencies; flag architectural risks like single points of failure, circular dependencies, and security gaps.
  • Escalate critical P0 debt to GitHub Issues via ag-registrar-issue for rapid remediation; support best-effort follow-ups with integration prompts.

Quick Start

Spawn the ag-analisar-contexto agent to analyze your project and generate a prioritized findings report.

Frequently Asked Questions about ag-analisar-contexto

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify tech debt and architectural risks in my codebase?

To identify tech debt and architectural risks, analyze code patterns like TODOs, magic numbers, and circular dependencies to generate a prioritized P0-P3 findings report. This process produces an inventory of debt items saved incrementally to guide remediation.

What is the best way to prioritize code quality issues for remediation?

The best way to prioritize code quality issues is generating a P0-P3 prioritized findings report that flags critical debt, single points of failure, and security gaps. This allows teams to systematically escalate and address the most severe architectural risks first.

How do I track code diagnostics findings incrementally during development?

You track code diagnostics findings incrementally by building a concise findings document at docs/ai-state/findings.md. This captures an inventory of tech debt items and architectural risks as they are discovered throughout the project lifecycle.

Can I automatically escalate critical code debt to GitHub issues?

Yes, you can escalate critical P0 tech debt to GitHub issues via the ag-registrar-issue integration. This automatically creates tickets for severe architectural risks and code quality issues to ensure rapid remediation by the engineering team.

Does codebase analysis work for projects of varying sizes and languages?

Yes, codebase analysis applies to projects of varying sizes and languages. It uniformly detects tech debt indicators like magic numbers, coupling, and test coverage gaps across different codebases to produce consistent architectural risk assessments.