@lucapimenta/copy-chief-black 1.0.0

package/framework/copy-surface-criteria.yaml

@@ -0,0 +1,101 @@
+# copy-surface-criteria.yaml
+# Surface Checker criteria for DR Copy production pipeline
+# Adapted from AIOS bob-surface-criteria.yaml for copywriting context
+# Part of P0: Surface Checker (AIOS Gap Closure)
+# Created: 2026-02-24
+
+version: "1.0.0"
+description: "Criteria defining when AI should surface decisions to human during copy production"
+
+# Evaluation order: most critical first (first-match-wins)
+evaluation_order:
+  - C005_SCOPE_CHANGE
+  - C004_ESCALATION
+  - C001_MUP_SELECTION
+  - C002_MUS_NAMING
+  - C003_FINAL_APPROVAL
+
+criteria:
+  C001_MUP_SELECTION:
+    description: "MUP selection requires human strategic decision"
+    condition: "phase == 'BRIEFING' AND deliverable IN mup_deliverables"
+    action: multiple_choice
+    priority: HIGH
+    blocking: false
+    bypass: false
+    message: "MUP Selection: {candidate_count} candidatos identificados. Escolha o MUP para '{offer_name}'."
+    context_fields:
+      - candidates
+      - consensus_result
+      - scores
+    auto_resolve_after_hours: 24
+    auto_resolve_choice: "highest_score"
+
+  C002_MUS_NAMING:
+    description: "MUS naming (Gimmick Name, Authority Hook) requires human approval"
+    condition: "phase == 'BRIEFING' AND deliverable IN mus_deliverables"
+    action: explicit_confirm
+    priority: HIGH
+    blocking: false
+    bypass: false
+    message: "MUS Naming: Gimmick Name '{gimmick_name}' e Authority Hook '{authority_hook}' para '{offer_name}'. Aprovar?"
+    context_fields:
+      - gimmick_name
+      - authority_hook
+      - origin_story
+      - rmbc_scores
+    auto_resolve_after_hours: 24
+    auto_resolve_choice: "approve"
+
+  C003_FINAL_APPROVAL:
+    description: "Final deliverable approval after black_validation passes"
+    condition: "phase == 'PRODUCTION' AND black_validation_passed == true"
+    action: go_nogo
+    priority: MEDIUM
+    blocking: false
+    bypass: false
+    message: "Entrega Final: '{deliverable_type}' para '{offer_name}' passou black_validation (score: {score}). Entregar?"
+    context_fields:
+      - deliverable_type
+      - score
+      - lentes_scores
+    auto_resolve_after_hours: 48
+    auto_resolve_choice: "go"
+
+  C004_ESCALATION:
+    description: "Auto-production loop failed 3+ times — needs human direction"
+    condition: "loop_failures >= 3"
+    action: help_request
+    priority: CRITICAL
+    blocking: true
+    bypass: false
+    message: "ESCALATION: '{deliverable_type}' para '{offer_name}' falhou {loop_failures}x no auto-production loop. Problema pode ser estrategico (briefing) e nao tatico (copy). Direcao necessaria."
+    context_fields:
+      - deliverable_type
+      - loop_failures
+      - failure_reasons
+      - last_scores
+
+  C005_SCOPE_CHANGE:
+    description: "Scope change detected — requires explicit confirmation"
+    condition: "scope_change_detected == true"
+    action: explicit_confirm
+    priority: CRITICAL
+    blocking: true
+    bypass: false
+    message: "SCOPE CHANGE: Mudanca detectada em '{change_type}' para '{offer_name}'. {change_description}. Confirmar?"
+    context_fields:
+      - change_type
+      - change_description
+      - impact_assessment
+
+# Lists referenced by conditions
+lists:
+  mup_deliverables:
+    - fase05-problema-vilao-mup
+    - mecanismo-unico
+    - mup-selection
+  mus_deliverables:
+    - fase06-solucao-mus
+    - mecanismo-unico
+    - mus-naming

package/framework/core-config.yaml

