@lucapimenta/copy-chief-black 1.0.0

package/framework/commands/update-ecosystem.md

@@ -0,0 +1,382 @@
+---
+description: Gera ZIP completo do ecossistema com descoberta automática de componentes
+argument-hint: "[--check] [--no-offers]"
+---
+
+# /update-ecosystem - Backup Completo do Ecossistema
+
+Gera um ZIP com **TUDO** do ecossistema Claude Code usando descoberta automática.
+
+**Filosofia:** Incluir TUDO, excluir apenas auto-gerados.
+
+---
+
+## FASE 0: IDENTIFICAR VERSÃO (Automático)
+
+```bash
+# Ler versão de ~/.claude/.version (Single Source of Truth)
+VERSION=$(grep "^VERSION=" ~/.claude/.version | cut -d= -f2)
+RELEASED=$(grep "^RELEASED=" ~/.claude/.version | cut -d= -f2)
+TIMESTAMP=$(date +%Y%m%d-%H%M)
+
+echo "Versão: v$VERSION"
+echo "Released: $RELEASED"
+echo "Timestamp: $TIMESTAMP"
+```
+
+**Se .version não existe:**
+```bash
+# Criar com versão atual
+echo "VERSION=4.9.3" > ~/.claude/.version
+echo "RELEASED=$(date +%Y-%m-%d)" >> ~/.claude/.version
+```
+
+---
+
+## FASE 1: SINCRONIZAR VERSÃO
+
+```bash
+# Propagar versão para todos os arquivos
+~/.claude/scripts/sync-version.sh
+
+# Verificar sincronização
+~/.claude/scripts/sync-version.sh --check
+```
+
+**❌ BLOQUEAR SE:** Arquivos dessincronizados
+
+---
+
+## FASE 2: PREPARAR DIRETÓRIO DE BUILD
+
+```bash
+BUILD_DIR="/tmp/eco-build-$TIMESTAMP"
+PAYLOAD_DIR="$BUILD_DIR/ecossistema-v${VERSION}-installer/payload"
+ZIP_NAME="ecossistema-v${VERSION}-installer.zip"
+
+rm -rf "$BUILD_DIR"
+mkdir -p "$PAYLOAD_DIR/.claude"
+mkdir -p "$PAYLOAD_DIR/copywriting-ecosystem"
+```
+
+---
+
+## FASE 3: COPIAR ~/.claude/ (Descoberta Automática)
+
+### 3.1 Definir Exclusões (Única Lista a Manter)
+
+```bash
+CLAUDE_EXCLUDES=(
+    "debug"
+    "cache"
+    "plans"
+    "session-env"
+    "shell-snapshots"
+    "file-history"
+    "projects"
+    "paste-cache"
+    "todos"
+    "tasks"
+    "telemetry"
+    "downloads"
+    "history.jsonl"
+    ".DS_Store"
+    "statsig"
+    "memory.db"
+    "memory.db-wal"
+    "memory.db-shm"
+    "plugins/marketplaces"
+    "plugins/cache"
+)
+```
+
+### 3.2 Copiar Tudo Exceto Exclusões
+
+```bash
+# Construir padrão de exclusão para rsync
+EXCLUDE_PATTERN=""
+for item in "${CLAUDE_EXCLUDES[@]}"; do
+    EXCLUDE_PATTERN="$EXCLUDE_PATTERN --exclude=$item"
+done
+
+# Copiar TUDO de ~/.claude/ exceto exclusões
+rsync -av $EXCLUDE_PATTERN ~/.claude/ "$PAYLOAD_DIR/.claude/"
+```
+
+**Resultado:** Tudo que existir em ~/.claude/ vai para o ZIP automaticamente.
+- Novo skill? ✅ Incluído
+- Novo command? ✅ Incluído
+- Novo template? ✅ Incluído
+- Novo hook? ✅ Incluído
+
+---
+
+## FASE 4: COPIAR ~/copywriting-ecosystem/ (Descoberta Automática)
+
+### 4.1 Definir Exclusões
+
+```bash
+ECO_EXCLUDES=(
+    ".git"
+    "worktrees"
+    ".DS_Store"
+    "node_modules"
+    "__pycache__"
+    "*.pyc"
+    ".claude/debug"
+    ".claude/cache"
+    ".claude/plans"
+    ".claude/session-env"
+    ".claude/shell-snapshots"
+    ".claude/file-history"
+    ".claude/projects"
+    ".claude/paste-cache"
+    ".claude/todos"
+    ".claude/tasks"
+    ".claude/telemetry"
+    ".claude/downloads"
+    ".claude/history.jsonl"
+    ".claude/statsig"
+    ".claude/memory.db*"
+    ".claude/plugins/marketplaces"
+    ".claude/plugins/cache"
+)
+```
+
+### 4.2 Copiar Tudo Exceto Exclusões
+
+```bash
+# Construir padrão de exclusão
+EXCLUDE_PATTERN=""
+for item in "${ECO_EXCLUDES[@]}"; do
+    EXCLUDE_PATTERN="$EXCLUDE_PATTERN --exclude=$item"
+done
+
+# Copiar TUDO de ~/copywriting-ecosystem/ exceto exclusões
+rsync -av $EXCLUDE_PATTERN ~/copywriting-ecosystem/ "$PAYLOAD_DIR/copywriting-ecosystem/"
+```
+
+**Resultado:**
+- Scripts? ✅ Incluídos
+- Templates? ✅ Incluídos
+- Ofertas? ✅ Incluídas
+- Qualquer novo arquivo? ✅ Incluído
+
+### 4.3 Opção --no-offers (MACRO: Auto-Descoberta)
+
+Se usuário passar `--no-offers`:
+```bash
+# Descobrir ofertas automaticamente e adicionar à exclusão
+for offer in $(~/.claude/scripts/discover-components.sh --list-offers); do
+    ECO_EXCLUDES+=("$offer")
+done
+
+# Resultado: TODAS as ofertas excluídas, independente de quantas existem
+# Nunca precisará editar este comando ao adicionar novas ofertas
+```
+
+> **REGRA MACRO:** Nunca hardcodar lista de ofertas. Usar auto-descoberta.
+
+---
+
+## FASE 5: ADICIONAR SCRIPTS DE INSTALAÇÃO
+
+```bash
+# Copiar scripts para raiz do installer
+cp ~/copywriting-ecosystem/scripts/install.sh "$BUILD_DIR/ecossistema-v${VERSION}-installer/"
+cp ~/copywriting-ecosystem/scripts/diagnose.sh "$BUILD_DIR/ecossistema-v${VERSION}-installer/"
+
+# Criar README rápido
+cat > "$BUILD_DIR/ecossistema-v${VERSION}-installer/README.md" << 'EOF'
+# Ecossistema de Copywriting v${VERSION}
+
+## Instalação Rápida
+
+```bash
+./install.sh
+```
+
+## Diagnóstico
+
+```bash
+./diagnose.sh
+./diagnose.sh --quick
+./diagnose.sh --fix
+```
+
+## Estrutura
+
+- `payload/.claude/` → Copia para `~/.claude/`
+- `payload/copywriting-ecosystem/` → Copia para `~/copywriting-ecosystem/`
+
+## Documentação
+
+Ver `payload/.claude/TUTORIAL-COMO-USAR.md` após instalação.
+EOF
+```
+
+---
+
+## FASE 6: GERAR ZIP
+
+```bash
+cd "$BUILD_DIR"
+
+# Criar ZIP
+zip -r "$ZIP_NAME" "ecossistema-v${VERSION}-installer/" \
+    -x "*.DS_Store" \
+    -x "__MACOSX/*"
+
+# Mover para Desktop
+mv "$ZIP_NAME" ~/Desktop/
+
+echo "✅ ZIP gerado: ~/Desktop/$ZIP_NAME"
+```
+
+---
+
+## FASE 7: VALIDAÇÃO AUTOMÁTICA
+
+### 7.1 Verificar Estrutura do ZIP
+
+```bash
+echo "=== Validando ZIP ==="
+
+# Contar componentes
+SKILLS=$(unzip -l ~/Desktop/$ZIP_NAME | grep "skills/" | grep -c "SKILL.md")
+COMMANDS=$(unzip -l ~/Desktop/$ZIP_NAME | grep "commands/" | grep -c "\.md")
+AGENTS=$(unzip -l ~/Desktop/$ZIP_NAME | grep "agents/" | grep -c "\.md")
+HOOKS=$(unzip -l ~/Desktop/$ZIP_NAME | grep "hooks/" | grep -c "\.ts")
+TEMPLATES=$(unzip -l ~/Desktop/$ZIP_NAME | grep "\.claude/templates/" | grep -c "\.md")
+
+echo "Skills: $SKILLS"
+echo "Commands: $COMMANDS"
+echo "Agents: $AGENTS"
+echo "Hooks: $HOOKS"
+echo "Templates: $TEMPLATES"
+
+# Verificar arquivos críticos
+CRITICAL_FILES=(
+    "CLAUDE.md"
+    ".version"
+    "CHANGELOG.md"
+    "ecosystem-status.md"
+    "TUTORIAL-COMO-USAR.md"
+    "install.sh"
+    "diagnose.sh"
+)
+
+for file in "${CRITICAL_FILES[@]}"; do
+    if unzip -l ~/Desktop/$ZIP_NAME | grep -q "$file"; then
+        echo "✅ $file"
+    else
+        echo "❌ $file FALTANDO"
+    fi
+done
+```
+
+### 7.2 Mostrar Estatísticas
+
+```bash
+# Tamanho do ZIP
+SIZE=$(ls -lh ~/Desktop/$ZIP_NAME | awk '{print $5}')
+FILES=$(unzip -l ~/Desktop/$ZIP_NAME | tail -1 | awk '{print $2}')
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Ecossistema v$VERSION"
+echo "  Arquivos: $FILES"
+echo "  Tamanho: $SIZE"
+echo "  Local: ~/Desktop/$ZIP_NAME"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+```
+
+---
+
+## FASE 8: ATUALIZAR CHANGELOG
+
+Adicionar entrada automática em `~/.claude/CHANGELOG.md`:
+
+```markdown
+## [v{VERSION}] - {DATA}
+
+### Atualizado
+- Backup completo do ecossistema gerado via /update-ecosystem
+- Inclui: {SKILLS} skills, {COMMANDS} commands, {AGENTS} agents
+- Ofertas: [lista se incluídas]
+
+### Arquivos no ZIP
+- {FILES} arquivos totais
+- Tamanho: {SIZE}
+```
+
+---
+
+## FASE 9: CLEANUP
+
+```bash
+rm -rf "$BUILD_DIR"
+echo "✅ Build directory removido"
+```
+
+---
+
+## Uso
+
+```bash
+# Backup completo (com ofertas)
+/update-ecosystem
+
+# Apenas verificar o que seria incluído
+/update-ecosystem --check
+
+# Sem ofertas (só infraestrutura)
+/update-ecosystem --no-offers
+```
+
+---
+
+## Por Que Essa Abordagem Funciona
+
+| Antes (Micro) | Agora (Macro) |
+|---------------|---------------|
+| Lista hardcoded de arquivos | Descoberta automática |
+| Adicionar skill = editar comando | Adicionar skill = nada a fazer |
+| Versão hardcoded no código | Versão lida de .version |
+| Esquece arquivos novos | Inclui tudo automaticamente |
+
+**Única manutenção necessária:** Adicionar item à lista de EXCLUSÕES se criar novo tipo de auto-gerado.
+
+---
+
+## Exclusões (Referência)
+
+Estes são os únicos arquivos/diretórios excluídos:
+
+| Diretório | Razão |
+|-----------|-------|
+| debug/ | Logs de debug (auto-gerado) |
+| cache/ | Cache temporário |
+| plans/ | Arquivos de planejamento de sessão |
+| session-env/ | Estado de sessão |
+| shell-snapshots/ | Snapshots de ambiente |
+| file-history/ | Histórico de arquivos |
+| projects/ | Metadata local |
+| paste-cache/ | Clipboard |
+| todos/ | Todo lists de sessão |
+| tasks/ | Tarefas de sessão |
+| telemetry/ | Telemetria de uso |
+| downloads/ | Downloads temporários |
+| history.jsonl | Histórico de sessão |
+| .git/ | Controle de versão |
+| worktrees/ | Git worktrees |
+| statsig/ | Feature flags |
+| memory.db* | Database local (claude-mem) |
+| plugins/marketplaces/ | Cache de plugins (188MB - auto-baixado) |
+| plugins/cache/ | Cache de plugins |
+
+**Tudo mais = INCLUÍDO automaticamente.**
+
+---
+
+*Comando redesenhado: 2026-01-23 | Filosofia: Descoberta Automática + Exclusão Explícita*

