claude-flow-novice 2.14.30 → 2.14.32

package/claude-assets/agents/cfn-dev-team/utility/code-booster.md

@@ -14,15 +14,6 @@ validation_hooks:
   - agent-template-validator
   - cfn-loop-memory-validator
   - test-coverage-validator
-lifecycle:
-  pre_task: |
-    sqlite-cli exec "INSERT INTO agents (id, type, status, spawned_at)
-                     VALUES ('${AGENT_ID}', 'code-booster', 'active', CURRENT_TIMESTAMP)"
-  post_task: |
-    sqlite-cli exec "UPDATE agents
-                     SET status = 'completed', confidence = ${CONFIDENCE_SCORE},
-                         completed_at = CURRENT_TIMESTAMP
-                     WHERE id = '${AGENT_ID}'"
 ---
 
 # Code Booster Agent
@@ -48,35 +39,6 @@ Specialized performance optimization expert leveraging WASM acceleration and adv
    - Manage compute offloading
    - Create efficient resource pools
 
-## SQLite Integration Pattern
-
-```typescript
-// Performance metrics storage
-await sqlite.memoryAdapter.set(
-  `code-booster/${agentId}/optimization/${taskId}`,
-  {
-    confidence: 0.90,
-    speedup: 3.5,  // 3.5x performance improvement
-    memoryReduction: 0.4,  // 40% memory reduction
-    files: ['optimized-module.rs', 'wasm-acceleration.js']
-  },
-  { aclLevel: 1, ttl: 2592000 }
-);
-
-// CFN Loop performance tracking
-await sqlite.memoryAdapter.set(
-  `cfn/phase-${phaseId}/loop3/agent-${agentId}`,
-  {
-    confidence: 0.90,
-    metrics: {
-      speedup: 3.5,
-      memoryReduction: 0.4
-    }
-  },
-  { aclLevel: 1, ttl: 2592000 }
-);
-```
-
 ## Success Metrics
 - ✅ 2-10x performance improvement
 - ✅ 20-50% memory reduction
@@ -95,6 +57,7 @@ npx claude-flow@alpha hooks post-edit [FILE_PATH] \
   --memory-key "code-booster/${AGENT_ID}/optimization" \
   --structured
 ```
+
 ## Completion Protocol
 
 Complete your work and provide a structured response with:

package/claude-assets/agents/cfn-dev-team/utility/memory-leak-specialist.md

@@ -16,11 +16,6 @@ acl_level: 1
 validation_hooks:
   - agent-template-validator
   - test-coverage-validator
-lifecycle:
-  pre_task: |
-    sqlite-cli exec "INSERT INTO agents (id, type, status, spawned_at) VALUES ('${AGENT_ID}', 'memory-leak-specialist', 'active', CURRENT_TIMESTAMP)"
-  post_task: |
-    sqlite-cli exec "UPDATE agents SET status = 'completed', confidence = ${CONFIDENCE_SCORE}, completed_at = CURRENT_TIMESTAMP WHERE id = '${AGENT_ID}'"
 ---
 
 # Memory Leak Specialist Agent
@@ -746,6 +741,16 @@ Before reporting high confidence:
 - Heap utilization optimized (<80% of max)
 - Confidence score ≥ 0.90
 
+## Completion Protocol
+
+Complete your work and provide a structured response with:
+- Confidence score (0.0-1.0) based on work quality
+- Summary of analysis/review completed
+- List of findings or deliverables
+- Any recommendations made
+
+**Note:** Coordination instructions are provided when spawned via CLI.
+
 ## Skill References
 → **Node.js Profiling**: `.claude/skills/nodejs-memory-profiling/SKILL.md`
 → **Python Profiling**: `.claude/skills/python-memory-analysis/SKILL.md`

package/claude-assets/agents/cfn-dev-team/utility/researcher.md

@@ -8,11 +8,6 @@ type: specialist
 acl_level: 1
 validation_hooks:
   - agent-template-validator
-lifecycle:
-  pre_task: |
-    sqlite-cli exec "INSERT INTO agents (id, type, status, spawned_at) VALUES ('${AGENT_ID}', 'researcher', 'active', CURRENT_TIMESTAMP)"
-  post_task: |
-    sqlite-cli exec "UPDATE agents SET status = 'completed', confidence = ${CONFIDENCE_SCORE}, completed_at = CURRENT_TIMESTAMP WHERE id = '${AGENT_ID}'"
 ---
 
 # Researcher Agent
@@ -101,36 +96,15 @@ confidence = (
 }
 ```
 