@@ -0,0 +1,243 @@
+# Copy Squad AIOS Core Config
+# Forked from: github.com/SynkraAI/aios-core v4.4.6
+# Adapted: Copy Chief BLACK — Copywriting Direct Response
+# Date: 2026-03-02
+
+project:
+  type: COPY_SQUAD
+  version: 1.0.0
+  installedAt: '2026-03-02T00:00:00Z'
+  framework: aios-core-fork
+
+# Story-Driven Development
+stories:
+  location: ~/.claude/stories
+  activeStoryDetection: status_field  # looks for Status: PENDING|IN_PROGRESS
+  workflow:
+    - story_loader reads active story on SessionStart
+    - agent implements ONLY acceptance criteria
+    - agent updates checklist ([ ] → [x])
+    - story_complete checks on Stop
+  noInventionRule: true  # MUST NOT add features not in story
+
+# Agent Configuration
+agents:
+  location: ~/.claude/agents
+  format: AGENT.md + SOUL.md  # per-persona directory
+  activation:
+    method: keyword_routing  # via persona-router.ts hook
+    fallback: helix_decides  # if no keyword match
+  registry:
+    - id: vox
+      name: Vox
+      handle: "@researcher"
+      title: VOC Researcher
+      model: sonnet
+      icon: "🔍"
+      dir: agents/vox
+      triggers: [pesquisa, voc, avatar, quotes, publico, extrair]
+
+    - id: cipher
+      name: Cipher
+      handle: "@miner"
+      title: Pattern Miner
+      model: sonnet
+      icon: "🔎"
+      dir: agents/cipher
+      triggers: [concorrente, ads, spy, scale, pattern]
+
+    - id: atlas
+      name: Atlas
+      handle: "@briefer"
+      title: Persuasion Architect
+      model: opus
+      icon: "📐"
+      dir: agents/atlas
+      triggers: [briefing, helix, mup, mus, mecanismo, fase]
+
+    - id: blade
+      name: Blade
+      handle: "@producer"
+      title: Copy Producer
+      model: sonnet
+      icon: "⚔️"
+      dir: agents/blade
+      triggers: [produzir, escrever, copy, draft, email]
+
+    - id: echo
+      name: Echo
+      handle: "@vsl"
+      title: VSL Narrator
+      model: opus
+      icon: "🎬"
+      dir: agents/echo
+      triggers: [vsl, lead, capitulo, video, retencao]
+
+    - id: forge
+      name: Forge
+      handle: "@lp"
+      title: Landing Page Builder
+      model: sonnet
+      icon: "🔨"
+      dir: agents/forge
+      triggers: [landing page, lp, bloco, pagina de vendas]
+
+    - id: scout
+      name: Scout
+      handle: "@creative"
+      title: Creative Divergent
+      model: sonnet
+      icon: "🎯"
+      dir: agents/scout
+      triggers: [criativo, hook, angulo, formato, anuncio]
+
+    - id: hawk
+      name: Hawk
+      handle: "@critic"
+      title: Adversarial Validator
+      model: sonnet
+      icon: "🦅"
+      dir: agents/hawk
+      triggers: [validar, revisar, criticar, score, stress-test]
+
+    - id: sentinel
+      name: Sentinel
+      handle: "@gatekeeper"
+      title: Gate Guardian
+      model: haiku
+      icon: "🛡️"
+      dir: agents/sentinel
+      triggers: [gate, threshold, enforcement]
+
+    - id: helix
+      name: Helix
+      handle: "@chief"
+      title: Orchestrator
+      model: opus
+      icon: "🧬"
+      dir: agents/helix
+      triggers: [status, onde parei, proximo, pipeline, ecossistema]
+      direct: true  # no subagent — Helix IS main Claude
+
+# Constitution
+constitution:
+  file: ~/.claude/constitution.md
+  principles:
+    - id: story_driven
+      severity: BLOCK
+      rule: "Nenhum codigo/copy e produzido sem story ativa"
+      gate: story-loader.ts
+
+    - id: no_invention
+      severity: BLOCK
+      rule: "NAO adicionar features/deliverables nao presentes na story"
+
+    - id: agent_authority
+      severity: WARN
+      rule: "Cada persona tem autoridade exclusiva sobre seu dominio"
+      exclusivities:
+        vox: [research_extraction, voc_collection]
+        atlas: [briefing_phases, mup_definition]
+        hawk: [validation_verdicts, quality_scores]
+        sentinel: [gate_enforcement, threshold_checks]
+
+    - id: quality_first
+      severity: BLOCK
+      rule: "blind_critic >= 8, EST >= 8, black_validation >= 8"
+      gate: validate_gate
+
+    - id: cli_first
+      severity: WARN
+      rule: "Copy em ARQUIVO, nunca no terminal. Dashboard e observacional."
+
+# Handoff Rules (equivalent to AIOS story-driven workflow)
+handoffs:
+  detection: path_based  # via handoff-detector.ts
+  rules:
+    - pattern: "research/synthesis.md"
+      next_agent: atlas
+      message: "Research complete → Atlas for HELIX briefing"
+
+    - pattern: "briefings/helix-complete.md"
+      next_agent: blade
+      message: "Briefing complete → Blade for production"
+
+    - pattern: "mecanismo-unico.yaml"
+      condition: "state: VALIDATED"
+      next_agent: hawk
+      message: "Mecanismo validated → Hawk for approval"
+
+    - pattern: "production/*/drafts/*"
+      next_agent: hawk
+      message: "Draft produced → Hawk for validation"
+
+    - pattern: "production/reviews/*"
+      condition: "PASS"
+      next_agent: helix
+      message: "Review passed → Helix for delivery"
+
+# Context Injection (equivalent to AIOS devLoadAlwaysFiles)
+context:
+  always_load:
+    - ~/.claude/constitution.md
+    - ~/.claude/orchestrator.md
+    - ~/.claude/core-config.yaml
+
+  per_agent:
+    vox: [CONTEXT.md, synthesis.md, biblioteca_nicho]
+    atlas: [synthesis.md, mecanismo-unico.yaml]
+    blade: [helix-complete.md, synthesis.md, language-patterns.md]
+    hawk: ["production/drafts/*", helix-complete.md]
+    scout: [helix-complete.md, "swipes/criativos/*"]
+    forge: [helix-complete.md, "swipes/lp/*"]
+    echo: [helix-complete.md, synthesis.md]
+
+# Quality Gates (equivalent to AIOS quality gates)
+quality:
+  gates:
+    research:
+      required_tools: [firecrawl_agent, voc_search]
+      deliverables: [voc/summary.md, competitors/summary.md, mechanism/summary.md, avatar/summary.md, synthesis.md]
+      threshold: "confidence >= 70%"
+
+    briefing:
+      required_tools: [get_phase_context]
+      deliverables: [phases/fase-01.md through fase-10.md, helix-complete.md]
+      threshold: "mecanismo state = VALIDATED"
+
+    production:
+      required_tools: [blind_critic, emotional_stress_test]
+      threshold: "blind_critic >= 8 AND EST >= 8"
+
+    delivery:
+      required_tools: [black_validation]
+      threshold: "black_validation >= 8"
+
+# Hooks registered in settings.json
+hooks:
+  SessionStart:
+    - story-loader.ts       # AIOS: story detection + injection
+    - workflow-navigator.ts  # offer state detection
+    - active-offer-detector.ts
+
+  UserPromptSubmit:
+    - persona-router.ts     # AIOS: agent activation (WIRE Phase 2)
+
+  PostToolUse:
+    - handoff-detector.ts   # AIOS: story-driven handoff (WIRE Phase 3)
+
+  SubagentStart:
+    - subagent-context-inject.ts  # AIOS: context engineering (WIRE Phase 4)
+
+  Stop:
+    - story-complete.ts     # AIOS: completion check
+
+# Boundary Protection (equivalent to AIOS boundary mapping)
+boundary:
+  protected:
+    - ~/.claude/constitution.md
+    - ~/.claude/core-config.yaml
+    - ~/.claude/orchestrator.md
+  mutable:
+    - ~/.claude/stories/*
+    - ~/.claude/agents/*/MEMORY.md