package/framework/commands/validate-batch.md

@@ -0,0 +1,231 @@
+---
+description: Validate all units of a deliverable in parallel (VSL chapters, LP blocks, etc.)
+argument-hint: "<type> [--offer <name>] [--format yaml|json|md]"
+---
+
+# /validate-batch — Batch Validation Command
+
+Validates all units of a deliverable (VSL chapters, LP blocks, creatives, emails) in parallel
+using subagents, then aggregates results with outlier detection.
+
+> **S32 Integration:** After collecting MCP scores, each unit is also scored with
+> `quality-score.ts` to produce a unified Quality Score (0-10) with per-deliverable
+> weights. The batch summary includes mean Quality Score and flags units below 7.0.
+
+## Usage
+
+```
+/validate-batch <type> [--offer <name>] [--format yaml|json|md]
+```
+
+## Types
+
+| Type | Units | Validation |
+|------|-------|------------|
+| `vsl` | All VSL chapters | blind_critic + emotional_stress_test |
+| `lp` | All LP blocks (14) | blind_critic |
+| `creatives` | All creatives | blind_critic + emotional_stress_test |
+| `emails` | All emails in sequence | blind_critic |
+
+## Process
+
+### Step 1: Detect Offer
+
+```bash
+# Resolve offer from $ARGUMENTS or current context
+ARGS="$ARGUMENTS"
+
+# Extract --offer flag if present
+if echo "$ARGS" | grep -q "\-\-offer"; then
+  OFFER=$(echo "$ARGS" | grep -oP '\-\-offer\s+\K\S+')
+else
+  # Detect from current-offer.json
+  OFFER=$(cat ~/.claude/session-state/current-offer.json 2>/dev/null | grep -oP '"offer":\s*"\K[^"]+')
+fi
+
+TYPE=$(echo "$ARGS" | awk '{print $1}')
+
+echo "Offer: $OFFER | Type: $TYPE"
+```
+
+If offer cannot be detected, stop and ask the user.
+
+### Step 2: Scan for Deliverable Files
+
+```bash
+# Determine scan path by type
+case "$TYPE" in
+  vsl)       SCAN_PATH="*/production/vsl/" ;;
+  lp)        SCAN_PATH="*/production/landing-page/blocks/" ;;
+  creatives) SCAN_PATH="*/production/creatives/" ;;
+  emails)    SCAN_PATH="*/production/emails/" ;;
+  *)         echo "Unknown type: $TYPE"; exit 1 ;;
+esac
+
+find ~/copywriting-ecosystem -path "*/$OFFER/$SCAN_PATH*.md" -type f | sort
+```
+
+If no files are found, report clearly and stop.
+
+### Step 3: Dispatch Parallel Subagents
+
+For each file found, dispatch a `general-purpose` subagent to run the appropriate validation
+MCPs. Run all subagents in parallel (max 6 concurrent — see `~/.claude/config/batch-validation.yaml`).
+
+Each subagent receives:
+
+```
+TASK: Validate deliverable unit
+FILE: {absolute_path_to_file}
+TYPE: {vsl|lp|creatives|emails}
+OFFER: {offer_name}
+
+INSTRUCTIONS:
+1. Read the file completely using the Read tool.
+2. Run blind_critic MCP on the full content.
+   - copy_type: map type to appropriate value (vsl->chapter, lp->block, creatives->creative, emails->email)
+3. For types vsl/creatives: also run emotional_stress_test MCP.
+4. Return results as YAML:
+
+   name: "{file_basename}"
+   blind_critic: {score}
+   emotional_stress_test: {score_or_null}
+   timestamp: "{ISO_timestamp}"
+   notes: "{any_specific_feedback}"
+```
+
+### Step 4: Collect Results
+
+Wait for all subagents to complete (timeout: 120s per item per config).
+
+Assemble a batch results YAML file:
+
+```yaml
+batch_id: "batch-{YYYY-MM-DD}"
+offer: "{offer}"
+type: "{type}"
+items:
+  - name: "{unit_name}"
+    blind_critic: {score}
+    emotional_stress_test: {score_or_null}
+    timestamp: "{ISO}"
+  # ... one entry per file
+```
+
+Write to: `/tmp/batch-{offer}-{type}-{date}.yaml`
+
+### Step 5: Aggregate and Report
+
+```bash
+bun run ~/copywriting-ecosystem/scripts/batch-validator.ts report /tmp/batch-{offer}-{type}-{date}.yaml
+```
+
+Display the consolidated report inline.
+
+### Step 5b: Compute Unified Quality Score per Unit (S32)
+
+For each item in the batch results, run `quality-score.ts` with the collected MCP scores
+to produce a unified Quality Score:
+
+```bash
+# Map batch type to quality-score deliverable type
+# vsl → vsl-chapter | lp → lp-block | creatives → creative | emails → email | mup-mus → mup-mus
+
+bun run ~/copywriting-ecosystem/scripts/quality-score.ts \
+  --type {mapped-type} \
+  --bc {blind_critic} \
+  --est {emotional_stress_test_or_omit} \
+  --bv {black_validation_or_omit} \
+  --json
+```
+
+Append the `quality_score` field to each item in the batch YAML:
+
+```yaml
+items:
+  - name: "capitulo-1"
+    blind_critic: 8.2
+    emotional_stress_test: 8.0
+    quality_score: 8.14          # ← added by Step 5b
+    quality_verdict: "EXCELLENT" # ← added by Step 5b
+```
+
+Flag any unit with `quality_score < 7.0` as `quality_flag: true` for targeted review.
+
+### Step 6: Write Scores to Frontmatter
+
+For each file that has existing YAML frontmatter (starts with `---`), update the scores
+section with the validated results so future `summary` commands can read them:
+
+```yaml
+# Add or update inside the existing frontmatter's scores: block
+scores:
+  blind_critic: {score}
+  emotional_stress_test: {score_or_null}
+```
+
+If the file has no frontmatter, skip this step and note it in the output.
+
+### Step 7: Final Assessment
+
+Present a summary verdict:
+
+| Condition | Verdict | Next Action |
+|-----------|---------|-------------|
+| All pass (BC ≥8, EST ≥8) | BATCH PASSED | Advance to black_validation or delivery |
+| Any below threshold | BATCH NEEDS_REVISION | List failing units with targeted fix |
+| Outliers detected | REVIEW OUTLIERS | Investigate outlier units specifically |
+
+## Expected Output
+
+```yaml
+command: validate-batch
+offer: "{offer}"
+type: "{type}"
+batch_id: "batch-{date}"
+results_file: "/tmp/batch-{offer}-{type}-{date}.yaml"
+stats:
+  total: {N}
+  passed: {N}
+  failed: {N}
+  outliers: {N}
+  mean_bc: {X.X}
+  mean_est: {X.X}
+verdict: "BATCH PASSED|BATCH NEEDS_REVISION|REVIEW OUTLIERS"
+next_step: "{action}"
+```
+
+## Error Handling
+
+- If a subagent times out (>120s): mark item as `timeout: true`, continue with others
+- If blind_critic MCP fails: retry once, then mark as `error: true`
+- If fewer than 3 items found: warn that batch mode may not be necessary (min_items_to_trigger: 3)
+- Always produce a partial report if at least 1 item was validated
+
+## Config Reference
+
+Config file: `~/.claude/config/batch-validation.yaml`
+Script reference: `~/copywriting-ecosystem/scripts/batch-validator.ts`
+
+```bash
+# Manual aggregation commands
+bun run ~/copywriting-ecosystem/scripts/batch-validator.ts report <file>
+bun run ~/copywriting-ecosystem/scripts/batch-validator.ts summary <offer> <type>
+bun run ~/copywriting-ecosystem/scripts/batch-validator.ts outliers <offer> <type>
+
+# Quality Score per unit (S32)
+bun run ~/copywriting-ecosystem/scripts/quality-score.ts --type vsl-chapter --bc 8.2 --est 8.0
+bun run ~/copywriting-ecosystem/scripts/quality-score.ts --weights vsl-chapter
+bun run ~/copywriting-ecosystem/scripts/quality-score.ts --type creative --bc 8.5 --est 7.0 --logo pass --json
+```
+
+## Quality Gates
+
+Before marking batch validation complete:
+
+- [ ] All units validated (or documented why any were skipped)
+- [ ] No items with BC < 8.0 remaining unaddressed
+- [ ] No items with EST < 8.0 (for vsl/creatives) remaining unaddressed
+- [ ] Outlier units reviewed and action decided
+- [ ] Results file written to /tmp/batch-{offer}-{type}-{date}.yaml
+- [ ] Scores written back to frontmatter where applicable