-## SQLite Memory Integration
-
-### Research State Tracking
-```javascript
-// Store research confidence and findings
-await sqlite.memoryAdapter.set(
-  `researcher/${agentId}/confidence/${taskId}`,
-  {
-    confidence: 0.85,
-    sources: 12,
-    noveltyScore: 0.75
-  },
-  { aclLevel: 1, ttl: 2592000 }  // 30 days retention
-);
-```
+## Completion Protocol
 
-### Error Handling
-```javascript
-try {
-  await sqlite.memoryAdapter.set(key, researchFindings, { aclLevel: 1 });
-} catch (error) {
-  if (error.code === 'SQLITE_BUSY') {
-    await retryWithBackoff(() =>
-      sqlite.memoryAdapter.set(key, researchFindings, { aclLevel: 1 })
-    );
-  } else {
-    console.error('Research persistence failed:', error);
-  }
-}
-```
+Complete your work and provide a structured response with:
+- Confidence score (0.0-1.0) based on work quality
+- Summary of analysis/review completed
+- List of findings or deliverables
+- Any recommendations made
+
+**Note:** Coordination instructions are provided when spawned via CLI.
 
 ## Post-Edit Hook Validation
 

package/claude-assets/agents/cfn-dev-team/utility/z-ai-specialist.md

@@ -15,11 +15,6 @@ acl_level: 1
 validation_hooks:
   - agent-template-validator
   - test-coverage-validator
-lifecycle:
-  pre_task: |
-    sqlite-cli exec "INSERT INTO agents (id, type, status, spawned_at) VALUES ('${AGENT_ID}', 'z-ai-specialist', 'active', CURRENT_TIMESTAMP)"
-  post_task: |
-    sqlite-cli exec "UPDATE agents SET status = 'completed', confidence = ${CONFIDENCE_SCORE}, completed_at = CURRENT_TIMESTAMP WHERE id = '${AGENT_ID}'"
 ---
 
 # Z.ai Specialist Agent
@@ -619,6 +614,16 @@ Before reporting high confidence:
 - Usage tracking accurate (100% requests logged)
 - Confidence score ≥ 0.90
 
+## Completion Protocol
+
+Complete your work and provide a structured response with:
+- Confidence score (0.0-1.0) based on work quality
+- Summary of analysis/review completed
+- List of findings or deliverables
+- Any recommendations made
+
+**Note:** Coordination instructions are provided when spawned via CLI.
+
 ## Skill References
 → **Z.ai Setup**: `.claude/skills/zai-platform-setup/SKILL.md`
 → **Cost Optimization**: `.claude/skills/ai-cost-optimization/SKILL.md`

package/claude-assets/agents/csuite/cto-agent.md

@@ -1,3 +1,13 @@
+---
+name: cto-agent
+description: MUST BE USED when making strategic technical decisions and architectural oversight. Use PROACTIVELY for technical roadmap planning, architecture reviews, strategic guidance. Keywords - CTO, technical strategy, architecture, leadership, oversight
+tools: [Read, Write, Edit, Bash, Grep, Glob, TodoWrite]
+model: sonnet
+type: coordinator
+acl_level: 4
+capabilities: [technical-strategy, architecture-oversight, leadership]
+---
+
 # CTO Agent - Dr. Tech
 
 ## Role Identity

package/claude-assets/agents/custom/cfn-system-expert.md

@@ -256,4 +256,131 @@ redis-cli lpush "swarm:${TASK_ID}:${AGENT_ID}:done" "complete"
 - `.claude/skills/cfn-redis-coordination/SKILL.md`: Coordination patterns
 - `.claude/commands/cfn/CFN_COORDINATOR_PARAMETERS.md`: Parameter specifications
 - `planning/cfn-v3/DUAL_MODE_IMPLEMENTATION.md`: Architecture details
