name: aidd description: AIDD (AI-assisted Design→Dev) — transforme uma discussão de design em um pacote de handoff agnóstico de plataforma que outra IA pode construir, verificado por verificadores determinísticos. Use para projetar qualquer sistema com muita configuração/regras/UI do zero — sistemas de jogos, funcionalidades de aplicativos e SaaS (planos, cotas, permissões, feature flags, formulários, onboarding), ferramentas — ou para avançar/sincronizar a espinha dorsal do projeto. Uma habilidade: ela lê a espinha, julga o progresso e roteia você para o playbook da fase correta em references/. Neutra em domínio; acompanhada de references/.
AIDD · orquestrador (uma habilidade)
AIDD = AI-assisted Design→Dev. Transforme uma discussão de design em um pacote de handoff agnóstico de plataforma — regras / config / contrato / aceitação / protótipo de UI / espinha — que outra IA (ou pessoa) pode desenvolver diretamente, com verificadores determinísticos garantindo que haja "0 problemas graves" antes do handoff. Neutro em domínio: o mesmo motor projeta um sistema de jogo ou uma funcionalidade de faturamento SaaS. A implementação (escolher uma pilha tecnológica para escrever o cliente/servidor) é posterior, não está neste pacote.
Esta é uma habilidade que cobre todo o pipeline. O playbook detalhado de cada fase está em
references/e é lido sob demanda — mantendo o contexto enxuto sem dividir em muitas habilidades.
Modelo central
- Duas camadas: ① a espinha dorsal do projeto ao vivo —
project-charter(conceito / plataforma / usuários-alvo / domínio / convenções de nomenclatura) +manifest(lista de sistemas + grafo de dependências + índice entre camadas + registro de faixas numéricas + ledger de congelamento), continuamente revisada; ② o loop de produção por sistema. - Fonte única da verdade centralizada: enums / numerações / contratos / tabelas de config vivem na camada do projeto; a prosa os referencia por nome, independente de posição (
table[key].field/screenID.elementID/R-code) — nunca embutir um número puro em linha. - Cada operação: ler a espinha → fazer o trabalho → escrever de volta na espinha.
- Método canônico:
references/methodology.md. Armadilhas:references/gotchas.md. Especificidades por ambiente:references/harness-adapt.md.
Na entrada — auto-verificação, então roteie (proativamente avance)
- A espinha existe? (
project-charter+manifest) — Não → comece na fase de conceito para construí-la. Sim → leia ambas. - Quais sistemas ainda não estão
Final? Liste-os; pergunte qual avançar desta vez. - Há sistemas
Recheck? (um item compartilhado mudou) → resolva primeiro pela fase finalizar/sincronizar. - Conflitos de faixas numéricas / ciclos de dependência? Verifique e relate.
Fases (leia o playbook correspondente, depois faça o trabalho)
| O que você quer fazer | Leia |
|---|---|
| Conceito: loop central / plataforma / usuários / dividir em sistemas / iniciar a espinha | references/phases/concept.md |
| Projetar um sistema: regras (R-codes) + tabelas de config (dados de teste) + protótipo de UI | references/methodology.md — Etapas 0–5, parte A |
| Iterar após um dry-run: ajustar regras / config / protótipo (barato, repetível) | references/methodology.md — re-executar parte A |
| Finalizar e fazer handoff: contrato + aceitação + (conforme necessário) backend + checklist; depois sincronizar a espinha | references/methodology.md parte B + references/handoff-checklist.md |
| Captura de tela de UI → DSL de UI (capturar uma tela de referência na base de conhecimento) | references/phases/ui-capture.md |
Caminho típico: conceito (uma vez) → por sistema { projetar → iterar… (repetir) → finalizar e fazer handoff } → sincronizar (contínuo). A ordenação não é obrigatória — roteie conforme a necessidade do trabalho. Uma re-divisão / reversão registra uma entrada no log de rollback no manifest e marca os sistemas downstream finalizados como
Recheck.
Verificadores determinísticos (o portão — execute antes do handoff)
references/scripts/ (Python puro, principalmente stdlib): config_check (config-spec ↔ drift da planilha xlsx) · value_check (FKs quebradas / cobertura / monotonicidade) · manifest_check (auto-consistência da espinha) · ref_graph --check (R-codes / referências pendentes) · gherkin_to_checklist · ui_render (UI-DSL → wireframe). 0 maior = pronto para handoff. Exemplo executável: references/examples/subscription-plans/.
Limite (o que não é)
- Gerencia estrutura e consistência, não julgamento de qualidade: os verificadores detectam links quebrados / cobertura / monotonicidade / desvio de esquema; eles não julgam se o design é bom (equilíbrio de jogo, UX, correção de negócios) — isso é para pessoas / ferramentas dedicadas.
- O protótipo HTML valida arquitetura da informação e fluxo, não sensação / tempo / rede. Bom para superfícies densas em UI (inventário, loja, configurações, painéis, onboarding); deixe a sensação em tempo real para um protótipo de engenharia.
- Não decide seus números / convenções: qualquer coisa não decidida é marcada como
[a confirmar]e entregue a uma pessoa. - Vai até um pacote de handoff; a escolha da pilha tecnológica e a implementação cliente/servidor = posteriores.
Pacote (uma pasta)
Instale a única pasta de habilidade aidd/ no diretório de habilidades do host (ex.: .claude/skills/ do Claude Code). Tudo — metodologia, verificadores, modelos, exemplos — é enviado sob aidd/references/. Pacotes de domínio (padrões de aplicativo / jogo + exemplos) são colocados em references/patterns/ + references/examples/.
Restrições rígidas (não viole)
- Os arquivos são UTF-8 sem BOM.
- Referencie por nome (independente de posição); por dez mil avos uniformemente
/10000quando usado. - Config centralizada: tabelas agrupadas globalmente, sem tabelas privadas por sistema; uma referência entre sistemas é uma referência comum, não uma aresta de dependência. Fontes compartilhadas do tipo broadcast (namespace de ID / enum / texto) são somente anexação, nunca quebrar.
- Chamadas de ferramenta devem usar o formato de chamada de função do seu ambiente ou podem falhar silenciosamente — verifique se o artefato realmente foi criado (read-file /
ls). Especificidades por ambiente emreferences/harness-adapt.md. - Após cada alteração, anexe ao ledger de alterações do projeto (
CHANGELOG.md); inicialize a partir dereferences/templates/CHANGELOG.tpl.mdse ausente.