Registro de Prompts
Todos os prompts que geraram ações efetivas no projeto são registrados em docs/userPrompts/ (padrão prompt-####-slug.md). Cada número na primeira coluna abre a página com o texto completo (prompt refinado e resultado), gerada em historico/registro-prompts/ a partir desses arquivos — sem depender de links externos ao site.
Antes de npm run dev ou npm run build, o script sync-user-prompts copia e prepara esse conteúdo para o Starlight.
Sessão 1 — Criação e Revisão do Framework
Seção intitulada “Sessão 1 — Criação e Revisão do Framework”| Prompt | Descrição | Tags |
|---|---|---|
| 0001 | Formatar documento principal em Markdown padrão | documentacao, markdown, formatacao |
| 0002 | Versionar projeto no Bitbucket | git, versionamento, bitbucket |
| 0003 | Crítica do documento pelo agente | documentacao, revisao, critica, framework |
| 0004 | Analisar e combinar crítica de IA externa (1ª) | revisao, critica, multi-ia, framework |
| 0005 | Analisar e incorporar crítica de IA externa (2ª) | revisao, critica, multi-ia, planejamento |
| 0006 | Analisar e incorporar crítica de IA externa (3ª) | revisao, critica, multi-ia, planejamento |
| 0007 | Aplicar revisão estrutural em branch próprio (v2.0) | git, branch, framework, v2 |
Sessão 2 — Infraestrutura de Agente e Documentação
Seção intitulada “Sessão 2 — Infraestrutura de Agente e Documentação”| Prompt | Descrição | Tags |
|---|---|---|
| 0008 | Criar skill de versionamento para o agente | skill, versionamento, git |
| 0009 | Commit dos arquivos da skill de versionamento | git, commit, versionamento |
| 0010 | Procedimento de registro automático de prompts | rule, documentacao, prompts, rastreabilidade |
| 0011 | Registrar prompts da sessão anterior com numeração correta | documentacao, prompts, rastreabilidade, retroativo |
Sessão 3 — Site Starlight e Estrutura de Artefatos
Seção intitulada “Sessão 3 — Site Starlight e Estrutura de Artefatos”| Prompt | Descrição | Tags |
|---|---|---|
| 0012 | Criar site de documentação estática com Starlight e tema gov.br | site, starlight, documentacao, govbr |
| 0013 | Criar script PowerShell showDocs.ps1 para iniciar o Starlight | scripts, starlight, powershell |
| 0014 | Mover showDocs.ps1 para a pasta scripts/ | scripts, refactor |
| 0015 | Planejar a estrutura completa de artefatos do monorepo SinergIA | artefatos, monorepo, framework, planejamento |
| 0016 | Implementar a estrutura de artefatos (Modo Essencial) com ~78 pastas e 60 READMEs | artefatos, monorepo, implementacao, esp, gti, imp, pdp |
Sessão 4 — Identidade, Conteúdo e Organização
Seção intitulada “Sessão 4 — Identidade, Conteúdo e Organização”| Prompt | Descrição | Tags |
|---|---|---|
| 0017 | Incluir tagline oficial e textos filosóficos do SinergIA em PT e EN | identidade, filosofia, tagline, bilíngue, site |
| 0018 | Dividir página “Introdução e Princípios” em 3 páginas independentes | site, starlight, refactor, framework |
| 0019 | Renomear pastas PV com nome completo, expandir siglas, v2.01 e autor Elias Cotrim | nomenclatura, siglas, versao, autor, artefatos |
Sessão 5 — Firebase Hosting, Vocabulário e Identidade Visual
Seção intitulada “Sessão 5 — Firebase Hosting, Vocabulário e Identidade Visual”| Prompt | Descrição | Tags |
|---|---|---|
| 0020 | Configurar Firebase Hosting para publicar a documentação Starlight | firebase, hosting, deploy, starlight |
| 0021 | Atualizar configuração com domínios reais do projeto Firebase | firebase, dominio, astro, configuracao |
| 0022 | Consultoria sobre alternativas ao termo “Pontos de Vista” e ao vocabulário “histórias” | framework, vocabulario, design, consultoria |
| 0023 | Gerar variantes do logo e extrair componentes UI das coletâneas para o Starlight | identidade-visual, logo, ui, imagens, design |
Sessão 6 — PVs individuais, Firebase, Identidade Visual e PV SIS
Seção intitulada “Sessão 6 — PVs individuais, Firebase, Identidade Visual e PV SIS”| Prompt | Descrição | Tags |
|---|---|---|
| 0024 | Criar extensão do framework para sistemas em sustentação — PV SIS com 7 artefatos | framework, legados, SIS, sustentacao, extensao |
Sessão 7 — Versionamento Beta
Seção intitulada “Sessão 7 — Versionamento Beta”| Prompt | Descrição | Tags |
|---|---|---|
| 0025 | Atualizar versão do framework para 0.90b (beta) — home, changelog, roadmap, introducao, artefatos | versao, beta, changelog, deploy, firebase |
Sessão 8 — Normas e Legislação de Referência
Seção intitulada “Sessão 8 — Normas e Legislação de Referência”| Prompt | Descrição | Tags |
|---|---|---|
| 0026 | Baixar 11 normas (Lei 14.133, LGPD, LAI, IN 94, Portaria 750, Decreto 10.947, PNSI, Gov Digital, PNCP, eMAG, TCU) e salvar como .md em \reference | referencia, normas, legislacao, lgpd, licitacoes, tcu, emag |
| 0027 | Criar 11 páginas Starlight para as normas, adicionar grupo “Normas e Legislação” no sidebar e publicar no Firebase | deploy, firebase, normas, starlight, sidebar, referencia |
Sessão 9 — Nomenclatura e Identidade Formal
Seção intitulada “Sessão 9 — Nomenclatura e Identidade Formal”| Prompt | Descrição | Tags |
|---|---|---|
| 0028 | Definir nomenclatura formal em duas camadas: “Framework SinergIA” como marca + “Framework de Desenvolvimento Assistido por IA” como subtítulo + descrição institucional como referencial operacional e de governança | nomenclatura, framework, identidade, terminologia, branding |
Sessão 10 — Imagens de Autoridade e Embeds na Documentação
Seção intitulada “Sessão 10 — Imagens de Autoridade e Embeds na Documentação”| Prompt | Descrição | Tags |
|---|---|---|
| 0029 | Renomear 15 novas imagens para padrão camelCase, registrar no README v3.00 (nova seção “Diagramas de Autoridade e Domínios”) e distribuir nas páginas: introducao, principios, estrutura, pv-gti, pv-gda e pv-esp | imagens, autoridade, dominios, embeds, documentacao, readme |
| 0030 | Escolher e aplicar favicon para o site: logo-sinergia-icon.png copiado para public/favicon.png, configurado na propriedade favicon do Starlight e apple-touch-icon no head | favicon, icone, navegador, starlight, identidade-visual |
| 0031 | Remover 8 imagens de componentes UI (ui-tags, ui-estados, ui-callouts, ui-progresso, ui-botoes, ui-formularios) de 5 páginas de PVs onde estavam inseridas sem conexão com o conteúdo | imagens, limpeza, ui-components, documentacao, pv |
Sessão 11 — Riscos e Limitações do Framework
Seção intitulada “Sessão 11 — Riscos e Limitações do Framework”| Prompt | Descrição | Tags |
|---|---|---|
| 0032 | Criar página framework/riscos.md com 4 grupos de risco (tecnológicos, governança, adoção e riscos do próprio framework incluindo burocracia), definir artefato GTI-RRM-0001, atualizar GTI, Introdução e Roadmap | riscos, governanca, framework, burocracia, transparencia, gti, rrm |
Sessão 12 — Alinhamento com AIE Gov.BR
Seção intitulada “Sessão 12 — Alinhamento com AIE Gov.BR”| Prompt | Descrição | Tags |
|---|---|---|
| 0033 | Alinhar o SinergIA ao Framework AIE Gov.BR: criar etica-ia.md com 6 princípios éticos, 4 níveis de risco ético e 5 gatilhos de risco excessivo; criar normas aie-autoavaliacao-ia.md e pl-2338-2023-marco-legal-ia.md; adicionar 10º princípio em principios.md, grupo “Riscos Éticos” em riscos.md, subseção Gov.BR em pv-gti.md, referência AIE em pv-pdp.md; definir artefato GTI-AIE-0001; atualizar sidebar | etica, aie, govbr, riscos, pl-2338, principios, gti, pdp, normas, alinhamento |
| 0034 | Aplicar o questionário AIE Gov.BR (Beta 2.39) ao próprio SinergIA como instrumento de governança de IA; criar artefato GTI-AIE-0001--autoavaliacao-impacto-etico.md; publicar resultado (Nível 4 — Alta Aderência, ~85%, risco Médio, 0 gatilhos críticos) em etica-ia.md | etica, aie, autoavaliacao, gti, artefato, transparencia |
| 0035 | Corrigir URL do LinkedIn de Elias Cotrim em equipe.mdx (2 ocorrências); preparar gabarito completo das 2 partes do questionário AIE para preenchimento real pelo responsável do projeto; registrar pendência de substituição do artefato GTI-AIE-0001 simulado pelo relatório real | equipe, linkedin, correcao, aie, gabarito, pendencia |
| 0036 | Redefinir papel do GT-IA em pv-gti.md: separar instância consultiva (GT-IA: opina, valida, recomenda, delibera, subsidia) da instância operacional (CGTI: letramento, workshops, hackathons, mapeamento, IDRs, monitoramento); incluir callout de risco de acúmulo de funções e mecanismo de acionamento | gti, gt-ia, cgti, governanca, papeis, consultivo, operacional |
| 0037 | Aprimorar metodologia de risco: adicionar separação dos 4 tipos de uso de IA em pv-gti.md; mecanismo de contestação em referencias.md; matriz impacto×probabilidade com critérios em riscos.md; substituir citações vagas de NIST/OECD/TOGAF por referências pontuais nos princípios correspondentes em principios.md | risco, nist, oecd, togaf, contestacao, autonomia, principios, metodologia |
Sessão 13 — Aprimoramento Visual com Ícones e Componentes
Seção intitulada “Sessão 13 — Aprimoramento Visual com Ícones e Componentes”| Prompt | Descrição | Tags |
|---|---|---|
| 0038 | Converter 5 páginas de .md para .mdx e aplicar componentes Starlight: CardGrid+Card com ícones nos grupos de risco e princípios; Badge com variantes danger/caution/success/note nas colunas de severidade e nível; LinkCard substituindo links de texto nos CTAs de navegação. Páginas: riscos.mdx, etica-ia.mdx, pv-gti.mdx, principios.mdx, aie-autoavaliacao-ia.mdx | mdx, icones, badge, card, linkcard, starlight, visual, acessibilidade |
Sessão 14 — Ferramenta AIE-BR: Correções e Resultado
Seção intitulada “Sessão 14 — Ferramenta AIE-BR: Correções e Resultado”| Prompt | Descrição | Tags |
|---|---|---|
| 0039 | Corrigir botão “Gerar Classificação Final” do questionário AIE-BR que não reagia ao clique com filtro por perfil de ator: campos required ocultos bloqueavam a validação nativa do browser; solução via disabled = true nos inputs dos blocos ocultos em AIE-2.39.html | bugfix, aie-br, javascript, validacao-formulario |
| 0040 | Implementar persistência de respostas no AIE-BR: botão “Salvar Rascunho” (exporta JSON), “Carregar Rascunho” (restaura estado e navega direto ao questionário pré-preenchido) e auto-save no localStorage com aviso de restauração | feature, aie-br, javascript, persistencia-local |
| 0041 | Corrigir downloads que falhavam via protocolo file://: função centralizada triggerDownload() com fallback para modal interno à página (sem window.open), botão de cópia para clipboard e suporte a todos os formatos (JSON, TXT, MD, CSV, Rascunho) | bugfix, aie-br, javascript, download, file-protocol |
| 0042 | Criar RESULTADO-AIE-BR-SinergIA.md documentando a execução real do questionário AIE-BR v2.39: Nível 4 — Aderência Alta (88,9%, 136,8/154 pontos), tabela por seção, riscos e mitigações, bugs corrigidos e nota sobre questões sem N/A | documentacao, aie-br, etica-ia, resultado-avaliacao |
Sessão 15 — Saneamento da Documentação e Comunicação
Seção intitulada “Sessão 15 — Saneamento da Documentação e Comunicação”| Prompt | Descrição | Tags |
|---|---|---|
| 0043 | Reformular a apresentação do framework em index.mdx e introducao.md para tornar explícita a audiência, o problema concreto e o que o SinergIA faz — eliminando a descrição circular que impedia o leitor de entender para que o projeto serve | documentacao, comunicacao, framework, refatoracao |
| 0044 | Tornar explícitos os problemas que o framework resolve em index.mdx e introducao.md: 4 blocos ordenados do mais universal ao mais técnico — trabalho humano, mercado de TI, contexto de governo e processo de desenvolvimento com IA (tabela princípio × problema) | documentacao, comunicacao, framework, refatoracao |
| 0045 | Adicionar âncoras concretas contra percepção de texto vazio: evidências reais (44 prompts, git, agente) com ressalva de beta em introducao.md; cenários ilustrativos rotulados como :::tip[Como fica na prática] em 3 princípios; frase âncora em index.mdx declarando o framework como primeira aplicação documentada | documentacao, comunicacao, framework, refatoracao |
Sessão 16 — Análise Comparativa com Gartner
Seção intitulada “Sessão 16 — Análise Comparativa com Gartner”| Prompt | Descrição | Tags |
|---|---|---|
| 0046 | Avaliar o Framework SinergIA contra 10 recomendações do Gartner para uso de IA no desenvolvimento de sistemas, com notas de 0 a 5 e fundamento mapeado nos artefatos do framework: total 38/50 (76%); pontos máximos em guardrails e supervisão humana; gap principal em upskilling da força de trabalho | analise, gartner, framework, governanca, ia |
Sessão 17 — Matriz conceitual e rastreabilidade de prompts
Seção intitulada “Sessão 17 — Matriz conceitual e rastreabilidade de prompts”| Prompt | Descrição | Tags |
|---|---|---|
| 0047 | Implementar página Starlight framework/matriz-conceitual-eixos.md (três eixos, BRD/PRD/TDD, ADR, exemplos, Mermaid) e item na sidebar; registrar prompt-0047 | documentacao, framework, starlight, matriz |
| 0048 | Atualizar historico/prompts.md (sessão 17, lastUpdated), garantir prompt-0046 e 0047 em userPrompts/, regenerar historico/git.md e commitar documentação da matriz e registros | documentacao, prompts, git, commit, rastreabilidade |
Sessão 18 — Conteúdo integral dos prompts no site
Seção intitulada “Sessão 18 — Conteúdo integral dos prompts no site”| Prompt | Descrição | Tags |
|---|---|---|
| 0049 | Exibir no Starlight o texto completo de cada userPrompt (sem links ao Bitbucket): sync para historico/registro-prompts/, links internos no índice, sync-prompts no ciclo dev/build | documentacao, prompts, starlight, site |
Sessão 19 — Natureza documental do framework
Seção intitulada “Sessão 19 — Natureza documental do framework”| Prompt | Descrição | Tags |
|---|---|---|
| 0050 | Criar página “Sobre o Framework SinergIA” como primeiro item do menu — mapeia cada componente do framework nas seis naturezas documentais (Orientativo, Normativo, Operacional, Procedimental, Prescritivo e Mandatório Fechado) com tabelas por categoria e síntese final | documentacao, framework, arquitetura, governanca |
| 0051 | Separar cada ponto de vista em subdiretório próprio, com uma página individual para cada história ou item — 47 novos arquivos em 8 subdiretórios (esp/, inf/, pro/, imp/, gti/, gda/, pdp/, sis/); sidebar expandido com grupos colapsáveis por PV | framework, arquitetura, documentacao, refatoracao |
| 0052 | Separar a seção “Artefatos do Projeto” em páginas individuais — 22 novos arquivos em artefatos/esp/ (11 histórias + fluxo de vida) e páginas por PV (IMP, GTI, PDP, INF, PRO, GDA), com exemplos YAML detalhados; sidebar expandido | artefatos, documentacao, refatoracao, framework |
| 0053 | Granularizar a seção “Artefatos do Projeto” — 24 novos arquivos em 7 subdiretórios (nomenclatura/, imp/, gti/, pdp/, inf/, pro/, gda/), com uma página por artefato; 7 arquivos simples excluídos para evitar conflito de URL; sidebar expandido com grupos colapsáveis por PV | artefatos, refatoracao, documentacao, site |
| 0054 | Converter docs/site-itens-map.md para Markdown com seções ## e tabelas de 3 colunas; acrescentar 17 novas páginas (artefatos granulares do prompt 0053) com classificação em branco; publicar como /mapa-do-site/ no Starlight com auto-referência como “B” | documentacao, site, refatoracao, mapa |
| 0055 | Implementar colorização automática de páginas por escopo: script gen-scope-styles.mjs gera CSS de sidebar e JSON de mapa; componente PageTitle.astro colore H1 e adiciona badge “(S)”; 36 S em verde, 75 B em âmbar, contraste WCAG AA em modo claro e escuro | site, css, starlight, componente, escopo |
Como funciona o registro automático
Seção intitulada “Como funciona o registro automático”O arquivo .cursor/rules/salvar-prompt.mdc contém uma regra alwaysApply: true que instrui o agente a:
- Verificar o número do último prompt em
docs/userPrompts/ - Incrementar o número em 1 (formato
####) - Criar slug descritivo de até 5 palavras
- Gerar
docs/userPrompts/prompt-####-slug.mdcom:- Metadados YAML:
date,tags - Prompt refinado — intenção real expandida, sem ambiguidades
- Resultado — artefatos criados, decisões tomadas, arquivos alterados
- Metadados YAML:
Prompts puramente informativos (sem ação associada) não são registrados.
Padrão de arquivo:
prompt-####-<slug>.md· Fonte canônica:docs/userPrompts/· Cópia para o site:docs/site/src/content/docs/historico/registro-prompts/(atualizada pornpm run sync-promptsno diretório do site) · Rule:.cursor/rules/salvar-prompt.mdc