-- Planning documents: Sprint lessons and adaptive context insights
+- Planning documents: Sprint lessons and adaptive context insights
+
+## CFN Implementation Patterns & Lessons Learned
+
+### Core Architecture Patterns
+
+#### STRAT-007: Background Execution Strategy
+- **Insight**: Use background execution with coordination monitoring for long-running orchestration workflows (>10 minutes). Bash tool has hard 10-minute timeout that cannot be extended.
+- **Application**: Essential for CFN Loop orchestration that exceeds standard timeout limits.
+
+#### PATTERN-008: Product Owner Decision Flow
+- **Insight**: Implement explicit Product Owner decision flow after Loop 2 consensus to prevent validator scope creep and enforce strategic boundaries.
+- **Application**: Core CFN Loop governance pattern ensuring proper decision hierarchy.
+
+#### PATTERN-010: Parallel Execution with Temp Files
+- **Insight**: Use background processes with temporary files to eliminate race conditions in parallel agent coordination. Pattern: spawn all agents in background with `(skill-execution > /tmp/output-file) &`, collect PIDs, use `wait` to synchronize, read results from temp files after completion.
+- **Application**: Optimizes CFN Loop parallel agent execution while maintaining coordination integrity.
+
+### Context Management Patterns
+
+#### STRAT-021: Standardized Context Extraction Templates
+- **Insight**: Use standardized context extraction templates in coordinators. Template structure: epicGoal (1-2 sentences), inScope (list), outOfScope (list), deliverables (file paths), directory (creation path), acceptanceCriteria (measurable requirements).
+- **Application**: Prevents minimal context that causes wrong deliverables in CFN execution.
+
+#### PATTERN-020: Multi-Layer Context Injection
+- **Context**: Coordinator → Orchestrator → Agent Flow
+- **Insight**: When implementing multi-layer coordination, ensure context flows through ALL layers. Breaking this chain causes 'consensus on vapor' (high confidence, zero deliverables).
+- **Application**: Critical for CFN Loop context integrity across coordinator-orchestrator-agent chain.
+
+#### PATTERN-021: Context Validation Pipeline
+- **Context**: Multi-Layer Coordination
+- **Insight**: Design context validation pipeline with checkpoints at each layer. Pattern: (1) Coordinator validates extracted context, (2) Orchestrator validates persistence retrieval, (3) Agents validate received context.
+- **Application**: Fail-fast prevents cascading context loss in CFN workflows.
+
+#### PATTERN-022: Agent Lifecycle - Clean Exit Protocol
+- **Insight**: Agents must exit cleanly after reporting confidence. Pattern: (1) Signal done via coordination protocol, (2) Report confidence score, (3) Exit immediately.
+- **Application**: Enables adaptive agent specialization and prevents orchestrator blocking.
+
+### Sprint Execution Patterns
+
+#### Sprint Context Structure
+```json
+{
+  "sprint_name": "P1 Coordinator Monitoring",
+  "sprint_num": 1,
+  "total_sprints": 7,
+  "deliverables": [
+    "test-p1-monitoring.sh",
+    "docs/P1_MONITORING_RESULTS.md"
+  ],
+  "in_scope": [
+    "P1 coordinator monitoring validation",
+    "Test timeout mechanisms",
+    "Logging verification"
+  ],
+  "out_of_scope": [
+    "P2-P7 monitoring",
+    "Cross-priority integration",
+    "Epic-level summary"
+  ],
+  "directory": "/mnt/c/Users/masha/Documents/claude-flow-novice/tests/p1"
+}
+```
+
+#### Sprint Execution Tool: `execute-sprint-task.sh`
+- **Purpose**: Enables sprint-aware agent execution with focused context injection
+- **Usage**: Decompose large epics into focused sprints with clear deliverables and scope boundaries
+- **Key Principles**: Focused scope, incremental progress, precise deliverables, context specificity
+
+### CFN v3 Advanced Patterns
+
+#### STRAT-026: Persistence Context Storage Over CLI Parameters
+- **Insight**: Use persistence layer for complex JSON context storage instead of CLI parameters. Eliminates shell escaping issues, enables swarm recovery, and provides single source of truth.
+- **Application**: Foundation for CFN v3 dual-mode architecture.
+
+#### PATTERN-023: Dual-Mode Architecture Pattern
+- **Insight**: Implement dual execution modes (optimized vs simplified) sharing core logic. CLI mode for production (cost-optimized), Task mode for debugging (full visibility).
+- **Application**: Enables flexible CFN execution based on user needs.
+
+#### PATTERN-024: Swarm Recovery via Persistence
+- **Insight**: Store swarm state in persistence layer with TTL to enable crash recovery. Agents can resume from last known state using task_id as recovery key.
+- **Application**: Critical for long-running CFN Loops and system reliability.
+
+#### STRAT-028: Modular Skill Architecture
+- **Insight**: Decompose complex systems into independent skills (20 skills in CFN v3). Enables reuse, testing isolation, and incremental enhancement.
+- **Application**: Core architectural principle for CFN system maintainability.
+
+### CFN Anti-Patterns & Prevention
+
+#### ANTI-020: Context Storage Without Injection
+- **Context**: Coordination Systems
+- **Insight**: Avoid storing context in persistence layer without retrieving and injecting it into agent prompts.
+- **Prevention**: Always validate context injection chain: storage → retrieval → agent delivery.
+
+#### ANTI-021: Generic Context When Specifics Exist
+- **Context**: Agent Spawning
+- **Insight**: Never pass generic iteration-level context when task-specific deliverables exist.
+- **Prevention**: Always inject complete deliverables, directory paths, and acceptance criteria.
+
+#### ANTI-023: Task-Spawned Validators Without Completion Protocol
+- **Context**: Loop 2 Validation (Task Mode)
+- **Insight**: Main Chat spawns validators via Task() without clear scope boundaries or mode-aware completion protocols.
+- **Prevention**: Task-spawned validators should return structured output only - no coordination signals.
+
+### CFN Testing & Debugging
+
+#### EDGE-020: Comparative Agent Spawn Testing
+- **Context**: Context Debugging
+- **Insight**: When debugging context issues, use comparative agent spawn testing. Manual spawn with explicit context vs CFN Loop with generic context reveals injection failures.
+- **Application**: Primary debugging technique for context-related CFN issues.
+
+### Universal Anti-Patterns (CFN Relevance)
+
+#### ANTI-004: Regex Validation Anti-Pattern
+- **Insight**: Avoid simplistic regex matching for agent validation. Pattern `[[ $AGENTS =~ $AGENTS ]]` always returns true.
+- **CFN Relevance**: Critical for agent validation logic in CFN coordination.
+
+#### PATTERN-025: Comprehensive File Validation
+- **Insight**: Implement multi-stage validation including file type, permissions, size constraints, and content integrity.
+- **CFN Relevance**: Essential for CFN deliverable verification and security.
+
+#### PATTERN-026: Shell Strict Mode
+- **Insight**: Enable shell strict mode using `set -euo pipefail` for robust and predictable shell scripts.
+- **CFN Relevance**: Critical reliability pattern for all CFN skill scripts.
+
+#### PATTERN-028: Process Group Management
+- **Insight**: Implement comprehensive process group management for clean termination and resource cleanup.
+- **CFN Relevance**: Essential for CFN background process orchestration and preventing resource leaks.

