Communitygithub.com

ProdaZhang/aidd

Idealize o design de uma funcionalidade com uma IA; entregue o pacote verificado e agnóstico de plataforma para outra IA construir. Jogos ou aplicativos — uma habilidade, verificadores determinísticos.

O que é aidd?

AIDD (AI-assisted Design→Dev) é uma habilidade de IA especializada em transformar discussões de design em pacotes de handoff agnósticos de plataforma, prontos para outra IA ou pessoa desenvolver diretamente. O processo é rigorosamente verificado por meio de verificadores determinísticos (checkers) que garantem que não haja problemas críticos antes da entrega. A habilidade é neutra em relação ao domínio, podendo ser usada para projetar desde sistemas de jogos até funcionalidades SaaS (planos, cotas, permissões, feature flags, formulários, onboarding). Suporta plataformas como Claude Code, Cursor e Codex, operando com uma única skill que lê a espinha dorsal do projeto (project-charter + manifest), julga o progresso e roteia para a fase correta do playbook. Inclui referências detalhadas, scripts de verificação em Python puro e exemplos prontos para uso. O pacote não decide as escolhas técnicas (stack) — esse passo fica a cargo da implementação downstream.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add ProdaZhang/aidd

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação


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)

  1. A espinha existe? (project-charter + manifest) — Não → comece na fase de conceito para construí-la. Sim → leia ambas.
  2. Quais sistemas ainda não estão Final? Liste-os; pergunte qual avançar desta vez.
  3. Há sistemas Recheck? (um item compartilhado mudou) → resolva primeiro pela fase finalizar/sincronizar.
  4. 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 fazerLeia
Conceito: loop central / plataforma / usuários / dividir em sistemas / iniciar a espinhareferences/phases/concept.md
Projetar um sistema: regras (R-codes) + tabelas de config (dados de teste) + protótipo de UIreferences/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 espinhareferences/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 /10000 quando 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 em references/harness-adapt.md.
  • Após cada alteração, anexe ao ledger de alterações do projeto (CHANGELOG.md); inicialize a partir de references/templates/CHANGELOG.tpl.md se ausente.

Habilidades Relacionadas