@lucapimenta/copy-chief-black 1.0.0

package/framework/commands/clone-expert.md

@@ -0,0 +1,283 @@
+---
+description: Clone a new copywriting expert's mind into the Copy Squad
+argument-hint: "[expert name or /path/to/content] (e.g., 'David Deutsch', '~/books/scientific-advertising.txt')"
+---
+
+# Clone Expert — Dynamic Mind Cloning
+
+**Input:** $ARGUMENTS
+
+You are the Copy Chief performing dynamic expert cloning. Two modes available:
+
+---
+
+## MODE A: Clone by Expert Name (Web Research)
+
+If `$ARGUMENTS` is a name (not a file path), perform web-based cloning.
+
+### Step 1: Parse Input
+
+Extract the expert name from `$ARGUMENTS`. If empty, ask the user who they want to clone.
+
+Generate a slug from the name (lowercase, hyphenated): "David Deutsch" → `deutsch`, "Stefan Georgi" → `georgi`, "Evaldo Albuquerque" → `albuquerque`.
+
+**Check if expert already exists:**
+```bash
+ls ~/.claude/copy-squad/${slug}.md 2>/dev/null
+```
+If exists, inform the user and ask if they want to UPDATE (enrich) or ABORT.
+
+### Step 2: Deep Research
+
+Use WebSearch to extract comprehensive information about this copywriter. Search for:
+
+1. `"[name]" copywriting frameworks techniques`
+2. `"[name]" direct response marketing method`
+3. `"[name]" copywriting books courses`
+4. `"[name]" best ads campaigns results`
+5. `"[name]" copywriting tips philosophy`
+
+From the research, extract:
+- **Core Philosophy** (what they believe about copy, 3-5 principles)
+- **Voice Patterns** (5-7 distinct writing techniques with DO/DON'T)
+- **Frameworks** (named methods, formulas, systems they created or are known for)
+- **Anti-Patterns** (what they would NEVER do, with reasons)
+- **Famous Works** (abstracted patterns from their best-known campaigns)
+- **Specialty Sections** (what parts of copy they're best at)
+- **Tier** (T0_DIAGNOSIS, T1_STRATEGIC, T2_EXECUTION, T3_SPECIALIZED, or AUDIT)
+
+### Step 3: Determine Tier and Sections
+
+Based on the expert's specialty, assign:
+
+| Expert Type | Tier | Example Sections |
+|-------------|------|-----------------|
+| Market analyst, researcher | T0_DIAGNOSIS | research, awareness, market_analysis |
+| Strategist, mechanism, big idea | T1_STRATEGIC | mecanismo, offer_stack, positioning |
+| Writer, copy execution | T2_EXECUTION | body_copy, bullets, hooks, close |
+| Specialist (launches, email, social) | T3_SPECIALIZED | launch, email, social_content |
+| Testing, validation | AUDIT | testing, validation, metrics |
+
+Assign 3-6 sections where this expert would be the primary voice.
+
+### Step 4: Generate Voice DNA Profile
+
+Write the profile to `~/.claude/copy-squad/${slug}.md` following Voice DNA v1.0 format:
+
+```markdown
+# [Full Name] - Voice DNA Profile
+
+> **Sections:** [section1, section2, ...]
+> **Tier:** [tier]
+> **Token Budget:** ~300 tokens injected per section
+> **Core Identity:** [1-2 sentence essence of this expert]
+
+---
+
+## Core Philosophy
+
+[3-5 paragraphs capturing their fundamental beliefs about copy]
+
+---
+
+## Voice Patterns
+
+### 1. [Pattern Name]
+[Description]
+**DO:** [list]
+**DON'T:** [list]
+
+[... 5-7 patterns total ...]
+
+---
+
+## Frameworks Extraidos
+
+### F1: [Framework Name]
+[Complete framework with structure, when to use, application]
+
+[... 3-5 frameworks ...]
+
+---
+
+## Anti-Patterns (What [Name] Would NEVER Do)
+
+| Pattern | Why It Fails |
+|---------|-------------|
+| ... | ... |
+
+---
+
+## Injection Prompt (~300 tokens)
+
+When producing sections assigned to [Name], inject these constraints:
+
+\```
+VOICE: [Full Name] -- [Core Identity]
+- [constraint 1]
+- [constraint 2]
+- [... 15-25 lines of specific constraints]
+- FINAL CHECK: [specific rewrite trigger]
+\```
+
+---
+
+*Voice DNA v1.0 -- [Full Name] Profile*
+*Sections: [sections]*
+*Cloned: [date]*
+```
+
+### Step 5: Generate Checklist
+
+Write a practical checklist to `~/.claude/copy-squad/checklists/${slug}-primary.md`:
+
+```markdown
+# [Full Name] - Primary Checklist
+
+> **Expert:** [name]
+> **Use for:** [sections]
+> **Cross-ref:** `~/.claude/copy-squad/${slug}.md`
+
+---
+
+## Checklist (20 items)
+
+### [Category 1] (4 checks)
+- [ ] [item]
+...
+
+### [Category 2] (4 checks)
+...
+
+[... 5 categories x 4 items = 20 checks ...]
+
+---
+
+## Scoring
+| Range | Grade |
+|-------|-------|
+| 18-20 | Expert-Grade |
+| 14-17 | Strong |
+| 10-13 | Needs Work |
+| <10 | Rewrite |
+```
+
+### Step 6: Update Manifest
+
+Read `~/.claude/copy-squad/manifest.yaml` and add the new expert:
+
+1. Add to the appropriate tier list
+2. Add expert profile entry under `experts:`
+3. Add to relevant `decision_tree` entries based on their specialty
+
+### Step 7: Regenerate Index
+
+```bash
+bun run ~/.claude/scripts/expert-etl.ts --index
+```
+
+### Step 8: Validate
+
+```bash
+bun run ~/.claude/scripts/expert-etl.ts --validate --report
+```
+
+If validation passes, confirm to user:
+
+```
+Expert [Name] clonado com sucesso!
+- Profile: ~/.claude/copy-squad/${slug}.md ([X] linhas)
+- Checklist: ~/.claude/copy-squad/checklists/${slug}-primary.md
+- Tier: [tier]
+- Sections: [sections]
+- Disponivel para routing via /expert
+```
+
+If validation has errors, fix them before confirming.
+
+### Step 9: Discovery Mode (when called from /expert)
+
+If the Copy Chief router scores ALL existing experts below 60 for a given task, the system should suggest:
+
+> "Nenhum expert atual tem score alto para [task]. Posso descobrir quem seria ideal.
+> Use `/clone-expert [suggested name]` para clonar."
+
+The suggestion should come from WebSearch: `"best copywriter for [task type]"`.
+
+---
+
+## MODE B: Clone from Content File (System Cloning Pipeline)
+
+If `$ARGUMENTS` is a file path (starts with `/`, `~`, or `./`), run the system cloning pipeline.
+
+### What it Does
+
+1. Reads content from specified path
+2. Extracts DNA (5 layers: Philosophy, Frameworks, Heuristics, Methodologies, Dilemmas)
+3. Converts frameworks to skill drafts
+4. Detects implicit roles/personas
+5. Generates operational playbook
+6. Suggests enrichments to existing expert profiles
+7. Outputs full report to `~/.claude/knowledge/cloned/`
+
+### Running the Pipeline
+
+```bash
+bun run ~/copywriting-ecosystem/scripts/system-cloning/index.ts <path-to-content>
+```
+
+**Options:**
+- `--output <dir>` — Custom output directory
+- `--skip dna,frameworks,roles,playbook,enrich` — Skip specific stages
+- `--verbose` — Detailed logging
+
+### Quality Gate
+
+| Threshold | Status | Meaning |
+|-----------|--------|---------|
+| < 100h estimated reading time | ⚠️ INSUFFICIENT_DATA | DNA extraction is **SPECULATIVE** |
+| >= 100h estimated reading time | ✅ SUFFICIENT_DATA | DNA extraction is **RELIABLE** |
+
+Track total ingested content:
+```bash
+bun run ~/copywriting-ecosystem/scripts/system-cloning/quality-threshold.ts status
+```
+
+### Output Files
+
+| File | Contents |
+|------|----------|
+| `dna-report.yaml` | 5-layer DNA extraction with scores (1-10 per layer) |
+| `skill-drafts.md` | Generated skill structures from frameworks |
+| `skill-drafts/` | Individual high-confidence skill markdown files |
+| `roles-detected.md` | Detected personas mapped to Copy Squad |
+| `playbook.md` | Operational playbook (triggers, steps, constraints, validation) |
+| `enrichment-suggestions.md` | Append-only suggestions for existing expert profiles |
+
+### DNA Layer Scores
+
+| Score | Meaning |
+|-------|---------|
+| 1-3 | Minimal — content barely touches this layer |
+| 4-5 | Sparse — some relevant content |
+| 6-7 | Moderate — useful but not rich |
+| 8-9 | Rich — strong layer for this content |
+| 10 | Saturated — dominant layer |
+
+### Post-Pipeline Actions
+
+After the pipeline completes:
+
+1. **Review `dna-report.yaml`** — Check which layers scored highest
+2. **Review `skill-drafts.md`** — High-confidence skills may be promoted to `~/.claude/skills/`
+3. **Review `roles-detected.md`** — Unmapped roles may suggest new personas
+4. **Review `enrichment-suggestions.md`** — Apply relevant additions to expert profiles
+5. **Review `playbook.md`** — Incorporate useful rules into existing rules files
+
+All outputs are DRAFT status — human review required before promotion.
+
+---
+
+*Clone Expert v2.0 — Mode A (web research) + Mode B (system cloning pipeline)*
+*Ref: ~/.claude/rules/anti-sycophancy.md — validate outputs adversarially*
+*Ref: ~/copywriting-ecosystem/scripts/system-cloning/index.ts*

package/framework/commands/conclave.md

@@ -0,0 +1,55 @@
+# /conclave — Multi-Persona Deliberation
+
+Convoke a Conclave of Copy Squad personas to deliberate on a strategic decision.
+
+## Usage
+```
+/conclave "MUP Selection" --members atlas,hawk,vox --context "3 MUP candidates for florayla"
+/conclave --check-stuck <offer>     # detect if stuck and recommend Conclave
+/conclave --history                 # show past Conclave decisions
+```
+
+## Steps
+
+1. Parse arguments:
+   - Topic: first quoted string or first argument
+   - Members: --members comma-separated list (atlas, hawk, vox, blade, scout, forge, echo, cipher, helix)
+   - Context: --context string with relevant data
+   - If `--check-stuck`: detect production stuck loops
+
+2. If `--check-stuck`:
+   ```bash
+   bun run ~/copywriting-ecosystem/scripts/conclave.ts --check-stuck $ARGUMENTS
+   ```
+   - Scan production/ files for scores below threshold
+   - If 2+ failures → recommend Conclave with topic and members
+
+3. If `--history`:
+   ```bash
+   bun run ~/copywriting-ecosystem/scripts/conclave.ts --history
+   ```
+
+4. Normal Conclave flow:
+   a. Validate required members per decision type (ref: ~/.claude/rules/conclave.md)
+   b. Generate structured Conclave prompt:
+      - Topic + Context
+      - Each member's perspective (loaded from ~/.claude/agents/{persona}/)
+      - Position statement template (200 tokens max each)
+   c. Execute Conclave protocol:
+      - Phase 1: Present topic to all members
+      - Phase 2: Each persona states position independently
+      - Phase 3: Cross-examination (max 2 rounds)
+      - Phase 4: Vote (AGREE/DISAGREE/ABSTAIN)
+      - Phase 5: Record decision
+   d. If unanimous → activate Devil's Advocate (S35.6)
+   e. Record to .conclave-history.yaml
+   f. If appropriate, follow up with MCP zen consensus for external validation
+
+5. Display result:
+   - Decision summary
+   - Vote breakdown
+   - Dissenting opinions preserved
+   - Next action recommendation
+
+Ref: ~/.claude/rules/conclave.md for full protocol
+Sprint: S35 — Conclave Architecture

package/framework/commands/create-offer.md

@@ -0,0 +1,245 @@
+---
+description: Create new offer project structure via guided pipeline
+argument-hint: "<nicho> <oferta>"
+---
+
+# Create Offer Pipeline
+
+Creates a complete offer structure for: $ARGUMENTS
+
+This command runs a 3-step pipeline:
+1. **create-niche-pack.ts** — Generates niche library and templates (if niche is new)
+2. **offer-elicitation.ts** — Generates YAML setup template, human fills it, then scaffolds offer
+3. **workflow-generator.ts** — Generates `workflow.yaml` for bob-orchestrator to consume
+
+---
+
+## Step 0: Parse Arguments
+
+```bash
+NICHO=$(echo "$ARGUMENTS" | cut -d' ' -f1)
+OFERTA=$(echo "$ARGUMENTS" | cut -d' ' -f2)
+BASE=~/copywriting-ecosystem/$NICHO/$OFERTA
+NICHE_LIBRARY=~/copywriting-ecosystem/$NICHO/biblioteca_nicho_${NICHO}_CONSOLIDADA.md
+```
+
+---
+
+## Step 1: Create Niche Pack (if niche is new)
+
+Check whether the niche library already exists:
+
+```bash
+if [ ! -f "$NICHE_LIBRARY" ]; then
+  echo "Niche '$NICHO' is new — generating niche expansion pack..."
+  bun run ~/.claude/scripts/create-niche-pack.ts --niche "$NICHO" --offer "$OFERTA"
+else
+  echo "Niche '$NICHO' already exists — skipping niche pack creation."
+  echo "Library: $NICHE_LIBRARY"
+fi
+```
+
+`create-niche-pack.ts` generates:
+- `$NICHO/biblioteca_nicho_${NICHO}_CONSOLIDADA.md` — Niche library skeleton
+- `$NICHO/_templates/` — Niche-adapted templates (voc extraction, ads spy, etc.)
+- If `--offer` is also passed: full offer scaffolding (CONTEXT.md, helix-state.yaml, mecanismo-unico.yaml, task_plan.md, full directory tree)
+
+**When niche already exists**, skip this step entirely to avoid overwriting an existing library.
+
+---
+
+## Step 1.5: 3-Pass Exploration (AIOS Pattern)
+
+Before scaffolding the offer, run a structured 3-pass exploration to map the territory. This prevents creating in a vacuum.
+
+### Pass 1: Topologia do Nicho
+Read the niche library (`biblioteca_nicho_${NICHO}_CONSOLIDADA.md`) and map:
+- How many offers already exist in this niche?
+- What VOC data is already collected cross-offer?
+- What clichés are documented (to avoid from day 1)?
+- What experts have relevant coverage?
+
+### Pass 2: Contratos e Concorrentes
+Check the competitive landscape:
+- Read any existing `research/competitors/summary.md` from sibling offers in the same niche
+- Check if `ads-library-spy.md` exists for similar offers
+- Identify what angles are already being used (to differentiate)
+- List any cross-offer dependencies (e.g., front-end → SaaS upsell)
+
+### Pass 3: Fragilidades e Gaps
+Identify risks before starting:
+- Is the mecanismo hypothesis differentiated from existing offers in the niche?
+- Does the avatar overlap with another offer (cannibalization risk)?
+- Are there compliance constraints for this sub-niche?
+- What's the weakest link in the funnel hypothesis?
+
+**Output:** Display a brief summary of findings from all 3 passes before proceeding to Step 2. This ensures the human has full context before filling the setup template.
+
+---
+
+## Step 2: Generate Setup Template (Elicitation)
+
+Run the elicitation engine to produce a YAML template for the human to fill:
+
+```bash
+SETUP_FILE=~/copywriting-ecosystem/${NICHO}/${OFERTA}-setup.yaml
+bun run ~/.claude/scripts/offer-elicitation.ts --generate "$SETUP_FILE"
+echo ""
+echo "Setup template generated: $SETUP_FILE"
+echo ""
+echo "NEXT: Open the file, fill all fields, then continue to Step 2b."
+echo "  Fields to fill: nicho, offer_name, tipo, funil, ticket, expert,"
+echo "  business_context, avatar_hypothesis (gender/age_range/dre_hypothesis),"
+echo "  mup_hypothesis, mus_hypothesis"
+```
+
+### Step 2b: Validate the Filled Template
+
+After the human fills the YAML file:
+
+```bash
+bun run ~/.claude/scripts/offer-elicitation.ts --validate "$SETUP_FILE"
+```
+
+If validation passes (exit 0), continue to Step 2c. If it fails, show the errors and ask the human to correct the file.
+
+### Step 2c: Create Offer Structure from Template
+
+```bash
+bun run ~/.claude/scripts/offer-elicitation.ts --create "$SETUP_FILE"
+```
+
+This creates the full offer directory at `~/copywriting-ecosystem/$NICHO/$OFERTA/` with:
+- `CONTEXT.md` — Pre-filled from template data
+- `helix-state.yaml` — Initialized to IDLE
+- `mecanismo-unico.yaml` — Initialized to UNDEFINED
+- `project_state.yaml` — Phase: SETUP, next action defined
+- `task_plan.md` — Full pipeline checklist
+- All required subdirectories (`research/`, `briefings/`, `production/`, `reviews/`, `swipes/`)
+
+**Note:** If Step 1 already scaffolded the offer directory (via `--offer` flag on create-niche-pack.ts), Step 2c will overwrite only the template files, preserving the directory structure.
+
+---
+
+## Step 3: Generate Workflow (after human fills YAML)
+
+Once the setup YAML has been validated and the offer structure created, generate the workflow for bob-orchestrator:
+
+```bash
+# Read funnel type from the filled setup YAML
+# Map: VSL -> vsl | TSL -> tsl | Quiz -> quiz | SaaS -> saas | Webinar -> webinar
+FUNNEL_TYPE=$(grep "^tipo:" "$SETUP_FILE" | awk '{print $2}' | tr '[:upper:]' '[:lower:]')
+
+bun run ~/.claude/scripts/workflow-generator.ts --type "$FUNNEL_TYPE" --offer "$NICHO/$OFERTA"
+```
+
+`workflow-generator.ts` writes `~/copywriting-ecosystem/$NICHO/$OFERTA/workflow.yaml` — the machine-readable pipeline that `bob-orchestrator.ts` consumes to track phases, validate gates, and advance the offer through Research → Briefing → Production.
+
+Available workflow types:
+| Flag | Funnel |
+|------|--------|
+| `tsl` | TSL (Landing Page → Checkout) |
+| `vsl` | VSL (Video → LP → Checkout) |
+| `quiz` | Quiz Funnel (Quiz → VSL/TSL → Checkout) |
+| `saas` | SaaS (Home + Features + Pricing + Onboarding) |
+| `webinar` | Webinar (Registro + Script + Replay + Follow-up) |
+
+Use `--dry-run` to preview the workflow table without writing the file.
+
+---
+
+## Step 4: Expert Coverage Check
+
+After creating the structure, check if the Copy Squad has adequate coverage for this niche.
+
+Read all expert profiles from `~/.claude/copy-squad/*.md` and extract their `specialties` or `nicho` fields.
+
+### Coverage Calculation
+
+For the given `$NICHO`, count how many of the 24 experts have a relevant specialty:
+
+| Niche | Relevant Specialties (keywords to match) |
+|-------|------------------------------------------|
+| concursos | education, concursos, study, memorization, exam, test prep |
+| saude | health, supplement, weight loss, medical, pain, wellness, fitness |
+| relacionamento | relationship, dating, marriage, attraction, seduction, love, reconquista |
+| riqueza | wealth, money, business, income, investment, entrepreneurship, finance |
+
+**Algorithm:**
+1. For each expert profile, check if any of their specialties/tags match the niche keywords
+2. Count matches as `relevant_experts`
+3. Calculate `coverage = relevant_experts / 24 * 100`
+
+### Output
+
+**If coverage >= 60%:**
+```
+Copy Squad Coverage: {coverage}% ({relevant_experts}/24 experts relevant)
+Boa cobertura para o nicho {NICHO}. Pronto para pesquisa.
+```
+
+**If coverage < 60%:**
+```
+Copy Squad Coverage: {coverage}% ({relevant_experts}/24 experts relevant)
+
+Para melhorar cobertura no nicho {NICHO}, considere clonar:
+- [Expert Name] — especialista em [relevancia] → /clone-expert [name]
+- [Expert Name] — especialista em [relevancia] → /clone-expert [name]
+
+Estes experts agregariam [justificativa especifica para o nicho].
+```
+
+Suggest 1-3 experts known for that niche who aren't yet in the squad. Use your knowledge of famous DR copywriters to recommend relevant additions.
+
+---
+
+## Summary: What Was Created
+
+After all steps complete, output this summary:
+
+```
+OFFER CREATION COMPLETE
+=======================
+Niche:    $NICHO
+Offer:    $OFERTA
+Path:     ~/copywriting-ecosystem/$NICHO/$OFERTA/
+
+Files created:
+  CONTEXT.md              — Offer context (pre-filled)
+  helix-state.yaml        — HELIX state tracker (IDLE)
+  mecanismo-unico.yaml    — Mecanismo tracker (UNDEFINED)
+  project_state.yaml      — Pipeline state (SETUP)
+  task_plan.md            — Full pipeline checklist
+  workflow.yaml           — bob-orchestrator pipeline
+
+Niche library: ~/copywriting-ecosystem/$NICHO/biblioteca_nicho_${NICHO}_CONSOLIDADA.md
+
+Next steps:
+1. Run /helix-parallel $OFERTA  — or —
+2. Invoke audience-research-agent to start Research phase
+3. Track progress: bun run ~/.claude/scripts/bob-orchestrator.ts --status --offer $NICHO/$OFERTA
+```
+
+---
+
+## Full Pipeline Reference
+
+```bash
+# STEP 1 — New niche only
+bun run ~/.claude/scripts/create-niche-pack.ts --niche <nicho> --offer <oferta>
+
+# STEP 2a — Generate template
+bun run ~/.claude/scripts/offer-elicitation.ts --generate ~/copywriting-ecosystem/<nicho>/<oferta>-setup.yaml
+
+# STEP 2b — Validate filled template
+bun run ~/.claude/scripts/offer-elicitation.ts --validate ~/copywriting-ecosystem/<nicho>/<oferta>-setup.yaml
+
+# STEP 2c — Create offer from template
+bun run ~/.claude/scripts/offer-elicitation.ts --create ~/copywriting-ecosystem/<nicho>/<oferta>-setup.yaml
+
+# STEP 3 — Generate workflow
+bun run ~/.claude/scripts/workflow-generator.ts --type <vsl|tsl|quiz|saas|webinar> --offer <nicho>/<oferta>
+
+# VERIFY — Check bob-orchestrator sees the new offer
+bun run ~/.claude/scripts/bob-orchestrator.ts --status --offer <nicho>/<oferta>
+```