package/claude-assets/agents/docker-coordinators/cfn-docker-v3-coordinator.md

@@ -1,7 +1,11 @@
 ---
-description: "CFN Docker v3 Coordinator - Container-based agent orchestration with skill-based MCP isolation"
+name: cfn-docker-v3-coordinator
+description: MUST BE USED when orchestrating container-based CFN Loop execution with MCP isolation. Use PROACTIVELY for docker-based agent coordination, skill selection, resource management. Keywords - docker, containers, orchestration, MCP, isolation
 argument-hint: "[task-description] --mode=mvp|standard|enterprise --memory-limit=1g --docker-network=mcp-network"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Grep", "Glob", "TodoWrite", "Task"]
+model: sonnet
+type: coordinator
+acl_level: 3
 ---
 
 # CFN Docker V3 Coordinator

package/claude-assets/agents/docker-team/csuite/c-suite-template.md

@@ -1,8 +1,12 @@
 ---
-description: C-Suite executive personas for strategic decision-making in organizational architecture
+name: c-suite-template
+description: MUST BE USED when creating C-Suite executive personas for strategic decision-making. Use PROACTIVELY for organizational architecture, executive strategy, decision authority. Keywords - c-suite, executive, strategy, decision-making, leadership
 tools: [Read, Write, TodoWrite, Bash]
 priority: medium
 tags: [csuite, executive, strategy, decision-making, cmo, cfo, coo, ceo]
+model: sonnet
+type: specialist
+acl_level: 4
 ---
 
 # C-Suite Agent Template

package/claude-assets/agents/docker-team/infrastructure/team-coordinator-template.md

@@ -1,8 +1,12 @@
 ---
-description: Generate team-specific coordinator configurations for Docker organizational architecture
+name: team-coordinator-template
+description: MUST BE USED when generating team-specific coordinator configurations for Docker architecture. Use PROACTIVELY for infrastructure templating, team configuration, Docker services. Keywords - docker, infrastructure, templating, coordinator, team-config
 tools: [Read, Write, Edit, Bash, Grep, Glob]
 priority: high
 tags: [docker, infrastructure, templating, coordinator, team-config]