package/framework/commands/validate.md

@@ -0,0 +1,29 @@
+# /validate — Run Quality Gate for Current Phase
+
+Read the active offer's helix-state.yaml to determine current phase, then:
+
+1. Load the appropriate task file from `~/.claude/tasks/`:
+   - RESEARCH phase → `~/.claude/tasks/research-quality-gate.md`
+   - BRIEFING phase → `~/.claude/tasks/briefing-quality-gate.md`
+   - PRODUCTION phase → `~/.claude/tasks/production-quality-gate.md`
+   - DELIVERED phase → `~/.claude/tasks/delivery-quality-gate.md`
+
+2. Read the task file completely.
+
+3. Create a TaskCreate checklist with ALL steps from the task file.
+
+4. Execute each step sequentially:
+   - For file verification steps: use Glob/Read to check existence
+   - For MCP steps: use the appropriate MCP tool (validate_gate, blind_critic, etc)
+   - For human approval: use AskUserQuestion
+
+5. After all steps, present a summary:
+   - PASSED items (with scores where applicable)
+   - FAILED items (with specific feedback)
+   - RECOMMENDATION: advance phase or fix issues
+
+If no offer is detected, show error and suggest `/status` or `ecosystem-guide`.
+
+Arguments:
+- $ARGUMENTS can specify offer path: `/validate concursos/decifra-lei-seca`
+- If no argument, detect from current-offer.json or most recent offer

