c2f-project-pipeline-and-tasks
Skill4 starsChanged 34 days agoMITView on GitHub
LEIA ANTES de sincronizar, compilar, testar ou fazer deploy de projetos e sites locais ou remotos. Se não ler: sincronização por cópia manual (cp) em vez do pipeline, banco desincronizado, *Data.json não recompilados, estado híbrido pós-deploy por ausência de css:rebuild e paralelismo concorrente travando o PHP.
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-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-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
Pipeline de Projetos, Autoridade Declarativa e Tasks do Conn2Flow
⚡ Gatilho Obrigatório
- TRIGGER: Sincronizar alterações do Core para projetos, compilar recursos, testar em ambiente local, ou fazer deploy de projetos/sites.
- SKIP APENAS SE: Edição isolada de arquivos do Core sem necessidade de propagação para projetos.
- CONSEQUÊNCIA DE IGNORAR: Arquivos divergentes entre Core e projetos,
*Data.jsonnão recompilados, migrações Phinx não aplicadas, estado híbrido pós-deploy por falta decss:rebuild, banco desincronizado e supressão de warnings PHP por paralelismo indevido.
⛔ Regra #1: Pipeline ≠ Cópia de Arquivo
Regra de Proporcionalidade de Build — REQ-075 / Core REQ-269
- Categoria A — backend sem HTML/classes/CSS/fontes de compilação alterados: use
./c2f project:deploy <id>ou./c2f manager:update-all --skip-cssquando houver sincronização local necessária. Para Core isolado, use o pipeline do sistema. Build completo de Tailwind é proibido nesta categoria. - Categoria B — documentação, skills, testes unitários e memória MDD: apenas checks/testes locais; proibido executar pipeline de deploy no Lab.
- Categoria C — telas, templates HTML, componentes, classes Tailwind, CSS ou configuração/fontes de compilação: pipeline completo sem
--skip-css; CSS derivado precisa corresponder ao HTML publicado. Mudanças mistas com impacto de CSS pertencem a C.
--skip-css já existe no Core: o pipeline de projeto repassa a flag nas etapas 2/8 e 4/8 e pula CSS derivado em 7/8; o sistema pula Tailwind em 2/6 e CSS derivado em 5/6. Dados/metadados, arquivos, banco, JS e publicação continuam nas demais etapas. A via cirúrgica não substitui compilação/sincronização de recursos de autoria do projeto. Não faça resources:sync completo separado para contornar a economia de A. A flag não muda permissões, ambiente alvo, locks ou verificação de conteúdo. A meta de <45 segundos é dependente do ambiente e exige medição; neste lote de governança não se faz deploy para demonstrá-la.
[!CAUTION] É estritamente proibido sincronizar alterações entre o Core e projetos usando cópia manual de arquivos (
cp,copy,Copy-Item,xcopy). Isso resulta em:
*Data.jsonnão recompilados (recursos desatualizados no banco)- Migrações Phinx não aplicadas (schema divergente)
- Banco SQL desincronizado com os arquivos em disco
- Arquivos de espelho (
dev-environment/data/sites/...) inconsistentes- Estado híbrido pós-deploy (HTML novo servido com CSS desatualizado em cache)
Pipeline Completo para o Sistema (Categoria C / 6 etapas):
./c2f manager:update-allSequência conferida em ManagerUpdateAllCommand.php:
- Minificação de JavaScript de autoria.
- Resources: compilação de recursos e metadados (
c2f resources:sync). - Files: sincronização de arquivos com o ambiente de teste.
- Database: upsert e migrations.
- CSS Rebuild: reconstrução do CSS derivado (dispensada em A com
--skip-css). - Publicação de assets em
dist/.
Pipeline padrão para projetos (95% dos casos):
./c2f project:deploy <projectID>O deploy publica o projeto via deploy-project-v2.sh. Não atribua a ele as oito etapas de project:update-all nem a flag --skip-css, que o wrapper de deploy não repassa. A Regra #8 descreve somente a exceção mista Core + projeto.
[!IMPORTANT] Prevenção do Estado Híbrido Pós-Deploy: Na Categoria C,
css:rebuildrecalcula o CSS derivado (css_precompiledecss_compiled) a partir do HTML real no banco. Na Categoria A, sem alteração das fontes de CSS,--skip-cssdispensa esta etapa; não force um rebuild separado. Isso preserva a correspondência entre HTML e CSS sem build desnecessário.
🏷️ Regra #2: Autoridade Declarativa de devProjects.<id>.local
Antes de interagir com QUALQUER projeto, o agente DEVE inspecionar o campo local do projeto em dev-environment/data/environment.json:
{
"devProjects": {
"transformamp": {
"local": false
},
"transformamp-local": {
"local": true
}
}
}Valor de local | Significado | Permissões do Agente |
true | Ambiente de teste local | ✅ Liberdade total: alterar, testar, quebrar, fazer deploy, manipular banco |
false | Ambiente de produção real | 🔒 Exige autorização explícita e confirmação do operador humano |
[!WARNING] Projetos existem em pares (ex:
transformamp/transformamp-local,snapphoton/snapphoton-local). Os comandos de leitura parecem idênticos, mas o destino do deploy e o banco de dados são diferentes. Sempre verifiquelocalantes de qualquer operação destrutiva.
📊 Regra #3: Fonte da Verdade em Runtime
O runtime do Conn2Flow serve HTML e CSS exclusivamente do BANCO DE DADOS (gestor.php:2782). O diretório resources/ é lido diretamente apenas sob DEVELOPMENT_ENV=true.
Ao investigar o comportamento de uma página publicada:
- Primeiro: Inspecione o banco de dados (tabelas
paginas,layouts,componentes). - Depois: Compare com os arquivos em
resources/para identificar divergências. - Nunca: Assuma que o conteúdo em disco é o que está sendo servido ao visitante.
🔄 Regra #4: Tabela de Equivalência VS Code Tasks ↔ CLI c2f
As tarefas definidas em .vscode/tasks.json são atalhos visuais para os comandos nativos do Core CLI:
| VS Code Task | Comando CLI Equivalente | Descrição |
| 🗃️ Projects - Sync Core → ID | c2f project:sync-core <id> | Sincroniza o Core para o espelho do projeto |
| 🗃️ Projects - Update All → ID (somente lote misto) | c2f project:update-all <id> | 8 etapas: JS → Core → DB → Resources → Files → DB → CSS Rebuild → dist; Categoria A usa --skip-css |
| 🚀 Projects - Deploy Project → ID | c2f project:deploy <id> | Deploy do projeto para o servidor de destino |
| 📦 Manager - Update All | c2f manager:update-all | 6 etapas: JS → Resources → Files → DB → CSS Rebuild → dist; Categoria A usa --skip-css |
| 🎨 Tailwind - Sync Resources | c2f resources:sync | Compila recursos e gera *Data.json |
| 🧪 Manager - Run Tests | c2f test:run | Executa suite de testes automatizados |
| 🗄️ DB - Run Migrations | c2f db:migrate | Aplica migrações Phinx pendentes |
| 🗄️ DB - Create Migration | c2f db:create-migration <name> | Cria nova migração Phinx |
[!TIP] Ao documentar procedimentos ou instruções para agentes, sempre referencie o comando CLI (
c2f ...) em vez do nome da task do VS Code. O CLI é universal e funciona em qualquer terminal, IDE ou pipeline CI/CD.
⚡ Regra #5: Execução Sequencial Exclusiva & Proibição de Paralelismo em Lote
[!CAUTION] Proibição Estrita de Comandos de Compilação em Paralelo: Comandos pesados de compilação, banco de dados ou sincronização em lote (
css:rebuild,resources:sync,project:update-all,manager:update-all,db:migrate) DEVEM ser executados estritamente de forma sequencial (um por vez) no mesmo ambiente/container.
Por que o paralelismo é destrutivo:
- Travamento de Processos PHP: Múltiplos processos simultâneos disputando banco e I/O travam o container Docker ou deixam conexões pendentes.
- Supressão Silenciosa de Warnings/Notices: Rodar comandos pesados em background ou com redirecionamentos que suprimam
stderroculta erros de runtime vitais.- Caso Real Documentado: O erro
$fontesExtrassem parâmetro na assinatura do método permaneceu invisível por horas no Core porque o comando rodava em background com buffer suprimido — astailwind_sourcesnunca eram aplicadas e nada no terminal acusava o warning.
- Caso Real Documentado: O erro
Diretrizes Mandatórias:
- Foreground Obrigatório: Sempre execute comandos de compilação em foreground direto.
- Saída Desbufferizada: Nunca redirecione saídas para descartar
stderr(2>&1 > /dev/null). Permita que notices, warnings e stack traces do PHP sejam visíveis no terminal imediatamente para correções a quente. - Ordem Estrita: Espere um comando terminar com código de saída 0 antes de iniciar o próximo.
🗑️ Regra #6: Expurgo de Registros Órfãos no Deploy (Lista deletar)
O pipeline de banco de dados opera em modo upsert e não exclui linhas que foram omitidas nas fontes JSON. Para remover páginas, blocos ou metadados obsoletos no deploy, registre explicitamente as chaves naturais no arquivo project_tables_config.json:
{
"tabelas": {
"paginas": {
"deletar": ["language", "modulo", "id"]
},
"publisher_pages": {
"deletar": ["language", "page_id"]
}
}
}6.1 Páginas Semente (without_permission)
Para páginas de template que geram instâncias filhas dinâmicas (ex: semente de produto store/<id>/), remova a propriedade without_permission da semente para que:
- A semente em si não conste no sitemap (não é uma página pública real).
- Apenas as páginas filhas públicas geradas a partir da semente constem no sitemap.
🧠 Regra #7: Diagnóstico de Estouro de Memória no Deploy via API
O endpoint /_api/project/update executa a sincronização de banco com SELECT * e fetchAll. Em projetos com centenas de páginas, pode ocorrer estouro do memory_limit padrão de 128 MB, gerando HTTP 500 sem corpo descritivo.
Diagnóstico Obrigatório
Diante de HTTP 500 no deploy via API:
- Inspecionar log da sessão e depois access log do Nginx (código HTTP, bytes e horário).
- Correlacionar
conn2flow-gestor/logs/php-error.logno mesmo horário; buscarAllowed memory size of ... bytes exhaustedsomente como hipótese a confirmar. - Conferir banco SQL após os logs. O endpoint do Core foi ajustado para invocar
api_memoria_minima('1024M'); não concluir falta de memória só pelo HTTP 500.
# Via SSH — verificar últimas linhas do log de erro
ssh usuario@host "tail -50 /path/to/conn2flow-gestor/logs/php-error.log"[!TIP] Se o estouro persistir, considere aumentar o
memory_limitno.htaccessouphp.inido servidor, ou otimizar as queries de sincronização para usar cursores em vez defetchAll.
🧭 Regra #8: Exceção mista Core + projeto — project:update-all <id> (8 etapas)
A sequência de ProjectUpdateAllCommand.php tem oito etapas. Use esta lista ao ler o log:
- Minificando JavaScript de autoria
- Sincronizando Core
- Atualizando Banco de Dados (dados do core)
- Sincronizando Recursos (compilação do projeto: Tailwind por recurso e
*Data.json) - Sincronizando Arquivos
- Validação Final do Banco (dados do projeto)
- Regenerando CSS derivado
- Publicando assets estáticos em
dist/
Para rodar só a compilação do projeto: c2f project:sync-resources <id>.
🔎 Regra #9: Saída 0 não prova que o conteúdo chegou
Caso real (2026-10-01): pipeline com saída 0, publisher_pages com 76 atualizações e paginas com zero. A gravação do PaginasData.json tinha falhado em silêncio (arquivo bloqueado numa pasta sincronizada). O core passou a interromper a compilação nesse caso, mas a conferência continua obrigatória.
Depois de publicar uma mudança de conteúdo, confira três pontos, nesta ordem:
- O dado compilado:
grepdo texto novo emgestor/db/data/PaginasData.jsondo projeto. O arquivo de recurso (resources/.../pagina.html) estar certo não basta. - O log do banco: a linha
SYNC_FIM tabela=<tabela> +i ~u =sda etapa 5.~0numa tabela que você alterou é sinal de problema. - A página no ar: o texto novo na resposta HTTP. Teste que compara só o título não percebe um corpo antigo.
SKIP_NO_CHECKSUM_CHANGE tabela=<t> significa que a tabela nem foi comparada. Para exercitar uma regra de sincronização que mudou:
bash ai-workspace/en/scripts/dev-environment/updates-manager-database.sh --project <id> --tables <tabela> --force-all🚦 Regra #10: Um deploy por vez no mesmo ambiente
O pipeline por SSH não tem trava. Dois agentes publicando no mesmo ambiente geram respostas 500/503 passageiras e validações falsas.
- Antes de publicar e antes de validar, confira se o ambiente está ocioso: data de modificação do log
logs/atualizacoes-bd-<data>.loge da pastaresources/no destino. Menos de dois minutos: espere. - Falha 500/503 intermitente numa rota que respondia 200 é, antes de tudo, sinal de deploy concorrente. Repita com o ambiente ocioso antes de investigar o código.
- Árvore compartilhada com lote de outro agente em andamento não é origem de pipeline: o trabalho inacabado dele vai junto. Preserve a origem e coordene os agentes; uma worktree só é admitida com concorrência comprovada, registro e consulta humana em caso de dúvida.
🧱 Regra #11: Regras de dados do sincronizador
insert_onlyvale para as estratégiaspkenatural_key. Ao mudar a estratégia de uma tabela no contrato, confira que as proteções existem no ramo novo desincronizarTabela().- Retirada por dono (DEC-136): o que o dono deixa de entregar vira choque
retirado, mantido até confirmação humana. Com retirada confirmada, tabelas semstatussofrem DELETE físico e exigem dump para recuperação. Fonte incompleta gera retiradas indevidas para análise; nunca a publique nem confirme essas retiradas automaticamente. - Compilação de projeto usa as sementes do projeto. Tabela declarada pelo core sem semente no projeto é pulada (
DYNAMIC_SKIP_PROJETO_SEM_SEMENTE). - O pipeline de projeto roda sem backup das tabelas. Antes de validar regra de dados num ambiente, fotografe as tabelas envolvidas (uma consulta de leitura salva em arquivo) e compare depois.
Nota de autoria: na via cirúrgica Core/banco, --core-resources preserva o dono das sementes do Core. Dados e recursos próprios do projeto exigem sua sincronização específica; não use essa flag para transferir autoria.
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.
REP-002 — manifesto e diagnóstico
project:sync-core e sync-files no Lab gravam fora do manifesto e podem produzir choques falsos. Prefira deploy/release; reconciliação em massa requer simulação e autorização humana. Não use essa via como atalho de rotina.
“Falha <etapa>” é falha HTTP: log da sessão → access log do Nginx (código e bytes) → php-error.log no horário → banco SQL. Hipóteses de timeout/memória/sessão exigem evidência.
Nota REQ-077: --skip-css refere-se aos comandos que a implementam (manager:update-all e à exceção project:update-all). O wrapper ProjectDeployCommand.php repassa somente projeto e --contents; não prescreva essa flag a project:deploy.
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.

