grimoire-framework 1.0.0

package/.grimoire/development/tasks/create-agent.md

@@ -0,0 +1,1199 @@
+# Task: Create Squad Agent
+
+**Task ID:** create-agent
+**Version:** 3.0
+**Purpose:** Create a single domain-specific agent through research, elicitation, validation, and operational infrastructure
+**Orchestrator:** @squad-architect
+**DNA Specialist:** @oalanicolas
+**Process Specialist:** @pedro-valerio
+**Mode:** Research-first (never create without research)
+**Quality Standard:** grimoire Level (300+ lines, voice_dna, output_examples, command_loader, task files)
+
+**Specialists:**
+
+- **@oalanicolas** → Invoke for DNA extraction (Voice DNA, Thinking DNA, source curation)
+  - Use `*extract-dna {specialist}` for complete DNA Mental™ extraction
+  - Use `*assess-sources` to classify sources as ouro vs bronze
+  - Consult when agent voice feels generic or inauthentic
+
+**Frameworks Used:**
+
+- `data/tier-system-framework.md` → Agent tier classification (Phase 2)
+- `data/quality-dimensions-framework.md` → Agent validation (Phase 4)
+- `data/decision-heuristics-framework.md` → Quality gate logic (Phase 4)
+
+---
+
+## Step 0: IDS Registry Check (Advisory)
+
+Before proceeding, check the Entity Registry for existing artifacts:
+
+1. Extract intent keywords from user's request
+2. Run `FrameworkGovernor.preCheck(intent, 'agent')`
+3. If REUSE match found (>=90% relevance):
+   - Display match and ask user: "Existing agent found. REUSE instead of creating new?"
+4. If ADAPT match found (60-89%):
+   - Display adaptation candidate: "Similar agent exists. ADAPT instead of creating new?"
+5. If CREATE (no match or user chooses):
+   - Log decision with justification and proceed to Step 1
+6. If IDS unavailable (timeout/error): Warn and proceed normally
+
+**NOTE:** This step is advisory and does NOT block creation. User always has final decision.
+
+---
+
+## Overview
+
+This task creates a single high-quality agent based on researched methodologies from an elite mind. The key insight: **agents created without research are weak and generic**.
+
+**v3.0 Changes:**
+
+- NEW: Phase 5 — Operational Infrastructure (command_loader, tasks, templates, checklists)
+- NEW: Phase 6 — Operational Validation (SC_AGT_004, maturity scoring)
+- NEW: Maturity levels (Nivel 1/2/3) with scoring formula
+- NEW: @pedro-valerio as Process Specialist reference
+- Agents must now ship with operational files, not just persona
+- Reference: `aprendizado/32-ANATOMIA-AGENTE-100-PORCENTO-REPLICAVEL.md`
+
+**v2.0 Changes:**
+
+- Mandatory research check before creation
+- PHASE-based structure with checkpoints
+- Quality gate SC_AGT_001 must pass
+- All agents must have voice_dna, output_examples, objection_algorithms
+
+```text
+INPUT (agent_purpose + domain + [specialist])
+    ↓
+[PHASE 0: CONTEXT]
+    → Identify target pack
+    → Check if specialist-based or generic
+    ↓
+[PHASE 1: RESEARCH]
+    → Check local knowledge (if specialist)
+    → Generate research prompt
+    → Execute deep research
+    ↓
+[PHASE 2: EXTRACTION]
+    → Extract framework from research
+    → Classify tier
+    → Define persona
+    ↓
+[PHASE 3: CREATION]
+    → Generate agent using template
+    → Include all 6 levels
+    → Apply voice_dna
+    ↓
+[PHASE 4: VALIDATION]
+    → Run SC_AGT_001 quality gate
+    → Fix blocking issues
+    → Save agent file
+    ↓
+[PHASE 5: OPERATIONAL INFRASTRUCTURE]  ← NEW
+    → Generate command_loader
+    → Create task stubs per command
+    → Create template stubs per output type
+    → Create checklist with veto conditions
+    → Update agent with Level 0 infrastructure
+    ↓
+[PHASE 6: OPERATIONAL VALIDATION]  ← NEW
+    → Validate all files exist
+    → Validate task quality (steps + veto)
+    → Calculate maturity score (target >= 7.0)
+    ↓
+[PHASE 7: HANDOFF]
+    → Present summary with operational status
+    → Document next steps
+    ↓
+OUTPUT: Agent file + Operational files + Quality Gate PASS + Maturity Score
+```
+
+---
+
+## Inputs
+
+| Parameter         | Type   | Required | Description                           | Example                |
+| ----------------- | ------ | -------- | ------------------------------------- | ---------------------- |
+| `agent_purpose`   | string | Yes      | What the agent should do              | `"Create sales pages"` |
+| `domain`          | string | Yes      | Domain/area of expertise              | `"copywriting"`        |
+| `specialist_slug` | string | No       | If based on human expert (snake_case) | `"gary_halbert"`       |
+| `specialist_name` | string | No       | Human-readable name                   | `"Gary Halbert"`       |
+| `pack_name`       | string | Yes      | Target squad                          | `"copy"`               |
+
+---
+
+## Preconditions
+
+- [ ] Target pack exists at `squads/{pack_name}/`
+- [ ] squad-architect agent is active
+- [ ] WebSearch tool available (for research)
+- [ ] Write permissions for `squads/{pack_name}/agents/`
+
+---
+
+## PHASE 0: CONTEXT
+
+**Duration:** < 1 minute
+**Checkpoint:** None (fast validation)
+**Mode:** Automatic
+
+### Step 0.1: Identify Target Pack
+
+**Actions:**
+
+```yaml
+identify_pack:
+  validation:
+    - check_path: 'squads/{pack_name}/'
+    - check_exists: true
+    - load_config: 'config.yaml'
+
+  on_not_exists:
+    option_1: 'Create squad first with *create-squad'
+    option_2: 'Create agent standalone (not recommended)'
+```
+
+**Decision Point:**
+
+```text
+IF pack_name provided AND pack exists:
+    → PROCEED
+ELSE IF pack_name provided AND NOT exists:
+    → ASK: "Pack doesn't exist. Create it first?"
+ELSE:
+    → ASK: "Which pack should this agent belong to?"
+```
+
+### Step 0.2: Classify Agent Type
+
+**Actions:**
+
+```yaml
+classify_agent_type:
+  if_specialist_provided:
+    agent_type: 'specialist_based'
+    research_path: 'outputs/minds/{specialist_slug}/'
+    next_step: 'Check local knowledge'
+
+  if_no_specialist:
+    agent_type: 'generic'
+    warning: 'Generic agents are weaker. Consider researching a specialist.'
+    next_step: 'Generate research prompt for domain experts'
+```
+
+**Output (PHASE 0):**
+
+```yaml
+phase_0_output:
+  pack_name: 'copy'
+  pack_path: 'squads/copy/'
+  agent_type: 'specialist_based'
+  specialist:
+    slug: 'gary_halbert'
+    name: 'Gary Halbert'
+  agent_id: 'gary-halbert' # derived
+```
+
+---
+
+## PHASE 1: RESEARCH
+
+**Duration:** 5-15 minutes
+**Checkpoint:** SC_RES_002 (Agent Research Quality)
+**Mode:** Autonomous
+
+### Step 1.1: Check Local Knowledge (If Specialist)
+
+**Condition:** Only if `agent_type == "specialist_based"`
+
+**Actions:**
+
+```yaml
+check_local_knowledge:
+  search_paths:
+    primary_sources:
+      path: 'outputs/minds/{specialist_slug}/sources/'
+      description: 'Raw materials, transcripts, books, articles'
+      priority: 1
+
+    analysis:
+      path: 'outputs/minds/{specialist_slug}/analysis/'
+      description: 'Identity core, cognitive spec, frameworks'
+      priority: 2
+
+    existing_research:
+      path: 'docs/research/{specialist_slug}-*.md'
+      description: 'Previous deep research documents'
+      priority: 3
+
+  evaluation:
+    coverage_score: '0-100% based on files found'
+    gap_identification: "What's missing for agent_purpose?"
+```
+
+**Decision Point:**
+
+```text
+IF coverage >= 70%:
+    → "Sufficient local material. Supplement gaps only."
+    → research_mode = "supplement"
+ELSE IF coverage >= 30%:
+    → "Partial material. Need moderate research."
+    → research_mode = "moderate"
+ELSE:
+    → "Limited local material. Full research needed."
+    → research_mode = "full"
+```
+
+### Step 1.2: Generate Research Prompt
+
+**Actions:**
+
+```yaml
+generate_research_prompt:
+  template: 'templates/research-prompt-tmpl.md'
+
+  variables:
+    specialist_name: '{specialist_name}'
+    domain: '{domain}'
+    agent_purpose: '{agent_purpose}'
+    existing_coverage: '{coverage_summary}'
+    gaps_to_fill: '{identified_gaps}'
+
+  output_format:
+    primary_queries: '3-5 specific search queries'
+    focus_areas: 'What to extract'
+    validation_criteria: 'How to know research is sufficient'
+```
+
+**Example Research Prompt:**
+
+```yaml
+research_prompt:
+  subject: "Gary Halbert's Sales Page Methodology"
+  context: |
+    Creating an agent for writing sales pages based on Gary Halbert's methodology.
+    Have 70% coverage from local sources (newsletters, books).
+    Missing: specific sales page structure, digital adaptation techniques.
+
+  queries:
+    - 'Gary Halbert sales page structure template'
+    - 'Gary Halbert long-form copy formula'
+    - 'Gary Halbert AIDA application direct mail'
+
+  extract:
+    - Step-by-step sales page process
+    - Specific headline formulas
+    - Body copy structure
+    - Call-to-action patterns
+    - Quality criteria from his own writings
+```
+
+### Step 1.3: Execute Deep Research
+
+**Actions:**
+
+```yaml
+execute_research:
+  method: 'WebSearch + Local Synthesis'
+
+  process:
+    for_each_query:
+      - execute_search
+      - filter_primary_sources
+      - extract_relevant_content
+      - cite_source
+
+  quality_criteria:
+    min_unique_sources: 5
+    min_lines_extracted: 500
+    requires_primary_sources: true
+    max_inference_ratio: 0.20 # 80%+ must be cited
+
+  output:
+    file: 'docs/research/{specialist_slug}-{purpose}-research.md'
+    sections:
+      - sources_used
+      - extracted_methodology
+      - key_frameworks
+      - gaps_remaining
+```
+
+**Checkpoint SC_RES_002:**
+
+```yaml
+heuristic_id: SC_RES_002
+name: 'Agent Research Quality'
+blocking: true
+criteria:
+  - sources_count >= 5
+  - lines_extracted >= 500
+  - has_primary_sources: true
+  - methodology_extracted: true
+
+veto_conditions:
+  - sources_count < 3 → "Insufficient sources"
+  - no_methodology_found → "Cannot create agent without methodology"
+```
+
+**Output (PHASE 1):**
+
+```yaml
+phase_1_output:
+  research_file: 'docs/research/gary_halbert-sales-page-research.md'
+  sources_used: 8
+  lines_extracted: 720
+  coverage_after: 92%
+  checkpoint_status: 'PASS'
+```
+
+---
+
+## PHASE 2: EXTRACTION
+
+**Duration:** 5-10 minutes
+**Checkpoint:** None (internal validation)
+**Mode:** Autonomous
+
+### Step 2.1: Extract Framework from Research
+
+**Actions:**
+
+```yaml
+extract_framework:
+  sections_to_extract:
+    core_principles:
+      description: 'Fundamental beliefs and values'
+      min_items: 5
+      max_items: 10
+
+    operational_framework:
+      description: 'Step-by-step methodology'
+      includes:
+        - process_steps
+        - decision_criteria
+        - quality_checks
+        - common_patterns
+
+    voice_dna:
+      description: 'How this expert communicates'
+      includes:
+        - sentence_starters (categorized)
+        - metaphors (5+)
+        - vocabulary_always_use (8+)
+        - vocabulary_never_use (5+)
+        - emotional_states (3+)
+
+    anti_patterns:
+      description: 'What this expert warns against'
+      includes:
+        - never_do (5+)
+        - always_do (5+)
+
+    output_examples:
+      description: "Real examples from the expert's work"
+      min_count: 3
+      format: 'input → output'
+```
+
+### Step 2.2: Classify Tier
+
+**Apply: tier-system-framework.md**
+
+**Actions:**
+
+```yaml
+classify_tier:
+  decision_tree:
+    - IF agent performs diagnosis/analysis FIRST:
+        tier: 0
+        rationale: 'Foundation agent - must run before execution'
+
+    - ELSE IF agent is primary expert with documented results:
+        tier: 1
+        rationale: 'Master with proven track record'
+
+    - ELSE IF agent created frameworks others use:
+        tier: 2
+        rationale: 'Systematizer - thought leader'
+
+    - ELSE IF agent specializes in specific format/channel:
+        tier: 3
+        rationale: 'Format specialist'
+
+    - ELSE IF agent is validation/checklist tool:
+        tier: 'tools'
+        rationale: 'Utility agent'
+
+  output:
+    tier: 1
+    rationale: 'Gary Halbert has documented $1B+ results, original methodology'
+```
+
+### Step 2.3: Define Persona
+
+**Actions:**
+
+```yaml
+define_persona:
+  agent_identity:
+    name: '{specialist_name}'
+    id: '{specialist_slug converted to kebab-case}'
+    title: 'Expert in {agent_purpose}'
+    icon: '{appropriate emoji}'
+    whenToUse: 'Use when {use_case_description}'
+
+  persona_characteristics:
+    role: 'Extracted from research'
+    style: 'Derived from voice_dna'
+    identity: 'Core essence'
+    focus: 'Primary objective'
+
+  customization:
+    - 'Domain-specific behaviors'
+    - 'Special rules from methodology'
+    - 'Integration points'
+```
+
+**Output (PHASE 2):**
+
+```yaml
+phase_2_output:
+  core_principles: 7
+  operational_steps: 9
+  voice_dna_complete: true
+  anti_patterns: 12
+  output_examples: 4
+  tier: 1
+  persona_defined: true
+```
+
+---
+
+## PHASE 3: CREATION
+
+**Duration:** 5-10 minutes
+**Checkpoint:** None (validation in Phase 4)
+**Mode:** Autonomous
+
+### Step 3.1: Generate Agent Using Template
+
+**Template:** `templates/squad/agent-template.md`
+
+**Actions:**
+
+```yaml
+generate_agent:
+  template: 'templates/squad/agent-template.md'
+
+  required_sections:
+    # Level 1: Identity
+    activation_notice: 'Standard grimoire header'
+    ide_file_resolution: 'Dependency mapping'
+    activation_instructions: 'Step-by-step activation'
+    agent_metadata: 'name, id, title, icon, whenToUse'
+    persona: 'role, style, identity, focus'
+
+    # Level 2: Operational
+    core_principles: '5-10 principles from research'
+    commands: 'Available commands'
+    quality_standards: 'From extracted methodology'
+    security: 'Code generation, validation, memory'
+    dependencies: 'tasks, templates, checklists, data'
+    knowledge_areas: 'Expertise domains'
+    capabilities: 'What agent can do'
+
+    # Level 3: Voice DNA
+    voice_dna:
+      sentence_starters: 'Categorized by mode'
+      metaphors: '5+ domain metaphors'
+      vocabulary:
+        always_use: '8+ terms'
+        never_use: '5+ terms'
+      emotional_states: '3+ states with markers'
+
+    # Level 4: Quality
+    output_examples: '3+ real examples'
+    objection_algorithms: '4+ common objections'
+    anti_patterns: 'never_do (5+), always_do (5+)'
+    completion_criteria: 'By task type'
+
+    # Level 5: Credibility (if specialist)
+    credibility:
+      achievements: 'Documented results'
+      notable_work: 'Key contributions'
+      influence: 'Who learned from them'
+
+    # Level 6: Integration
+    handoff_to: '3+ handoff scenarios'
+    synergies: 'Related agents/workflows'
+```
+
+### Step 3.2: Apply Voice DNA
+
+**Actions:**
+
+```yaml
+apply_voice_dna:
+  ensure_consistency:
+    - All output_examples use vocabulary.always_use
+    - No output_examples use vocabulary.never_use
+    - Sentence starters match emotional_states
+    - Metaphors appear in examples
+
+  validation:
+    vocabulary_consistency: 'Check all sections'
+    tone_consistency: 'Match persona style'
+```
+
+### Step 3.3: Add Completion Criteria
+
+**Actions:**
+
+```yaml
+add_completion_criteria:
+  per_task_type:
+    primary_task:
+      - 'List specific criteria for main task'
+      - 'Include quality checks'
+      - 'Define deliverables'
+
+    secondary_tasks:
+      - 'Criteria for each additional task'
+
+  format:
+    task_name:
+      - 'Criterion 1'
+      - 'Criterion 2'
+      - '...'
+```
+
+**Output (PHASE 3):**
+
+```yaml
+phase_3_output:
+  agent_file_content: '...'
+  lines: 750
+  sections_complete: 6/6
+  voice_dna_applied: true
+```
+
+---
+
+## PHASE 4: VALIDATION
+
+**Duration:** 2-5 minutes
+**Checkpoint:** SC_AGT_001 (Agent Quality Gate)
+**Mode:** Autonomous with retry
+
+### Step 4.1: Run Quality Gate SC_AGT_001
+
+**Checklist:** `checklists/agent-quality-gate.md`
+
+**Actions:**
+
+```yaml
+run_quality_gate:
+  heuristic_id: SC_AGT_001
+  name: "Agent Quality Gate"
+  blocking: true
+
+  blocking_requirements:
+    lines: ">= 300"
+    voice_dna:
+      vocabulary_always_use: ">= 5 items"
+      vocabulary_never_use: ">= 3 items"
+    output_examples: ">= 3"
+    anti_patterns_never_do: ">= 5"
+    completion_criteria: "defined"
+    handoff_to: "defined"
+
+  scoring:
+    | Dimension | Weight | Check |
+    |-----------|--------|-------|
+    | Structure | 0.20 | All 6 levels present |
+    | Voice DNA | 0.20 | Complete with vocabulary |
+    | Examples | 0.20 | Real, not generic |
+    | Anti-patterns | 0.15 | Specific to domain |
+    | Integration | 0.15 | Handoffs defined |
+    | Research | 0.10 | Traceable to sources |
+
+  threshold: 7.0
+  veto_conditions:
+    - lines < 300 → "Agent too short"
+    - no_voice_dna → "Missing voice consistency"
+    - examples < 3 → "Insufficient examples"
+```
+
+**Decision Point:**
+
+```text
+IF all blocking requirements pass AND score >= 7.0:
+    → PROCEED to Step 4.3
+ELSE:
+    → Log specific failures
+    → GOTO Step 4.2 (Fix Issues)
+```
+
+### Step 4.2: Fix Blocking Issues
+
+**Actions:**
+
+```yaml
+fix_blocking_issues:
+  for_each_failure:
+    - identify: "What's missing"
+    - source: 'Where to get it'
+    - fix: 'Add the content'
+
+  common_fixes:
+    lines_short:
+      - 'Expand core_principles with detail'
+      - 'Add more output_examples'
+      - 'Expand objection_algorithms'
+
+    missing_voice_dna:
+      - 'Extract from research'
+      - 'Add vocabulary lists'
+      - 'Define emotional states'
+
+    few_examples:
+      - 'Extract from source material'
+      - 'Create based on methodology'
+      - 'Ensure they show input → output'
+
+  max_iterations: 2
+  on_max_iterations: 'Flag for human review'
+```
+
+### Step 4.3: Save Agent File
+
+**Actions:**
+
+```yaml
+save_agent:
+  path: 'squads/{pack_name}/agents/{agent_id}.md'
+
+  post_save:
+    - verify_yaml_valid
+    - update_pack_readme
+    - update_config_yaml
+    - log_creation
+```
+
+**Output (PHASE 4):**
+
+```yaml
+phase_4_output:
+  quality_score: 8.3/10
+  blocking_requirements: 'ALL PASS'
+  agent_file: 'squads/copy/agents/gary-halbert.md'
+  lines: 750
+  status: 'PASS'
+```
+
+---
+
+## PHASE 5: OPERATIONAL INFRASTRUCTURE
+
+**Duration:** 5-10 minutes
+**Checkpoint:** SC_AGT_004 (Operational Completeness)
+**Mode:** Autonomous
+**Reference:** `aprendizado/32-ANATOMIA-AGENTE-100-PORCENTO-REPLICAVEL.md`
+
+> **Principio:** Um agente sem infraestrutura operacional e uma persona sem processo.
+> Ele SABE quem e, mas nao sabe COMO fazer nada de forma deterministica.
+> "Se o executor CONSEGUE improvisar, vai improvisar. E cada execucao sera diferente."
+
+### Step 5.1: Generate Command Loader
+
+**Actions:**
+
+```yaml
+generate_command_loader:
+  description: 'Map each operational command to required files'
+
+  process:
+    for_each_command:
+      - identify: 'Is this command operational (produces output) or utility (*help, *exit)?'
+      - if_operational:
+          - define: 'requires[] — task file that contains step-by-step workflow'
+          - define: 'optional[] — data files, checklists for reference'
+          - define: 'output_format — description of expected output'
+      - if_utility:
+          - set: 'requires: [] (uses inline content)'
+
+  output_format:
+    command_loader:
+      '*{command}':
+        description: '{what this command does}'
+        requires:
+          - 'tasks/{command}-workflow.md'
+        optional:
+          - 'data/{relevant-data}.md'
+          - 'checklists/{relevant-checklist}.md'
+        output_format: '{expected output description}'
+
+  validation:
+    - 'Every command with visibility [full, quick] MUST have command_loader entry'
+    - 'Every command_loader entry MUST have at least 1 requires file'
+    - 'Utility commands (*help, *exit, *chat-mode) may have empty requires'
+
+  veto_condition:
+    - condition: 'Operational command has no command_loader entry'
+      action: 'VETO - Cannot proceed. Every operational command needs file mapping'
+      reason: 'Without mapping, LLM will improvise the workflow'
+```
+
+### Step 5.2: Create Task Stubs
+
+**Actions:**
+
+```yaml
+create_task_stubs:
+  description: 'Create task file for each operational command'
+
+  for_each_operational_command:
+    file_path: 'squads/{pack_name}/tasks/{command}-workflow.md'
+
+    required_sections:
+      - task_header:
+          fields: ['Task ID', 'Version', 'Purpose', 'Orchestrator', 'Mode']
+      - inputs:
+          fields: ['name', 'type', 'required', 'description']
+      - steps:
+          min_count: 3
+          required_per_step: ['step number', 'name', 'action', 'output']
+      - veto_conditions:
+          min_count: 1
+          format: 'condition → action → reason'
+      - output_format:
+          reference: 'templates/{command}-output-tmpl.md'
+      - completion_criteria:
+          min_count: 2
+
+    content_source:
+      primary: 'operational_frameworks from agent definition'
+      secondary: 'research material from Phase 1'
+      fallback: "Generate from agent's thinking_dna + output_examples"
+
+    quality_criteria:
+      min_lines: 50
+      must_have_veto: true
+      must_reference_template: true
+
+  veto_condition:
+    - condition: 'Task file has no steps'
+      action: 'VETO - Task without steps is decoration'
+      reason: 'Steps are what make execution deterministic'
+
+    - condition: 'Task file has no veto conditions'
+      action: 'VETO - Task without veto allows incomplete work to pass'
+      reason: 'PV004: If executor CAN do it wrong, process is wrong'
+```
+
+### Step 5.3: Create Template Stubs
+
+**Actions:**
+
+```yaml
+create_template_stubs:
+  description: 'Create output template for each command that produces structured output'
+
+  identify_output_types:
+    - 'List all commands that produce a document/report/analysis'
+    - 'Group by output similarity (commands that produce same format share template)'
+
+  for_each_output_type:
+    file_path: 'squads/{pack_name}/templates/{output-type}-tmpl.md'
+
+    required_sections:
+      - title_with_date
+      - executive_summary: '1-3 sentences'
+      - structured_body: 'Main content in consistent format'
+      - recommendations: 'Actionable next steps'
+
+    quality_criteria:
+      must_have_placeholders: true
+      must_define_required_sections: true
+
+  skip_if:
+    - 'Command output is conversational (chat-mode)'
+    - 'Command output is a simple list (*help)'
+```
+
+### Step 5.4: Create Operational Checklist
+
+**Actions:**
+
+```yaml
+create_operational_checklist:
+  description: "Create at least 1 checklist with veto conditions for the agent's primary task"
+  file_path: 'squads/{pack_name}/checklists/{agent_id}-quality-gate.md'
+
+  required_structure:
+    blocking_section:
+      description: 'Items that MUST pass — VETO if any fails'
+      min_items: 3
+      format:
+        - check: 'Description of what to validate'
+        - veto_if_fail: 'What happens if this fails'
+        - action: 'How to fix'
+
+    recommended_section:
+      description: 'Items that SHOULD pass — WARNING if fails'
+      min_items: 2
+
+    approval_criteria:
+      rule: '100% blocking + 80% recommended = PASS'
+
+  content_source: "Derive from agent's completion_criteria and anti_patterns"
+```
+
+### Step 5.5: Update Agent with Command Loader
+
+**Actions:**
+
+```yaml
+update_agent_file:
+  description: 'Add command_loader, CRITICAL_LOADER_RULE, and dependencies to agent'
+
+  modifications:
+    - section: 'Level 0'
+      add:
+        - command_loader: '{generated in Step 5.1}'
+        - CRITICAL_LOADER_RULE: |
+            BEFORE executing ANY command (*):
+            1. LOOKUP: Check command_loader[command].requires
+            2. STOP: Do not proceed without loading required files
+            3. LOAD: Read EACH file in 'requires' list completely
+            4. VERIFY: Confirm all required files were loaded
+            5. EXECUTE: Follow the workflow in the loaded task file EXACTLY
+
+            If a required file is missing:
+            - Report the missing file to user
+            - Do NOT attempt to execute without it
+            - Do NOT improvise the workflow
+
+    - section: 'dependencies'
+      add:
+        tasks: '[all task files created in Step 5.2]'
+        templates: '[all template files created in Step 5.3]'
+        checklists: '[checklist created in Step 5.4]'
+
+    - section: 'commands'
+      update: 'Add visibility metadata [full, quick, key] to each command'
+
+  validation:
+    - 'command_loader maps ALL operational commands'
+    - 'dependencies list ALL files in command_loader.requires'
+    - 'CRITICAL_LOADER_RULE is present verbatim'
+```
+
+**Output (PHASE 5):**
+
+```yaml
+phase_5_output:
+  command_loader_entries: N
+  task_files_created: N
+  template_files_created: N
+  checklists_created: 1
+  agent_file_updated: true
+  dependencies_complete: true
+```
+
+---
+
+## PHASE 6: OPERATIONAL VALIDATION
+
+**Duration:** 2-5 minutes
+**Checkpoint:** SC_AGT_004 (Operational Completeness)
+**Mode:** Autonomous
+
+### Step 6.1: Validate File Existence
+
+**Actions:**
+
+```yaml
+validate_files_exist:
+  for_each_entry_in_command_loader:
+    - check: 'File at requires[] path exists'
+    - check: 'File is not empty (min 20 lines)'
+    - check: 'File has expected sections'
+
+  on_missing_file:
+    action: 'VETO - Cannot pass. File {path} is in command_loader but does not exist'
+    fix: 'Create the file or remove from command_loader'
+```
+
+### Step 6.2: Validate Task Quality
+
+**Actions:**
+
+```yaml
+validate_task_quality:
+  for_each_task_file:
+    checks:
+      - has_steps: 'min 3 steps'
+      - has_veto_conditions: 'min 1'
+      - has_inputs: 'defined'
+      - has_output_format: 'references template or defines inline'
+      - has_completion_criteria: 'min 2 criteria'
+
+  scoring:
+    complete_task: 1.0 # All checks pass
+    partial_task: 0.5 # Missing veto or template ref
+    stub_only: 0.25 # Has header but no real content
+    missing: 0.0 # File doesn't exist
+
+  threshold: 'Average >= 0.75 across all tasks'
+```
+
+### Step 6.3: Calculate Maturity Score
+
+**Actions:**
+
+```yaml
+calculate_maturity:
+  formula:
+    identity: { present: 1.0, absent: 0.0, weight: 1.0 }
+    thinking_dna: { present: 1.0, absent: 0.0, weight: 1.5 }
+    voice_dna: { present: 1.0, absent: 0.0, weight: 1.5 }
+    output_examples: { count_gte_3: 1.0, else: 0.0, weight: 1.0 }
+    command_loader: { present: 1.0, absent: 0.0, weight: 1.5 }
+    tasks_coverage: { ratio: 'tasks/commands', weight: 1.5 }
+    templates: { present: 1.0, absent: 0.0, weight: 1.0 }
+    checklists: { present: 1.0, absent: 0.0, weight: 0.5 }
+    data_files: { present: 1.0, absent: 0.0, weight: 0.5 }
+
+  max_score: 10.0
+
+  levels:
+    - range: '0-4'
+      level: 'Nivel 1 — Persona only (decorativo)'
+      verdict: 'FAIL - Agente incompleto'
+
+    - range: '4-7'
+      level: 'Nivel 2 — Frameworks (funcional mas inconsistente)'
+      verdict: 'CONDITIONAL - Pode publicar com plano de melhoria'
+
+    - range: '7-9'
+      level: 'Nivel 3 — Completo (deterministico)'
+      verdict: 'PASS - Agente operacional'
+
+    - range: '9-10'
+      level: 'Nivel 3+ — Completo + integrado'
+      verdict: 'EXCELLENT - Agente producao'
+
+  target: '>= 7.0 (Nivel 3)'
+
+  veto_condition:
+    - condition: 'Score < 4.0'
+      action: 'VETO - Agent is persona-only, not operational'
+      reason: 'Nivel 1 agents are decorative, not functional'
+```
+
+### Step 6.4: Final Decision
+
+**Actions:**
+
+```yaml
+final_decision:
+  if_pass:
+    - 'Log: Agent {id} passed operational validation (Score: {score})'
+    - 'Proceed to Phase 7 (Handoff)'
+
+  if_conditional:
+    - 'Log: Agent {id} conditional pass (Score: {score})'
+    - 'List missing operational files'
+    - "Ask: 'Proceed with documented gaps or fix now?'"
+    - options:
+        1: 'Fix now (recommended)'
+        2: 'Proceed with gaps documented'
+        3: 'Abort creation'
+
+  if_fail:
+    - 'Log: Agent {id} FAILED operational validation (Score: {score})'
+    - 'List all missing components'
+    - 'Return to Phase 5 to create missing infrastructure'
+    - max_retries: 2
+```
+
+**Output (PHASE 6):**
+
+```yaml
+phase_6_output:
+  files_validated: N
+  tasks_quality_avg: 0.X
+  maturity_score: X.X/10
+  maturity_level: 'Nivel N'
+  decision: 'PASS | CONDITIONAL | FAIL'
+```
+
+---
+
+## PHASE 7: HANDOFF
+
+**Duration:** < 1 minute
+**Mode:** Interactive
+
+### Step 7.1: Present Agent Summary
+
+**Actions:**
+
+```yaml
+present_summary:
+  agent_created:
+    name: 'Gary Halbert'
+    id: 'gary-halbert'
+    tier: 1
+    file: 'squads/copy/agents/gary-halbert.md'
+    lines: 750
+
+  quality:
+    score: 8.3/10
+    research_sources: 8
+    voice_dna: 'Complete'
+
+  activation:
+    command: '@copy:gary-halbert'
+    example: 'Write a sales page for a fitness program'
+
+  commands:
+    - '*help - Show available commands'
+    - '*write-sales-page - Main task'
+    - '*review-copy - Review existing copy'
+```
+
+### Step 7.2: Document Next Steps
+
+**Actions:**
+
+```yaml
+next_steps:
+  recommended:
+    - 'Test agent with sample task'
+    - 'Verify operational infrastructure (run *command, check if task loads)'
+    - 'Add to squad orchestrator routing'
+
+  optional:
+    - 'Create more agents for the squad'
+    - 'Build workflows that use this agent'
+    - 'Enrich task stubs with more detail from domain research'
+
+  handoff_to:
+    - agent: 'squad-architect'
+      when: 'Continue building squad'
+    - agent: 'created-agent'
+      when: 'Ready to use agent'
+    - agent: '@pedro-valerio'
+      when: 'Validate operational processes (*audit)'
+```
+
+---
+
+## Outputs
+
+| Output         | Location                                                   | Description                                   |
+| -------------- | ---------------------------------------------------------- | --------------------------------------------- |
+| Agent File     | `squads/{pack_name}/agents/{agent_id}.md`                  | Complete agent definition with command_loader |
+| Task Files     | `squads/{pack_name}/tasks/{command}-workflow.md`           | Step-by-step per command                      |
+| Template Files | `squads/{pack_name}/templates/{output}-tmpl.md`            | Output format per type                        |
+| Checklist      | `squads/{pack_name}/checklists/{agent_id}-quality-gate.md` | Validation with veto conditions               |
+| Research File  | `docs/research/{specialist_slug}-{purpose}-research.md`    | Research documentation                        |
+| Updated README | `squads/{pack_name}/README.md`                             | Agent added to list                           |
+| Updated Config | `squads/{pack_name}/config.yaml`                           | Agent registered                              |
+
+---
+
+## Validation Criteria (All Must Pass)
+
+### Structure
+
+- [ ] Agent file created at correct location
+- [ ] YAML block is valid
+- [ ] All 6 levels present (including Level 0: command_loader)
+
+### Content
+
+- [ ] Lines >= 300
+- [ ] voice_dna complete with vocabulary
+- [ ] output_examples >= 3
+- [ ] anti_patterns.never_do >= 5
+- [ ] completion_criteria defined
+- [ ] handoff_to defined
+
+### Operational Infrastructure
+
+- [ ] command_loader maps ALL operational commands
+- [ ] CRITICAL_LOADER_RULE present in agent
+- [ ] Task file exists for each operational command
+- [ ] Each task file has steps (min 3) + veto conditions (min 1)
+- [ ] Template exists for each structured output type
+- [ ] At least 1 checklist with blocking veto conditions
+- [ ] dependencies list matches command_loader.requires
+
+### Quality
+
+- [ ] SC_AGT_001 score >= 7.0
+- [ ] SC_AGT_004 score >= 7.0 (maturity)
+- [ ] Research traceable
+- [ ] Tier assigned
+
+### Integration
+
+- [ ] README.md updated
+- [ ] config.yaml updated
+- [ ] All dependency files exist
+
+---
+
+## Heuristics Reference
+
+| Heuristic ID | Name                     | Where Applied | Blocking |
+| ------------ | ------------------------ | ------------- | -------- |
+| SC_RES_002   | Agent Research Quality   | Phase 1       | Yes      |
+| SC_AGT_001   | Agent Quality Gate       | Phase 4       | Yes      |
+| SC_AGT_004   | Operational Completeness | Phase 6       | Yes      |
+
+---
+
+## Error Handling
+
+```yaml
+error_handling:
+  research_insufficient:
+    - retry_with_different_queries
+    - expand_search_scope
+    - if_still_fails: 'Create generic agent with TODO notes'
+
+  validation_fails:
+    - identify_specific_failures
+    - attempt_automated_fix
+    - if_cannot_fix: 'Save as draft, flag for review'
+
+  pack_not_exists:
+    - suggest_create_pack_first
+    - offer_standalone_option
+```
+
+---
+
+## Integration with grimoire
+
+This task creates agents that:
+
+- Follow grimoire agent definition standards (6 levels)
+- Can be activated with @pack:agent-id syntax
+- Integrate with memory layer
+- Support standard command patterns (`*help`, `*exit`, etc.)
+- Work within squad structure
+- Pass quality gate SC_AGT_001
+
+---
+
+_Task Version: 3.0_
+_Last Updated: 2026-02-04_
+_Lines: 1100+_
+_Philosophy: "Se o processo de criacao PERMITE criar agente incompleto, agente incompleto vai ser criado."_
+