+model: haiku
+type: specialist
+acl_level: 3
 ---
 
 # Team Coordinator Template Agent

package/claude-assets/agents/marketing_hybrid/cost_tracker.md

@@ -1,3 +1,13 @@
+---
+name: cost-tracker
+description: MUST BE USED when monitoring Z.ai worker costs during pilot testing. Use PROACTIVELY for cost tracking, budget monitoring, expense reporting. Keywords - cost, tracking, monitoring, Z.ai, budget, expenses
+tools: [Read, Write, Edit, Bash, Grep, Glob, TodoWrite]
+model: haiku
+type: specialist
+acl_level: 2
+capabilities: [cost-monitoring, budget-tracking, expense-reporting]
+---
+
 # Cost Tracking Agent
 ## Role
 Monitor Z.ai worker costs during 48-hour pilot

package/claude-assets/agents/marketing_hybrid/docker_deployer.md

@@ -1,3 +1,13 @@
+---
+name: docker-deployer
+description: MUST BE USED when deploying marketing coordinator services via Docker. Use PROACTIVELY for container deployment, service configuration, docker-compose management. Keywords - docker, deploy, containers, docker-compose, services
+tools: [Read, Write, Edit, Bash, Grep, Glob, TodoWrite]
+model: haiku
+type: specialist
+acl_level: 2
+capabilities: [docker-deployment, container-management, service-configuration]
+---
+
 # Docker Deployer Agent
 ## Role
 Deploy marketing coordinator using docker-compose.hybrid.yml

package/claude-assets/agents/marketing_hybrid/zai_worker_spawner.md

@@ -1,3 +1,13 @@
+---
+name: zai-worker-spawner
+description: MUST BE USED when spawning Z.ai workers for marketing pilot testing. Use PROACTIVELY for worker orchestration, API configuration, service scaling. Keywords - Z.ai, worker, spawner, scaling, orchestration
+tools: [Read, Write, Edit, Bash, Grep, Glob, TodoWrite]
+model: haiku
+type: specialist
+acl_level: 2
+capabilities: [worker-spawning, service-orchestration, api-configuration]
+---
+
 # Z.ai Worker Spawner Agent
 ## Role
 Spawn 3 Z.ai workers for marketing pilot

package/claude-assets/agents/project-only-agents/npm-package-specialist.md

@@ -15,15 +15,6 @@ validation_hooks:
   - agent-template-validator
   - cfn-loop-memory-validator
   - test-coverage-validator
-lifecycle:
-  pre_task: |
-    sqlite-cli exec "INSERT INTO agents (id, type, status, spawned_at)
-                     VALUES ('${AGENT_ID}', 'npm-package-specialist', 'active', CURRENT_TIMESTAMP)"
-  post_task: |
-    sqlite-cli exec "UPDATE agents
-                     SET status = 'completed', confidence = ${CONFIDENCE_SCORE},
-                         completed_at = CURRENT_TIMESTAMP
-                     WHERE id = '${AGENT_ID}'"
 acl_level: 1
 coordination_role: implementer
 mode_support: [mvp, standard, enterprise]
@@ -311,23 +302,15 @@ npm publish --tag beta
 - [ ] Documentation accessible
 - [ ] npm registry page displays correctly
 
-## SQLite Memory Integration
-
-```javascript
-// Store package configuration
-await sqlite.memoryAdapter.set(
-  `npm-package/${agentId}/config`,
-  packageConfig,
-  { aclLevel: 1, ttl: 2592000 }  // 30 days
-);
-
-// Store publish metadata
-await sqlite.memoryAdapter.set(
-  `npm-package/${agentId}/publish/${version}`,
-  publishMetadata,
-  { aclLevel: 1, ttl: 31536000 }  // 1 year
-);
-```
+## Completion Protocol
+
+Complete your work and provide a structured response with:
+- Confidence score (0.0-1.0) based on work quality
+- Summary of analysis/review completed
+- List of findings or deliverables
+- Any recommendations made
+
+**Note:** Coordination instructions are provided when spawned via CLI.
 
 ## Success Metrics
 

package/claude-assets/commands/CFN_LOOP_TASK_MODE.md