package/framework/data/workflow-patterns.yaml

@@ -0,0 +1,252 @@
+# Workflow Patterns Definition — Copy Chief BLACK
+# Adapted from: aios-core/.aios-core/data/workflow-patterns.yaml
+#
+# Defines HELIX pipeline workflow sequences for context detection
+# and next-action recommendation.
+#
+# Version: 1.0
+# Created: 2026-03-02
+
+workflows:
+  # HELIX Pipeline — Complete offer lifecycle
+  helix_pipeline:
+    description: "Complete offer lifecycle from research to delivery"
+    agent_sequence:
+      - researcher   # VOC + competitors
+      - briefer      # HELIX 10 phases
+      - producer     # VSL + LP + Creatives + Emails
+      - critic       # Quality gates
+    key_commands:
+      - audience-research-agent
+      - voc-research-agent
+      - helix-system-agent
+      - production-agent
+      - landing-page-agent
+      - leads-agent
+      - criativos-agent
+      - validate
+      - pre-delivery
+    trigger_threshold: 2
+    typical_duration: "5-15 days"
+    success_indicators:
+      - "All deliverables produced"
+      - "black_validation >= 8"
+      - "Human approved"
+    transitions:
+      research_started:
+        trigger: "audience-research-agent started"
+        confidence: 0.90
+        greeting_message: "Research iniciada! Coletando VOC e concorrentes."
+        next_steps:
+          - command: voc-research-agent
+            args_template: "${offer_path}"
+            description: "Extrair VOC de YouTube, Reddit, Reclame Aqui"
+            priority: 1
+          - command: audience-research-agent
+            args_template: "${offer_path}"
+            description: "Pesquisa profunda de publico-alvo"
+            priority: 2
+      research_complete:
+        trigger: "validate research"
+        confidence: 0.90
+        greeting_message: "Research completa! Pronto para briefing HELIX."
+        next_steps:
+          - command: helix-system-agent
+            args_template: "${offer_path}"
+            description: "Iniciar briefing HELIX (10 fases)"
+            priority: 1
+          - command: validate
+            args_template: "research"
+            description: "Validar gate de research"
+            priority: 2
+      briefing_complete:
+        trigger: "validate briefing"
+        confidence: 0.85
+        greeting_message: "Briefing HELIX completo! Pronto para producao."
+        next_steps:
+          - command: production-agent
+            args_template: "${offer_path}"
+            description: "Iniciar producao de deliverables"
+            priority: 1
+          - command: validate
+            args_template: "briefing"
+            description: "Validar gate de briefing"
+            priority: 2
+      production_complete:
+        trigger: "validate production"
+        confidence: 0.80
+        greeting_message: "Producao completa! Pronto para review final."
+        next_steps:
+          - command: pre-delivery
+            args_template: "${offer_path}"
+            description: "Gate final de qualidade"
+            priority: 1
+          - command: validate
+            args_template: "production"
+            description: "Validar gate de producao"
+            priority: 2
+
+  # Research Phase Detail
+  research_workflow:
+    description: "Deep research: VOC extraction, competitor analysis, avatar profiling"
+    agent_sequence:
+      - researcher   # VOC
+      - miner        # Competitors
+      - researcher   # Synthesis
+    key_commands:
+      - audience-research-agent
+      - voc-research-agent
+      - helix-parallel
+      - squad-research
+    trigger_threshold: 1
+    transitions:
+      voc_started:
+        trigger: "voc-research-agent started"
+        confidence: 0.90
+        next_steps:
+          - command: audience-research-agent
+            description: "Perfil completo do avatar"
+            priority: 1
+          - command: helix-parallel
+            description: "Executar research em paralelo"
+            priority: 2
+      voc_complete:
+        trigger: "voc-research-agent completed"
+        confidence: 0.85
+        next_steps:
+          - command: validate
+            args_template: "research"
+            description: "Validar gate de research"
+            priority: 1
+
+  # Briefing Phase Detail
+  briefing_workflow:
+    description: "HELIX System 10-phase strategic briefing"
+    agent_sequence:
+      - briefer      # All 10 phases
+      - critic       # MUP/MUS validation
+    key_commands:
+      - helix-system-agent
+      - copy-critic
+      - conclave
+    trigger_threshold: 1
+    transitions:
+      helix_started:
+        trigger: "helix-system-agent started"
+        confidence: 0.90
+        next_steps:
+          - command: helix-system-agent
+            description: "Continuar fases HELIX"
+            priority: 1
+      mup_defined:
+        trigger: "MUP defined"
+        confidence: 0.85
+        next_steps:
+          - command: copy-critic
+            description: "Stress-test do MUP"
+            priority: 1
+          - command: conclave
+            description: "Validacao multi-persona do MUP"
+            priority: 2
+      helix_complete:
+        trigger: "validate briefing"
+        confidence: 0.90
+        next_steps:
+          - command: validate
+            args_template: "briefing"
+            description: "Passar gate de briefing"
+            priority: 1
+
+  # Production Phase Detail
+  production_workflow:
+    description: "Copy production: VSL, Landing Page, Creatives, Emails"
+    agent_sequence:
+      - vsl_producer     # VSL
+      - lp_producer      # Landing Page
+      - creative_producer # Creatives
+      - email_producer   # Emails
+      - critic           # Validation per deliverable
+    key_commands:
+      - production-agent
+      - landing-page-agent
+      - leads-agent
+      - criativos-agent
+      - produce-offer
+    trigger_threshold: 1
+    transitions:
+      production_started:
+        trigger: "production-agent started"
+        confidence: 0.90
+        next_steps:
+          - command: produce-offer
+            description: "Produzir todos os deliverables em paralelo"
+            priority: 1
+          - command: leads-agent
+            description: "Criar lead da VSL"
+            priority: 2
+      vsl_complete:
+        trigger: "VSL complete"
+        confidence: 0.85
+        next_steps:
+          - command: landing-page-agent
+            description: "Criar landing page"
+            priority: 1
+          - command: criativos-agent
+            description: "Criar criativos"
+            priority: 2
+      all_produced:
+        trigger: "validate production"
+        confidence: 0.80
+        next_steps:
+          - command: validate
+            args_template: "production"
+            description: "Gate de producao"
+            priority: 1
+          - command: pre-delivery
+            description: "Review final pre-entrega"
+            priority: 2
+
+  # Review Phase Detail
+  review_workflow:
+    description: "Quality review and final delivery"
+    agent_sequence:
+      - critic       # Quality validation
+      - chief        # Final routing
+    key_commands:
+      - validate
+      - pre-delivery
+      - review-all
+      - validate-batch
+    trigger_threshold: 1
+    transitions:
+      review_started:
+        trigger: "validate production"
+        confidence: 0.90
+        next_steps:
+          - command: review-all
+            description: "Review completo com multi-model"
+            priority: 1
+          - command: validate-batch
+            description: "Validar todos os blocos em paralelo"
+            priority: 2
+      review_complete:
+        trigger: "pre-delivery completed"
+        confidence: 0.95
+        next_steps:
+          - command: status
+            description: "Verificar status final"
+            priority: 1
+
+# State Integration
+state_integration:
+  description: "File-based state persistence for HELIX pipeline"
+  state_file_location: "{offer_path}/.aios/{instance-id}-state.yaml"
+  manager_module: "~/.claude/hooks/lib/aios/workflow-state-manager.ts"
+  behavior:
+    detection_priority:
+      - state_file
+      - command_history
+    session_continuity:
+      - "State persists between sessions via YAML"
+      - "Crash detection after 30min gap"
+      - "Resume with: /resume {offer}"