mdd-workflow
Skill4 starsChanged 33 days agoMITView on GitHub
LEIA ANTES de criar ou alterar qualquer arquivo na pasta memory/ (process, implementation, validation, decisions). Se não ler: o fluxo de Agente Duplo é quebrado e os artefatos de controle perdem a governança.
- Reads credentials
- Commits and pushes
2 other projects use a version of this.
Adopted by
Most recently taken up by
- otavioserra/conn2flowword for word, first seen Oct 15, 2026
- TheDecipherist/claude-code-mastery-project-starter-kittheir own version, first seen Jun 26, 2026
Other versions2 projects use a version of this.
Word for word · 1
- otavioserra/conn2flow★ 5100% same
Edited · 0
None found.
Wrote their own version · 1
- TheDecipherist/claude-code-mastery-project-starter-kit★ 337same name
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-documentation-governanceSkill
- 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
- 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
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
Use esta skill quando o projeto for guiado por documentos MDD versionados.
- Distinctive: line 81
Commit semântico e push na branch de trabalho.
- Distinctive: line 118
Preferências subjetivas de interação do operador (estilo de resposta, atalhos de prompt, idioma preferido).
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
MDD workflow
⚡ Gatilho Obrigatório
- TRIGGER: Iniciar qualquer tarefa do framework MDD, interpretar requisições humanas ou classificar artefatos nas pastas de controle.
- SKIP APENAS SE: Tarefas completamente alheias ao ciclo de governança MDD (ex: git commits diretos de infraestrutura).
- CONSEQUÊNCIA DE IGNORAR: Desalinhamento entre Arquiteto e Executor, criação de arquivos em locais errados e colapso da metodologia de Agente Duplo.
Use esta skill quando o projeto for guiado por documentos MDD versionados.
🚫 Bloqueio de Memory Gardening: não invoque nem pode a memória de execução apenas por encerrar uma sessão ou concluir um batch. Abaixo de 50 KB e 200 linhas o arquivo está saudável e não deve ser reescrito; em 50 KB / 200 linhas há somente alerta preventivo, e a poda é obrigatória apenas em 75 KB / 300 linhas.
Leitura mínima inicial
Comece por memory/README.md, memory/process/00-START-HERE.md, memory/process/01-WORKFLOW.md, memory/implementation/BATCH-INDEX.md, o batch atual, memory/validation/VALIDATION-CHECKLIST.md e memory/decisions/DECISION-LOG.md.
Se a tarefa apontar para memory/human-requests/*.md ou para a pasta memory/human-requests/, leia primeiro esse intake humano. Quando vier apenas a pasta, use a seguinte ordem determinística:
CURRENT.mdREADME.md- o arquivo
.mdmais recente
Classificação da demanda
- Mudança de requisito ou contrato:
- registre em
memory/change-requests/ - avalie impacto nos documentos normativos numerados, decisions, batches e validation
- registre em
- Feedback de review sem mudança normativa:
- registre em
memory/human-reviews/ - mantenha os documentos normativos numerados estáveis
- registre em
- Implementação incremental:
- confira o batch atual em
memory/implementation/ - implemente o menor slice aprovado
- valide e atualize
memory/validation/quando necessário
- confira o batch atual em
- Validação ou spec drift check:
- comece pela menor checagem automatizada
- registre evidência e pendências nos artefatos certos
Regras de ouro
- Os documentos normativos numerados são a fonte normativa.
memory/human-requests/nunca é fonte normativa; ele só alimenta change requests, reviews, batches, decisions ou validação.- Não reescreva os documentos normativos numerados para comentários pequenos de review.
- Não abra o próximo batch antes de o atual estar estável e revisável.
Regra dos 10 Ativos na Raiz e Integridade de Links
- A raiz de
memory/human-requests/mantém no máximo 10 requisições soltas (além deCURRENT.mdeREADME.md); a raiz dememory/implementation/mantém no máximo 10 relatórios de lote (além deBATCH-INDEX.md). O excedente mais antigo vive emarchive/. - Arquivar sem reescrever links é proibido: todo link de markdown em
BATCH-INDEX.md,VALIDATION-CHECKLIST.md,DECISION-LOG.mdeCURRENT.mddeve continuar resolvendo após a movimentação. - Na raiz MDD, audite com
mdd compact --path RAIZ_ABSOLUTAe aplique somente a manutenção autorizada commdd compact --path RAIZ_ABSOLUTA --apply; preservação dual e reparo de links são obrigatórios. Não invente um comando ai:archive-mdd. - Não mova esses arquivos com
mv/Move-Itemmanualmente.
📋 Protocolo de Transparência & Checklist Vivo (Live Todo List)
- Ao iniciar qualquer requisição ou lote, renderize imediatamente a lista completa de tarefas (Todo List) com caixas de seleção [ ].
- A cada término de etapa/comando relevante, atualize e re-exiba a lista marcando [x] nas etapas concluídas e destacando a etapa atual (⏳ [EM ANDAMENTO]).
- Nunca execute sequências longas de comandos sem atualizar o status visual para o usuário.
🛡️ Espectro de 3 Níveis de Autonomia de IA
- Nível 1: SUPERVISIONADO (Padrão Mandatório / Human-in-the-Loop):
- O agente implementa código e executa testes, mas NÃO realiza commit, push ou deploy automático.
- O desenvolvedor revisa e aprova as mudanças no chat/IDE antes da consolidação.
- Nível 2: AUTÔNOMO MONITORADO (Live Autopilot / Glass-Box no Chat):
- Ativado quando a requisição contiver
modo: autonomo_monitoradoou o usuário autorizar expressamente o acompanhamento contínuo na tela. - O agente executa a esteira completa com Live Todo List (
[ ]➔[x]) visível e atualizado em tempo real:- Criação de branch (
feat/req-XXX); worktree apenas sob concorrência comprovada, conforme REQ-077. - Codificação e compilação de recursos (
c2f resources:sync). - Execução de testes automatizados (
c2f db:test). - DEPLOY EXCLUSIVAMENTE EM AMBIENTE DE TESTE LOCAL (
c2f manager:update-allou Docker local). - ⛔ REGRA INVIOLÁVEL DE SEGURANÇA: NUNCA REALIZAR DEPLOY AUTOMÁTICO EM AMBIENTE DE PRODUÇÃO OU SERVIDORES REMOTOS.
- Commit semântico e push na branch de trabalho.
- Relatório final com logs de execução e evidências de validação.
- Criação de branch (
- Goal Mode (
/goal) para Execução Contínua:- Em tarefas complexas ou fatias que exigem múltiplos ciclos de teste e correção, utilize o comando
/goalno prompt do Claude / IDE. - Exemplo de instrução:
"/goal Execute o lote BATCH-XXX até que todos os testes do VALIDATION-CHECKLIST.md passem e o relatório esteja preenchido." - O agente permanece em loop autônomo ininterrupto até satisfazer deterministamente todas as condições de encerramento do checklist técnico, impedindo paradas prematuras.
- Em tarefas complexas ou fatias que exigem múltiplos ciclos de teste e correção, utilize o comando
- Ativado quando a requisição contiver
- Nível 3: AUTÔNOMO HEADLESS (Background Silencioso / Black-Box):
- Ativado quando a requisição contiver
modo: autonomo_headless. - O agente executa a esteira via MCP Hub, emitindo notificação e relatório consolidado ao término; worktree somente sob concorrência comprovada e com expurgo seguro ao fechar o lote.
- Ativado quando a requisição contiver
🔒 Regras Mandatórias de Concorrência & Reserva Atômica de Requisições (req-XXX.md)
- Proibição Absoluta de
git add -Aegit commit -a:- O agente DEVE executar
git add <caminho-1> <caminho-2>listando estritamente os arquivos tocados no seu lote aprovado, prevenindo que commits arrastem código concorrente ou arquivos de outros agentes.
- O agente DEVE executar
- Protocolo de Reserva Atômica para Criação de
req-XXX.md:- Qualquer agente (Arquiteto ou Executor) está autorizado a criar novos arquivos
req-XXX.mdquando instruído pelo usuário no chat ou ao levantar uma demanda técnica essencial, seguindo estritamente:- Executar
git pull origin <branch>para obter o estado mais recente. - Reler atomicamente o diretório
memory/human-requests/para identificar o próximo número sequencial vago. - Criar o arquivo
req-XXX.md, atualizarmemory/human-requests/CURRENT.mde commitar/pushar imediatamente:git add memory/human-requests/req-XXX.md memory/human-requests/CURRENT.md git commit -m "docs(mdd): reserve REQ-XXX for <titulo>" git push origin <branch>
- Executar
- Qualquer agente (Arquiteto ou Executor) está autorizado a criar novos arquivos
- Identificação Obrigatória de Repositório nos Handoffs:
- Todo handoff humano-agente ou inter-agentes deve explicitar no topo da mensagem o identificador e o caminho absoluto da raiz do repositório alvo:
- Projeto:
<nome-do-projeto> - Caminho Raiz:
<caminho-absoluto-da-raiz> - Requisição:
REQ-XXX| Batch:BATCH-YYY
- Projeto:
- Previne que agentes executores ou revisores operem no repositório incorreto em ambientes com múltiplos workspaces abertos.
- Todo handoff humano-agente ou inter-agentes deve explicitar no topo da mensagem o identificador e o caminho absoluto da raiz do repositório alvo:
🧠 Camadas Canônicas de Memória
- Memória do Repositório (
memory/04-memory-engineering-execution.md— Git Compartilhado):- Fatos técnicos objetivos do software: bugs resolvidos no core, hacks temporários de build/banco, particularidades de compilação CSS/Tailwind, comandos CLI descobertos e lições aprendidas. Visível a todos os agentes e desenvolvedores.
- Memória Privada da Ferramenta de IA (Local):
- Preferências subjetivas de interação do operador (estilo de resposta, atalhos de prompt, idioma preferido).
⚖️ Princípio da Autoridade do Código e da SPEC sobre Memórias
- Toda anotação de restrição técnica em memória deve carregar a data de registro (
YYYY-MM-DD). - O código-fonte real, as configurações vigentes (
settings.json,.env), os schemas e os arquivos normativos (memory/SPEC.md,memory/0X-*.md) possuem autoridade absoluta sobre anotações de memórias passadas. Se uma restrição mudar no projeto, a anotação antiga em memória deve ser invalidada e atualizada.
🧯 Árvore compartilhada: o que conferir antes de cada commit
Outro agente pode trocar a branch da árvore e deixar arquivos em stage sem aviso. Antes de todo commit numa árvore que não é só sua:
git branch --show-current # é a branch em que você pretende commitar?
git diff --cached --name-only # há stage que não é seu?Se a branch não for a esperada, ou houver stage alheio, não commite na árvore. Monte o commit por índice separado, sem tocar nos arquivos nem na branch:
export GIT_INDEX_FILE="$TEMP/idx-meu-lote"
git read-tree origin/main
git add -- <caminho-1> <caminho-2>
commit=$(git commit-tree "$(git write-tree)" -p origin/main -F mensagem.txt)
unset GIT_INDEX_FILE
git push origin "$commit:refs/heads/main"Arquivo compartilhado (pages.json, índices do MDD) entra nesse commit como "versão da main mais as minhas entradas", nunca como a cópia da árvore, que carrega o trabalho do outro.
Proibido em árvore compartilhada
git checkout -- <arquivo>egit restore <arquivo>: apagam alteração sem commit de qualquer lote, não só a sua edição. Para desfazer a própria mudança, faça a edição inversa.git resetque mova a branch,git stashegit clean.git add -Ne qualquergit addsem lista de caminhos.
Dois agentes no mesmo arquivo-fonte
Quando dois lotes precisam escrever no mesmo arquivo de conteúdo, separe por arquivo (um canal, uma pasta) e deixe o gerador juntar. Quando não der, a ferramenta de edição relê o arquivo no instante de gravar e troca só os blocos que são seus.
Deixe um aviso onde o outro vai ler
Coordenação entre agentes é escrita na requisição do outro lote (um bloco "Coordenação", com data e autor), não só dita no chat.
🧾 Antes de afirmar que algo é pré-existente
Falha de teste "que já existia" precisa de prova: rode o mesmo teste sem a sua mudança, ou aponte o lote em que a falha foi registrada. Sem isso, ela é sua até prova em contrário.
MDD, links externos e reserva via git ls-remote (BL-028)
Na matriz conn2flow-ai-workspace e nos satélites migrados, use memory/; leia 00-baseline-architecture.md, 01-general-memory.md e 02-policy.md e navegue pelos index.md. As skills de governança usam exclusivamente seus nomes MDD; boilerplates legados exigem migração explícita. Não execute ai:archive-sdd sobre memory/ sem suporte explícito no CLI. O teto de dez decisões/validações exige verificação própria, não se presume pela saída do comando.
CURRENT.md pode apontar para requisição externa: resolva o link contra a origem, identifique repositório/raiz e leia a aprovação lá. Não crie cópia fictícia local nem execute no repo incorreto. Reparadores só reescrevem caminhos internos; links que saem do repositório são classificados e preservados. Se ferramenta legada rejeitar o link externo, registre a incompatibilidade e não remova o ponteiro só para conseguir PASS.
Antes de reservar número novo, consulte refs com git ls-remote --heads origin para todas as branches envolvidas, fetch das refs relevantes e confira a sequência incluindo arquivos arquivados. Código de saída de grep encadeado não prova reserva nem ausência remota. Crie o intake com caminhos explícitos, faça o push autorizado e confira novamente a ref exata via git ls-remote; em rejeição ou movimento concorrente, releia a sequência e resolva a colisão sem force push. ls-remote é verificação, não lock atômico por si só; o push condicionado à ref anterior e a conferência da reserva são a garantia. Nesta entrega REQ-067 já está reservada: não reserve novo número.
REQ-077 — Pipeline, worktrees e preservação (DEC-136)
- Projeto:
./c2f project:deploy <id>é o padrão (95% dos casos). Core:./c2f manager:update-all../c2f project:update-all <id>é proibido na rotina de projeto; permitido exclusivamente em lote que altera Core e projeto simultaneamente. - Antes de deploy, confira
git branch --show-currentegit status --shortna origem; não publique trabalho alheio/inacabado. Confira o destino e sua autorização. Categoria B (skills/documentação/testes/memória): somente checks locais, sem deploy. Execução sequencial, foreground, logs e locks continuam obrigatórios. - Worktrees por conveniência são proibidas. Só criar com concorrência multi-agente comprovada no mesmo repositório; em dúvida, consultar o humano antes. Registre raiz original, caminho temporário e concorrência na requisição e lote. Ao concluir/homologar, audite trabalho único, integração na main e junctions, então
git worktree remove <caminho>egit worktree prune. Nunca use força para destruir trabalho não integrado; preserve e reporte impedimentos. - DEC-136: manter por padrão; nada é removido (arquivo,
status='D',DELETE) sem confirmação explícita do operador humano. Retirada vira choque pendente;--confirmar-retiradasó quando pedido pelo operador. Fonte incompleta não autoriza retirada.
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.

