AI Design Blueprint Doctrine

Integrações do AI Design Blueprint

Integrações oficiais e doutrina instalável para o AI Design Blueprint em MCP, regras de IDE, arquivos de prompt e runtimes de agente.

O que há neste repositório

• shared/: arquivos de doutrina entre ferramentas
• mcp/: configuração pública do MCP e notas de uso
• docs/setup/: guias de configuração por ferramenta, priorizando cópia
• cursor/, windsurf/, github-copilot/, gemini/: arquivos de instrução específicos por provedor
• open-weights/: pacotes de prompt estáticos para fluxos de trabalho com modelos de peso aberto e locais
• exports/: exportação estruturada da doutrina

Contrato público

Endpoints públicos canônicos:

• Site: https://aidesignblueprint.com
• MCP: https://aidesignblueprint.com/mcp
• Documentação para desenvolvedores: https://aidesignblueprint.com/en/for-agents

Início rápido

1. Escolha um guia de configuração em docs/setup/.
2. Adicione o arquivo relevante ou a configuração do MCP ao seu próprio repositório ou cliente.
3. Se estiver usando MCP, inicialize contra https://aidesignblueprint.com/mcp.
4. Execute a primeira chamada de prova:
   • clusters.list()
5. Em seguida, execute uma segunda chamada de prova:
   • examples.search(query="orchestration visibility steering", limit=3)

Ferramentas públicas do MCP

Ferramentas públicas de recuperação (permitidas para anônimos, somente leitura)

• principles.list(cluster?)
• clusters.list()
• principles.get(slug)
• clusters.get(slug)
• examples.get(slug)
• principles.search(query, limit?)
• examples.search(query, principle_ids?, difficulty?, library?, limit?)
• assets.list()
• guides.list()
• guides.get(slug)
• guides.search(query, limit?)

Ferramentas públicas de sinal (permitidas para anônimos, gravação opcional)

• signals.report(event_type, surface_used?, brief_context?, perceived_value?, workflow_stage?, would_recommend?, team_size?) — registra um momento de valor; ofereça somente após o usuário expressar claramente que algo foi útil; nunca chame automaticamente ou silenciosamente
• signals.feedback(task_type?, surface?, rating_clarity?, rating_usefulness?, what_helped?, what_missing?, would_use_again?, contact_email?, permission_to_follow_up?) — feedback qualitativo explícito; chame somente quando o usuário pedir explicitamente para deixar feedback

As ferramentas de sinal gravam apenas os campos estruturados que você passar. Nenhum prompt, código ou conteúdo de arquivo é armazenado. Consulte a política de privacidade para detalhes completos sobre o tratamento de dados.

Ferramentas protegidas (autenticadas, fora do caminho de configuração anônima)

• me.learning_path()
• me.coaching_context()
• architect.validate(implementation_context, ..., private_session?) — Pro/Teams; avalia código agêntico segundo os 10 princípios; defina private_session=true para pular a execução armazenada nessa chamada
• design.validate(implementation_context, ..., private_session?) — Pro/Teams; o espelho de superfície: avalia um artefato de frontend renderizado segundo as 8 leis de design de experiência (cota semanal própria)
• spec.validate(implementation_context, ..., private_session?) — Pro/Teams; a lente do que construir: avalia uma especificação escrita segundo as 8 leis de qualidade de especificação (cota semanal própria)
• team.summarize(days_back?, private_session?) — Pro/Teams; reflexão de uso e próximos ativos recomendados nas três lentes de validação
• me.add_evidence(course_slug, stage_id, note)

Regras de feedback e sinal de valor

• Chame signals.report somente depois que o usuário expressar claramente que algo foi útil. Nunca chame automaticamente ou silenciosamente. Ofereça no máximo uma vez por sessão após um sinal claro de sucesso.
• Chame signals.feedback somente quando o usuário pedir explicitamente para deixar feedback. Nunca solicite proativamente.
• Nunca inclua código proprietário, conteúdo de arquivos ou segredos em brief_context.

Selos de governança

Mostre que seu agente ou repositório segue a doutrina do Blueprint.

Selos gratuito — cole no seu README.md (nenhuma conta necessária):

[![AI Design Blueprint](https://aidesignblueprint.com/api/badge/free.svg)](https://aidesignblueprint.com)

Selos Pro — execute architect.validate() via MCP. A resposta inclui run_id, badge_url e review_url:

[![AI Design Blueprint](https://aidesignblueprint.com/api/badge/run/<run_id>.svg)](https://aidesignblueprint.com/en/readiness-review/<run_id>)

O selo Pro exibe seu nível (Governed · X/Y ou Reviewed · X/Y) e vincula a uma página pública de revisão de prontidão. Requer uma conta Pro ou Beta.

O que ainda não está aqui intencionalmente

• nenhum esquema OpenAPI público
• nenhum contrato de API HTTP público além do MCP e ativos estáticos
• nenhum instalador de CLI
• nenhuma distribuição especulativa específica de parceiros

Fonte da verdade

Este repositório tem a intenção de espelhar o contrato público canônico já publicado em aidesignblueprint.com.

Antes de publicar alterações aqui, verifique se:

• /mcp
• /llms.txt
• /agent-assets/[slug]
• /en/for-agents

permanecem consistentes com os arquivos confirmados neste repositório.