conn2flow-ai-workspace
CLAUDE.md4 starsChanged 33 days agoMITView on GitHub
Invoque explicitamente a skill correspondente ANTES de editar código ou fechar lotes: - Início de Tarefa: /start-mdd-slice (nova demanda), /continue-mdd-batch (retomar batch), mdd-workflow (alinhar fluxo). - Durante a Edição: invoque as Core Skills (c2f-*) relevantes para a stack tocada (banco, variáveis, recursos, layout, etc.). - Fechamento e Validação: project-validation (estratégia de testes), /review-current-batch (review findings-first), mdd-memory-gardening (podar memórias). - Mudança Normativa: /raise-spec-change (se houver alteração de contrato/requisito). Quando o usuário abrir um chat e enviar comandos curtos (ex: "começa aí",…
In this repository96 other files it gives its agents.
- AGENTS.mdAGENTS.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
- 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
We split this CLAUDE.md into the rules it gives an agent
3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 5
Use memory/human-requests/ apenas como intake humano não normativo.
- Very specific: line 6
Memórias de Engenharia: No início de cada sessão, leia obrigatoriamente memory/03-memory-engineering-chief.md e …
- Distinctive: line 67
Commit semântico e push na branch de trabalho.
≈ “Common” is an estimate: at least 1 in 5 of the 27,641 CLAUDE.md 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
Projeto Spec-Driven Development
- Trate
memory/README.mde os sdd numerados como fonte normativa. - Antes de editar código ou sdd, leia
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.mdememory/decisions/DECISION-LOG.md. - Use
memory/human-requests/apenas como intake humano não normativo. Se a demanda vier como caminho de arquivo Markdown ou como a própria pasta, leia esse material primeiro e depois classifique a demanda no artefato SDD correto. - Memórias de Engenharia: No início de cada sessão, leia obrigatoriamente
memory/03-memory-engineering-chief.mdememory/04-memory-engineering-execution.mdpara alinhar contexto antes de qualquer alteração. - Manutenção da Memória de Execução: Ao término de cada tarefa, atualize
memory/04-memory-engineering-execution.mdcom novos aprendizados, bugs resolvidos e particularidades do ambiente. Nunca modifiquememory/03-memory-engineering-chief.mdsem instrução explícita do usuário humano. - Classifique a demanda cedo: change request, implementação de batch, review ou validação.
- Não reescreva os sdd numerados para comentários pequenos de review.
- Edite sdd numerados apenas quando requisito, contrato, critério de aceite ou decisão aprovada realmente mudar.
- Mantenha o trabalho em batches pequenos com alvo de validação explícito.
Skills OBRIGATÓRIAS por Marco de Fluxo
Invoque explicitamente a skill correspondente ANTES de editar código ou fechar lotes:
- Início de Tarefa:
/start-mdd-slice(nova demanda),/continue-mdd-batch(retomar batch),mdd-workflow(alinhar fluxo). - Durante a Edição: invoque as Core Skills (
c2f-*) relevantes para a stack tocada (banco, variáveis, recursos, layout, etc.). - Fechamento e Validação:
project-validation(estratégia de testes),/review-current-batch(review findings-first),mdd-memory-gardening(podar memórias). - Mudança Normativa:
/raise-spec-change(se houver alteração de contrato/requisito).
Otimização de Contexto e Arquivamento
- Mantenha
memory/decisions/DECISION-LOG.md,memory/implementation/BATCH-INDEX.mdememory/validation/VALIDATION-CHECKLIST.mdcom no máximo 10 itens correntes ou ativos. - Mantenha também
memory/human-requests/enxuto, preservando no máximo 10 requisições correntes ou recentes fora dearchive/. - Mova históricos antigos para a subpasta
archive/correspondente:memory/decisions/archive/,memory/human-requests/archive/,memory/implementation/archive/oumemory/validation/archive/. - Nos arquivos principais, substitua o histórico arquivado por tabelas Markdown resumidas com 1 linha por item e link direto para o arquivo em
archive/. - Ao carregar contexto inicial, priorize os arquivos principais e abra itens em
archive/apenas quando o batch, a requisição ativa ou um link de rastreabilidade exigir.
Intake Gate do backlog
memory/backlog/é uma incubadora de rascunhos administrada pelo Usuário e pelo Arquiteto IA.- O Executor pode ler itens para contexto, mas é estritamente proibido de implementá-los, abrir batch de execução ou alterar código diretamente a partir deles.
- Um item, inclusive
READY, só se torna executável após promoção humana explícita paramemory/human-requests/req-XXX.md, atualização deCURRENT.mde associação a um batch.
⚡ Protocolo de Inicialização Zero-Prompt (Auto-Boot)
Quando o usuário abrir um chat e enviar comandos curtos (ex: "começa aí", "chefe", "inicia", "bora", "executa", "status"):
- Identificação Automática: O agente assume imediatamente o contexto do repositório
conn2flow-ai-workspaceemc:\Users\otavi\OneDrive\Documentos\GIT\conn2flow-ai-workspace. - Leitura Mandatória de
CURRENT.md: O agente abrememory/human-requests/CURRENT.mdpara inspecionar o ponteiro da requisição ativa (req-XXX.md), o lote correspondente e o modo de autonomia (supervisionado,autonomo_monitoradoouautonomo_headless). - Ativação Automática por Papel:
- No VS Code / Claude Code (Executor Tático): Ativa
c2f-executor-agent, renderiza de imediato a Live Todo List ([ ]➔[x]) a partir da requisição ativa e inicia a implementação do menor slice aprovado. - No Antigravity (Arquiteto Master): Ativa
c2f-architect-master, lêmemory/03-memory-engineering-chief.mde propõe o próximo plano. - No Revisor: Ativa
c2f-reviewer-agent, audita diffs e valida contratos de segurança/skills.
- No VS Code / Claude Code (Executor Tático): Ativa
- Integração MCP Automática: Utiliza o MCP Hub (
conn2flow-hub) para operações de CLI (c2f_run_command), despacho (dispatch_task) e recibos de conclusão (report_completion).
📋 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 (
- 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 Multi-Agente
- 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
- Reserva e Releitura Atômica de Numeração de
req-XXX.md:- O agente deve reler o diretório
memory/human-requests/imediatamente antes de criar arquivos para evitar colisão e sobrescrita de números de requisição.
- O agente deve reler o diretório
Trava Tripla MDD — REQ-072 / ARCH-015
Leia c2f-mdd-indexing-and-handoffs antes de criar metadados, regenerar índices ou transferir o lote. Novos artefatos usam YAML frontmatter; memory:index/set/get no core e mdd index/meta set/meta get no Client mantêm o índice derivado. A fonte canônica contém 46 skills (3 papéis, 34 de core e 9 de governança).
Handoffs incluem projeto, raiz absoluta, REQ, BATCH, escopo, evidências, pendências, topologia e autonomia. solo: auto-revisão; dupla: retorno ao Macro-Arquiteto; triade: recibo e Revisor Independente com ficha em memory/human-reviews/. supervisionado: aguardar input humano em cada transição; autonomo_monitorado: Live Todo e acionamento autorizado; autonomo_headless: despacho/recibos persistentes. Somente humano assina homologação. Detalhes em memory/02-policy.md; dez fichas ativas, arquivos duais compacted/original.
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. c2f-multilingual-skills-governance: governança das traduções de skills e hash pairing SHA-256.
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.

