agentleFS
otavioserraotavioserra/conn2flow-ai-workspace/AGENTS.md

conn2flow-ai-workspace

AGENTS.md4 starsChanged 33 days agoMITView on GitHub

Todas as 46 skills do framework estão disponíveis em .claude/skills/, .gemini/skills/, .cursor/skills/, .codex/skills/ e .github/skills/ e seguem o padrão aberto de progressive disclosure (SKILL.md): Quando o usuário abrir um chat e enviar comandos curtos (ex: "começa aí", "chefe", "inicia", "bora", "executa", "status"): 1. Identificação Automática: O agente assume imediatamente o contexto do repositório conn2flow-ai-workspace em c:\Users\otavi\OneDrive\Documentos\GIT\conn2flow-ai-workspace. 2. Leitura Mandatória de CURRENT.md: O agente abre memory/human-requests/CURRENT.md para inspecionar o ponteiro da requisição ativa (req-XXX.md), o lote correspondente e o modo de…

The file

Files
AGENTS.md

Agentes MDD — Configuração Multi-Agente OpenAI Codex & Antigravity

👥 Papéis de Agente Duplo

🏛️ Arquiteto (Macro-Orquestrador)

  • Responsabilidade: Traduzir necessidades humanas e briefings em especificações normativas (memory/SPEC.md), registros de decisão (memory/decisions/) e requisições formais (memory/human-requests/req-XXX.md).
  • Ferramentas: Antigravity / Gemini / GPT no modo planejamento.
  • Regra: Nunca realiza commits ou push de código diretamente no core ou módulos.

⚙️ Executor (Micro-Operador)

  • Responsabilidade: Implementar código, compilar recursos, rodar testes e registrar evidências no lote em memory/implementation/batch-YYY.md e memory/validation/VALIDATION-CHECKLIST.md.
  • Ferramentas: OpenAI Codex / GPT no VS Code / Claude Code.
  • Regra: Lê o briefing em memory/human-requests/CURRENT.md antes de iniciar qualquer alteração e atualiza a Live Todo List ([ ] ➔ [x]).

👨‍💻 Humano-no-Loop (Você)

  • Responsabilidade: Direcionar o Arquiteto e revisar diffs de código antes da consolidação final.

📦 Configuração de Skills (46 Skills Oficiais)

Todas as 46 skills do framework estão disponíveis em .claude/skills/, .gemini/skills/, .cursor/skills/, .codex/skills/ e .github/skills/ e seguem o padrão aberto de progressive disclosure (SKILL.md):

1. Skills de Papéis da Tríade MDD (3 Skills):

Consulte memory/process/STARTER-PROMPTS.md para modelos de abertura rápida de chat prontos para copiar e colar.

  • c2f-architect-master: Arquiteto Master / Engenheiro Chefe (governança macro, documentação viva, backlog e restrição de edição direta).
  • c2f-executor-agent: Micro-Executor Tático (Live Todo List [ ] ➔ [x], compilação oficial e obediência a contratos).
  • c2f-reviewer-agent: Revisor Técnico / Auditor de Qualidade (inspeção findings-first de git diff, CSRF, variables.json).

2. Skills Core, Módulos e Infraestrutura (34 Skills):

  • c2f-ai-features
  • c2f-agent-visual-inspection
  • c2f-database-operations
  • c2f-database-testing
  • c2f-dev-scripts
  • c2f-docker-environment
  • c2f-documentation
  • c2f-documentation-governance
  • c2f-environment-configuration
  • c2f-gd-image-safety
  • c2f-gestor-functions
  • c2f-global-variables
  • c2f-hooks-system
  • c2f-html-css-pages-and-components
  • c2f-interface-v2-architecture
  • c2f-javascript-ajax
  • c2f-json-resources-sync
  • c2f-modelo-templates
  • c2f-module-crud-scaffolding
  • c2f-module-visual-assets
  • c2f-multilingual-system
  • c2f-mysql-utf8-emoji-encoding
  • c2f-payment-gateways
  • c2f-plugin-architecture
  • c2f-preview-modals-system
  • c2f-project-pipeline-and-tasks
  • c2f-projects-system
  • c2f-resources-system
  • c2f-shell-and-windows-traps
  • c2f-system-tasks
  • c2f-tailwind-css-architecture
  • c2f-tailwind-module-migration
  • c2f-variables-system
  • c2f-widget-development

