aptratcn/cognitive-debt-guard

O que cognitive-debt-guard faz?

Guardião da Dívida Cognitiva - Evite o pico de incidentes de 23,5% gerado por código de IA. Portões de compreensão, estruturas de revisão, zonas livres de IA.

---

Por que isso é importante?

Embora a IA acelere a codificação, ela também pode introduzir dívida cognitiva - código que funciona, mas não é totalmente compreendido pela equipe. Isso leva a um aumento de incidentes. O Cognitive Debt Guard ajuda a prevenir isso com:

• Portões de compreensão: Antes de mesclar código gerado por IA, um desenvolvedor deve explicá-lo em seus próprios termos.
• Estruturas de revisão: Listas de verificação especificamente para revisar código de IA, focando em armadilhas comuns.
• Zonas livres de IA: Partes críticas do código que não podem ser geradas por IA.

---

Como usar

1. Instale a skill: Adicione aptratcn/cognitive-debt-guard ao seu arquivo de configuração do agente.
2. Ative os portões: Configure a skill para exigir explicação do código antes da mesclagem.
3. Defina zonas: Marque arquivos ou diretórios como zonas livres de IA.
4. Revise com estrutura: Use as listas de verificação fornecidas durante as revisões de código.

---

Compatibilidade

• Claude Code
• Cursor
• Codex
• Outros agentes de IA que suportam skills

---

Exemplo de configuração

skills:
  - name: aptratcn/cognitive-debt-guard
    config:
      comprehension_gates: true
      ai_free_zones:
        - "src/core/auth"
        - "src/crypto"
      review_framework: "strict"

---

Licença

MIT