package/framework/config/batch-validation.yaml

@@ -0,0 +1,59 @@
+# Batch Validation Engine Config — S46
+# Part of AIOS Upgrade Plan v4.0 § S46
+# Enables parallel validation of multiple deliverable units (VSL chapters, LP blocks, etc.)
+# Created: 2026-03-01
+
+version: "1.0"
+name: batch-validation
+
+batch_validator:
+  max_parallel_jobs: 6
+  subagent_type: general-purpose
+  timeout_per_item_seconds: 120
+
+  aggregation:
+    outlier_threshold: 1.5  # stdev — items this far from mean flagged as outliers
+    report_format: yaml     # yaml | json | md
+
+  integration:
+    auto_batch_on_production: true
+    min_items_to_trigger: 3  # below this, validate sequentially (not worth batching)
+
+# ═══════════════════════════════════════════
+# THRESHOLDS (mirrors quality.thresholds in framework-config.yaml)
+# ═══════════════════════════════════════════
+
+thresholds:
+  blind_critic_min: 8.0
+  emotional_stress_test_min: 8.0
+  black_validation_min: 8.0
+
+# ═══════════════════════════════════════════
+# DELIVERABLE TYPE DEFINITIONS
+# ═══════════════════════════════════════════
+# Defines which production subdirectory to scan and how many units to expect.
+
+types:
+  vsl:
+    path: "production/{offer}/vsl/"
+    expected_units: 8
+    unit_label: "capitulo"
+    metrics: [blind_critic, emotional_stress_test]
+
+  lp:
+    path: "production/{offer}/landing-page/blocks/"
+    expected_units: 14
+    unit_label: "bloco"
+    metrics: [blind_critic]
+
+  creatives:
+    path: "production/{offer}/creatives/"
+    expected_units: 5
+    unit_label: "criativo"
+    metrics: [blind_critic, emotional_stress_test]
+
+  emails:
+    path: "production/{offer}/emails/"
+    expected_units: 7
+    unit_label: "email"
+    metrics: [blind_critic]