c2f-documentation-governance
Skill4 starsChanged 33 days agoMITView on GitHub
LEIA ANTES de escrever ou atualizar documentações técnicas, especificações e manuais. Se não ler: documentação diverge do código-fonte real (Princípio da Autoridade do Código) e gera alucinações em agentes futuros.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- otavioserra/conn2flowword for word, first seen Nov 5, 2026
Other versions1 project uses a version of this.
Word for word · 1
- otavioserra/conn2flow★ 5100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository96 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- cli/CLAUDE.mdCLAUDE.md
- resources/CLAUDE.mdCLAUDE.md
- c2f-agent-visual-inspectionSkill
- c2f-ai-featuresSkill
- c2f-architect-masterSkill
- c2f-database-operationsSkill
- c2f-database-testingSkill
- c2f-dev-scriptsSkill
- c2f-docker-environmentSkill
- c2f-documentationSkill
- c2f-environment-configurationSkill
- c2f-executor-agentSkill
- c2f-gd-image-safetySkill
- c2f-gestor-functionsSkill
- c2f-global-variablesSkill
- c2f-hooks-systemSkill
- c2f-html-css-pages-and-componentsSkill
- c2f-interface-v2-architectureSkill
- c2f-javascript-ajaxSkill
- c2f-json-resources-syncSkill
- c2f-mdd-indexing-and-handoffsSkill
- c2f-modelo-templatesSkill
- c2f-module-crud-scaffoldingSkill
- c2f-module-visual-assetsSkill
- c2f-multilingual-skills-governanceSkill
- c2f-multilingual-systemSkill
- c2f-mysql-utf8-emoji-encodingSkill
- c2f-payment-gatewaysSkill
- c2f-plugin-architectureSkill
- c2f-preview-modals-systemSkill
- c2f-project-pipeline-and-tasksSkill
- c2f-projects-systemSkill
- c2f-resources-systemSkill
- c2f-reviewer-agentSkill
- c2f-shell-and-windows-trapsSkill
- c2f-system-tasksSkill
- c2f-tailwind-css-architectureSkill
- c2f-tailwind-module-migrationSkill
- c2f-variables-systemSkill
- c2f-widget-developmentSkill
- continue-mdd-batchSkill
- mdd-memory-gardeningSkill
- mdd-workflowSkill
- project-validationSkill
- raise-spec-changeSkill
- review-current-batchSkill
- start-mdd-sliceSkill
- c2f-mdd-indexing-and-handoffsSkill
- c2f-agent-visual-inspectionSkill
- c2f-ai-featuresSkill
- c2f-architect-masterSkill
- c2f-database-operationsSkill
- c2f-database-testingSkill
- c2f-dev-scriptsSkill
- c2f-docker-environmentSkill
- c2f-documentation-governanceSkill
- c2f-documentationSkill
- c2f-environment-configurationSkill
- The first 60 shown.
The file
Files
Governança e Verificação de Documentação (c2f-documentation-governance)
⚡ Gatilho Obrigatório
- TRIGGER: Criar, atualizar ou validar qualquer documento técnico em
docs/,sdd/ou guias de arquitetura. - SKIP APENAS SE: Correção de pequenos erros de digitação (typos) em arquivos que não alterem contratos normativos.
- CONSEQUÊNCIA DE IGNORAR: Doc drift (documentação desatualizada), propagação de premissas falsas e violação do Princípio da Autoridade do Código-Fonte.
Consulte e aplique este protocolo de verificação para garantir a sincronia e autoridade do código em relação a documentações técnicas:
1. Princípio da Autoridade do Código-Fonte
- Documentações (
docs/,*.md): Expressam a intenção arquitetural, histórico e manuais de uso. - Código-Fonte (
gestor/,modulos/,scripts/,db/): É a Fonte Suprema da Verdade. - Regra de Ouro: NUNCA assuma que assinaturas de função, caminhos de arquivo, parâmetros de API ou estruturas de tabela em documentações estão 100% atualizados sem antes inspecionar o código PHP/JS/SQL autoritativo correspondente via
view_fileougrep_search.
2. Protocolo de Auditoria e Verificação
Sempre que utilizar uma documentação para orientar uma implementação ou criar uma Skill:
- Verificação de Caminho: Confirme se os arquivos de controladores, bibliotecas ou scripts citados realmente existem no disco.
- Verificação de Assinatura: Abra o arquivo
.php/.jsreal e verifique o nome exato da função, ordem dos argumentos e tipos de retorno. - Verificação de Metadados de Banco: Consulte os arquivos de migração Phinx (
gestor/db/migrations/) e manifestosschema-metadata.jsonpara validar a existência de tabelas e colunas. - Resolução de Divergências: Se houver divergência entre a documentação e o código-fonte real, o código-fonte prevalece, devendo a documentação ser corrigida.
3. Manutenção da Documentação em Tarefas SDD
- Ao adicionar novos parâmetros, funções centrais, hooks ou rotas, atualize a documentação correspondente sob
ai-workspace/ousdd/. - Registre depreciações ou quebras de contrato no log do lote (
batch-XXX.md) e atualize os guias técnicos afetados.
4. Fluxo Mandatório Pós-Alteração de Código (docs:audit)
Modificar qualquer arquivo de código listado no cabeçalho sources: de um documento técnico normativo invalida o campo verified_at, gerando avisos de fonte divergente no ecossistema.
4.1 Sequência de 5 Etapas do Executor
Após concluir alterações em código que afetam contratos públicos ou bibliotecas documentadas:
- Auditar Fontes Afetadas:
Lista todas as documentações cujas fontes de código declaradas foram modificadas../c2f docs:audit - Sincronizar Conteúdo Textual: Atualizar o corpo das documentações que descrevem os comportamentos, parâmetros ou retornos alterados.
- Atualizar Metadado
verified_at: Atualizar o campoverified_at:no frontmatter do documento com o commit hash mais recente correspondente ao código verificado. - Extrair Novas Funções (se aplicável):
Se novas funções foram introduzidas em bibliotecas ou controladores:
./c2f docs:extract <biblioteca> - Compilar Documentação para Publicação:
Reconstruir os manifests e HTML das documentações do projeto:
./c2f docs:build --project=<id>
[!IMPORTANT] Nunca altere assinaturas de funções públicas ou tabelas de banco sem rodar
c2f docs:audit. Documentações comverified_atobsoleto induzem outros agentes a erro por alucinação baseada em contratos antigos.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

