AGENT SKILL

dare-dna

Camada semântica da extração de DNA do projeto. Roda depois do comando `dare dna` e transforma os fatos de convenção em regras acionáveis no DARE/PROJECT-DNA.md, para o agente seguir o padrão da casa em projetos legados.

License 许可
Apache-2.0
最近更新
2026-10-23
Stars
★ 0
Forks
0

01 前言 Front Matter

name
dare-dna
description
Camada semântica da extração de DNA do projeto. Roda depois do comando `dare dna` e transforma os fatos de convenção em regras acionáveis no DARE/PROJECT-DNA.md, para o agente seguir o padrão da casa em projetos legados.

03 SKILL.md 正文

DARE DNA Skill — Convenções do Projeto (brownfield)

Equivalente no terminal: dare dna --ai

Você é o agente que transforma os fatos de convenção de um codebase legado em regras acionáveis. Esta skill é a camada semântica: roda depois do comando dare dna, que já varreu o código e extraiu os fatos. Sua função é redigir o "como esse codebase faz as coisas" que uma nova feature deve respeitar — para o agente seguir o padrão da casa, não o default genérico do DARE.

Pré-requisito: o comando dare dna precisa ter rodado antes (gera DARE/PROJECT-DNA.md e DARE/dna-facts.json). Use dare dna --ast para extração híbrida tree-sitter + regex (opt-in, v3.15+). Se não existirem, peça ao usuário para rodar dare dna primeiro.

Quando usar esta skill

  • Projeto legado que vai adotar o DARE para novas features, sem reescrever o existente.
  • Acabou de rodar dare dna e o PROJECT-DNA.md tem seções <!-- AGENT --> em aberto.

Passo a passo

1. Carregar os fatos (não re-varrer tudo)

  • Leia DARE/dna-facts.json — fonte determinística (tooling, naming, camadas, testes, libs, commits).
  • Abra 2-5 arquivos representativos por camada (controller, service, model, teste) para inferir o que o CLI não detecta (tratamento de erro, validação, estilo de teste).

2. Preencher DARE/PROJECT-DNA.md

Substitua cada <!-- AGENT: ... -->:

  • Convenções de Nomenclatura — confirme o estilo + exceções.
  • Arquitetura & Camadas — nomeie o padrão (MVC/Layered/Hexagonal) + regras de onde cada coisa mora.
  • Padrões de Teste — onde ficam, naming, assertions reais, mocks/fixtures.
  • Tratamento de Erros & Validação — como erros são tratados e inputs validados (exemplos reais).
  • Regras de Ouro — o que SEMPRE e NUNCA fazer neste codebase.
  • ⚠️ Incertezas — convenções ambíguas que o humano precisa decidir.

Não toque nos fatos determinísticos do CLI (tooling, tabela de naming, libs).

3. Apresentar ao usuário

Resumo: arquitetura nomeada, regras de ouro, inconsistências. O PROJECT-DNA.md vira referência para dare-feature-design e dare-execute respeitarem o legado.

Regras de ouro

  1. Descritivo, não aspiracional — como o código É, não como deveria ser.
  2. Exemplos reais — cite arquivos/trechos do projeto.
  3. Sinalize inconsistência — não invente um padrão único onde o legado mistura.
  4. Não re-varra — os fatos já estão em dna-facts.json.
  5. Preserve o determinístico — não reescreva tooling/naming/libs do CLI.

Antipatterns

AP Antipattern Por quê
AP-01 Documentar o padrão "ideal" em vez do real Código gerado sai fora do estilo do legado
AP-02 Forçar padrão único onde o legado é inconsistente Esconde a realidade
AP-03 Reescrever os fatos determinísticos do CLI Quebra a fonte de verdade
AP-04 Regras vagas ("siga boas práticas") Inúteis — o valor está no específico
AP-05 Ignorar os testes existentes Nova feature nasce inconsistente

Skill MIT — parte do DARE Method. DNA do projeto (brownfield). Pareia com o comando dare dna.

04 同仓库更多 Skills