@@ -467,7 +467,7 @@ Complex/Enterprise (>5 files, >500 LOC): +code-analyzer
 ### Complexity Analysis CLI
 ```bash
 ./.claude/skills/task-complexity/analyze.sh --task "$DESC" --files "$LIST"
-# Output: {"score": 85, "category": "standard", "validators": ["reviewer","tester","architect","security-specialist"], "threshold": 0.90}
+# Output: {"score": 85, "category": "standard", "validators": ["reviewer","tester","system-architect","security-specialist"], "threshold": 0.90}
 ```
 
 ---

package/claude-assets/hooks/cfn-post-execution/memory-cleanup.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+
+# CFN Post-Execution Memory Cleanup Hook
+# Automatically cleans up memory resources after CFN operations
+
+set -euo pipefail
+
+# Hook configuration
+HOOK_SCRIPT_PATH="$(dirname "$0")/memory-cleanup.sh"
+MEMORY_MANAGEMENT_SKILL="$(dirname "$0")/../../skills/cfn-memory-management/cleanup-memory.sh"
+
+# Use the memory management skill if available, otherwise use local fallback
+if [[ -f "$MEMORY_MANAGEMENT_SKILL" ]]; then
+    exec "$MEMORY_MANAGEMENT_SKILL" "$@"
+elif [[ -f "$HOOK_SCRIPT_PATH" ]]; then
+    exec "$HOOK_SCRIPT_PATH" "$@"
+else
+    echo "WARNING: Memory cleanup scripts not found, skipping cleanup"
+    exit 0
+fi

package/claude-assets/hooks/cfn-pre-execution/memory-check.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+
+# CFN Pre-Execution Memory Check Hook
+# Automatically checks memory availability before CFN operations
+
+set -euo pipefail
+
+# Hook configuration
+HOOK_SCRIPT_PATH="$(dirname "$0")/memory-check.sh"
+MEMORY_MANAGEMENT_SKILL="$(dirname "$0")/../../skills/cfn-memory-management/check-memory.sh"
+
+# Use the memory management skill if available, otherwise use local fallback
+if [[ -f "$MEMORY_MANAGEMENT_SKILL" ]]; then
+    exec "$MEMORY_MANAGEMENT_SKILL" "$@"
+elif [[ -f "$HOOK_SCRIPT_PATH" ]]; then
+    exec "$HOOK_SCRIPT_PATH" "$@"
+else
+    echo "WARNING: Memory check scripts not found, proceeding without memory validation"
+    exit 0
+fi

package/claude-assets/skills/agent-lifecycle/SKILL.md

@@ -0,0 +1,60 @@
+# Agent Lifecycle Management Skill
+
+**Purpose:** Enable agents to execute SQLite lifecycle hooks for auditing purposes
+
+**Description:** This skill provides agents with the ability to register their lifecycle events (spawn, confidence updates, completion) in a SQLite database for audit trail and cross-session recovery.
+
+## Usage
+
+### Agent Spawn Registration
+```bash
+# Register agent when starting work
+./.claude/skills/agent-lifecycle/execute-lifecycle-hook.sh spawn \
+  --agent-id "${AGENT_ID}" \
+  --agent-type "${AGENT_TYPE}" \
+  --acl-level 1 \
+  --name "${AGENT_NAME}"
+```
+
+### Confidence Updates
+```bash
+# Update confidence during work
+./.claude/skills/agent-lifecycle/execute-lifecycle-hook.sh update \
+  --agent-id "${AGENT_ID}" \
+  --confidence 0.85 \
+  --reasoning "Implementation complete, all tests passing"
+```
+
+### Agent Completion
+```bash
+# Mark agent as completed
+./.claude/skills/agent-lifecycle/execute-lifecycle-hook.sh complete \
+  --agent-id "${AGENT_ID}" \
+  --confidence 0.90 \
+  --output "Successfully implemented feature with 95% test coverage"
+```
+
+## Integration in Agent Profiles
+
+Add to agent completion protocol:
+
+```markdown
+## Lifecycle Management
+- Execute spawn registration at start
+- Update confidence during implementation
+- Log completion with confidence score
+- Maintain audit trail in SQLite database
+```
+
+## Database Schema
+
+The SQLite database contains:
+- `agents` table: Agent information and status
+- `lifecycle_events` table: Complete audit trail
+
+## Security
+
+- ACL levels enforced (1-6)
+- Input validation for all parameters
+- Sanitized error messages
+- Atomic operations to prevent race conditions