3. Skills de Governança e Workflow MDD (9 Skills):

  • c2f-mdd-indexing-and-handoffs
  • mdd-workflow
  • start-mdd-slice
  • continue-mdd-batch
  • raise-spec-change
  • review-current-batch
  • project-validation
  • mdd-memory-gardening

⚡ 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"):

  1. Identificação Automática: O agente assume imediatamente o contexto do repositório conn2flow-ai-workspace em c:\Users\otavi\OneDrive\Documentos\GIT\conn2flow-ai-workspace.
  2. Leitura Mandatória de CURRENT.md: O agente abre memory/human-requests/CURRENT.md para inspecionar o ponteiro da requisição ativa (req-XXX.md), o lote correspondente e o modo de autonomia (supervisionado, autonomo_monitorado ou autonomo_headless).
  3. Ativação Automática por Papel:
    • No Antigravity (Arquiteto Master / Engenheiro Chefe): Ativa c2f-architect-master, lê memory/03-memory-engineering-chief.md, verifica pendências e propõe o próximo plano estratégico ao usuário.
    • No VS Code / Claude Code / Codex (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 Revisor (Auditor de Qualidade): Ativa c2f-reviewer-agent, audita diffs e valida contratos de segurança/skills.
  4. 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).

🛡️ Regras Invioláveis de Governança

  1. Proibição Absoluta de git add -A e git add .: Commits devem SEMPRE listar arquivos específicos (git add <caminhos-especificos>).
  2. Proibição de Sincronização por Cópia Manual: NUNCA copie arquivos manualmente (cp, copy, Copy-Item) para pastas de teste/espelho (dev-environment/data/sites/). Use sempre ./c2f manager:update-all (sistema) ou ./c2f project:deploy <id> (projeto).
  3. Execução Sequencial Exclusiva: Comandos de compilação em lote (manager:update-all, project:update-all, css:rebuild, resources:sync) devem executar um por vez em foreground com logs desbufferizados.
  4. Fonte da Verdade em Runtime: O runtime serve HTML e CSS exclusivamente do banco de dados SQL. resources/ é a semente de autoria.
  5. Version Bump Mandatório: Ao alterar scripts JS ou estilos estáticos, incremente a versão no metadado <id>.json do recurso.
  6. Goal Mode (/goal): Utilize /goal no prompt para execução ininterrupta de fatias complexas no modo Autônomo Monitorado até cumprimento de todos os critérios de aceite do VALIDATION-CHECKLIST.md.
  7. Identificação de Repositório em Handoffs e Prompts: Sempre explicitar o identificador do projeto e o caminho absoluto da raiz do repositório alvo (ex: conn2flow-ai-workspace em c:\Users\otavi\OneDrive\Documentos\GIT\conn2flow-ai-workspace) nas mensagens de acionamento para outros agentes.
  8. Boost Mode (/boost): Utilize /boost no prompt para tarefas que exigem raciocínio analítico profundo, planejamento multi-etapa, múltiplas perspectivas e validação cruzada rigorosa.
  9. Configuração por Projeto em .gemini/config.json: O arquivo .gemini/config.json é o ponto canônico de configuração por projeto no Antigravity v2.16+. O diretório legado .agents/ foi descontinuado — todas as configurações, MCP servers e discovery vivem exclusivamente em .gemini/.

Fundação MDD (Memory Driven Development)

Na matriz, leia memory/00-baseline-architecture.md, memory/01-general-memory.md e memory/02-policy.md; use index.md antes de documentos densos. São quatro camadas: episódica, semântica/normativa, procedural e raw, com arquivamento dual compacted/original. Matriz e satélites usam memory/ e os cinco arquivos raiz 00–04. Boilerplates SDD mantêm sdd/ para compatibilidade; boilerplates MDD usam memory/. A nova skill c2f-ai-features integra os 8 pilares de IA do Conn2Flow Pro.

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-current e git status --short na 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> e git 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-retirada só 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.