REQ-269 — Pipeline Ágil: Suporte a `--skip-css` em `project:update-all` e Otimização Seletiva de Compilação Tailwind

• Status: ready-for-intake

• Topologia de Agentes: dupla (Arquiteto Master ➔ Engenheiro Executor)

• Modo de Autonomia: autonomo_monitorado

• Lote Alvo Core: BATCH-278 (conn2flow)

• Data de Criação: 2026-10-14

• Origem: Resolução do gargalo crítico de velocidade de desenvolvimento, onde o pipeline completo (project:update-all / manager:update-all) levava de 10 a 15 minutos executando a pré-compilação em lote do Tailwind CSS mesmo em alterações estritamente de backend, banco de dados ou testes.

• Repositório Alvo:

  • Core: conn2flow em [REDACTED]

1. Visão Geral & Escopo Técnico no Core

1. Pass-through da flag --skip-css no Pipeline project:update-all

• Em cli/src/Commands/ProjectUpdateAllCommand.php:

  • Declarar a opção --skip-css na assinatura de ajuda e argumentos do comando.

  • Na Etapa 4/8 (ProjectSyncResourcesCommand): repassar a flag --skip-css caso tenha sido fornecida na linha de comando.

  • Na Etapa 7/8 (css:rebuild): se --skip-css estiver ativo, omitir a execução de regeneração de CSS derivado no banco, emitindo mensagem informativa curta (Etapa 7/8 ignorada por --skip-css).

2. Repasse da Flag em ProjectSyncResourcesCommand e update-resource-data.sh

• Em cli/src/Commands/ProjectSyncResourcesCommand.php:

  • Aceitar a opção --skip-css e concatená-la na chamada do script shell.

• Em ai-workspace/en/scripts/projects/update-resource-data.sh:

  • Adicionar suporte à opção --skip-css no parsing de argumentos (while [[ $# -gt 0 ]]).

  • Repassar a flag --skip-css na invocação final de atualizacao-dados-recursos.php (o qual já possui suporte nativo para ignorar a etapa de compilação de Tailwind via linha 895 de tailwind-recursos.php).

3. Suporte no Pipeline do Sistema (manager:update-all)

• Em cli/src/Commands/ManagerUpdateAllCommand.php:

  • Permitir a execução com --skip-css, repassando a flag para as etapas de recursos e omitindo a etapa de css:rebuild.

4. Testes Automatizados de Proteção

• Criar teste unitário focado (ex: tests/Unit/PHP/PipelineSkipCssReq269Test.php) validando:

  • Resolução correta de argumentos e flags nos comandos de pipeline.

  • Pulo da etapa pesada de Tailwind quando a opção --skip-css for informada.

2. Critérios de Aceite & Validação

• [ ] ./c2f project:update-all <id> --skip-css executa sem erros em tempo inferior a 45 segundos, ignorando a compilação de Tailwind nas etapas 4 e 7.

• [ ] ./c2f project:update-all <id> (sem a flag) mantém a execução integral padrão de todas as 8 etapas, preservando a compilação de CSS para quando houver alteração visual autoral.

• [ ] ./c2f manager:update-all --skip-css aceita a flag e não falha por argumento desconhecido.

• [ ] Testes automatizados (composer test) verdes e sem regressões no Core.

• [ ] git diff --check aprovado e limpo.