claude-flow-novice 2.18.13 → 2.18.14

package/.claude/skills/cfn-local-ruvector-accelerator/test_schema.sql

@@ -0,0 +1,158 @@
+-- Test Schema v2 Design
+
+-- Test 1: Verify all tables can be created
+.mode column
+.headers on
+
+-- Create schema
+.output /dev/null
+.read <<SCHEMA
+CREATE TABLE entities (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    kind TEXT NOT NULL,
+    name TEXT NOT NULL,
+    signature TEXT,
+    visibility TEXT NOT NULL DEFAULT 'private',
+    parent_id INTEGER,
+    file_path TEXT NOT NULL,
+    line_number INTEGER NOT NULL,
+    column_number INTEGER,
+    doc_comment TEXT,
+    attributes TEXT,
+    metadata TEXT,
+    created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    updated_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    
+    FOREIGN KEY (parent_id) REFERENCES entities(id) ON DELETE CASCADE
+);
+
+CREATE TABLE refs (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    source_entity_id INTEGER NOT NULL,
+    target_entity_id INTEGER NOT NULL,
+    ref_kind TEXT NOT NULL,
+    file_path TEXT NOT NULL,
+    line_number INTEGER NOT NULL,
+    column_number INTEGER,
+    context TEXT,
+    created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    
+    FOREIGN KEY (source_entity_id) REFERENCES entities(id) ON DELETE CASCADE,
+    FOREIGN KEY (target_entity_id) REFERENCES entities(id) ON DELETE CASCADE
+);
+
+CREATE TABLE type_usage (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    entity_id INTEGER NOT NULL,
+    type_name TEXT NOT NULL,
+    usage_kind TEXT NOT NULL,
+    file_path TEXT NOT NULL,
+    line_number INTEGER NOT NULL,
+    created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    
+    FOREIGN KEY (entity_id) REFERENCES entities(id) ON DELETE CASCADE
+);
+
+CREATE TABLE modules (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL UNIQUE,
+    file_path TEXT NOT NULL,
+    module_type TEXT NOT NULL,
+    is_root BOOLEAN NOT NULL DEFAULT FALSE,
+    parent_module_id INTEGER,
+    created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    
+    FOREIGN KEY (parent_module_id) REFERENCES modules(id) ON DELETE CASCADE
+);
+
+CREATE TABLE entity_embeddings (
+    entity_id INTEGER PRIMARY KEY,
+    embedding BLOB NOT NULL,
+    embedding_model TEXT NOT NULL,
+    created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    
+    FOREIGN KEY (entity_id) REFERENCES entities(id) ON DELETE CASCADE
+);
+SCHEMA
+.output stdout
+
+-- Test 2: Insert sample data
+INSERT INTO entities (kind, name, signature, visibility, file_path, line_number) VALUES 
+('struct', 'MyStruct', 'struct MyStruct { field: i32 }', 'public', '/src/lib.rs', 10),
+('function', 'my_function', 'fn my_function() -> Result<()>', 'public', '/src/lib.rs', 20),
+('enum', 'MyEnum', 'enum MyEnum { A, B }', 'public', '/src/types.rs', 5);
+
+-- Test 3: Insert reference
+INSERT INTO refs (source_entity_id, target_entity_id, ref_kind, file_path, line_number)
+VALUES (2, 1, 'reference', '/src/lib.rs', 21);
+
+-- Test 4: Insert type usage
+INSERT INTO type_usage (entity_id, type_name, usage_kind, file_path, line_number)
+VALUES (2, 'MyStruct', 'parameter', '/src/lib.rs', 20);
+
+-- Test 5: Test indexes
+CREATE INDEX idx_entities_kind ON entities(kind);
+CREATE INDEX idx_entities_name ON entities(name);
+CREATE INDEX idx_entities_file_path ON entities(file_path);
+CREATE INDEX idx_entities_kind_name ON entities(kind, name);
+CREATE INDEX idx_entities_file_kind ON entities(file_path, kind);
+
+CREATE INDEX idx_refs_source ON refs(source_entity_id);
+CREATE INDEX idx_refs_target ON refs(target_entity_id);
+CREATE INDEX idx_refs_kind ON refs(ref_kind);
+
+CREATE INDEX idx_type_usage_type_name ON type_usage(type_name);
+CREATE INDEX idx_type_usage_type_kind ON type_usage(type_name, usage_kind);
+
+-- Test 6: Performance queries
+.echo on
+EXPLAIN QUERY PLAN 
+SELECT e.* FROM entities e 
+WHERE e.kind = 'struct' AND e.name = 'MyStruct'
+LIMIT 1;
+
+EXPLAIN QUERY PLAN
+SELECT e.* FROM entities e
+WHERE e.file_path = '/src/lib.rs'
+ORDER BY e.line_number;
+
+EXPLAIN QUERY PLAN
+SELECT r.*, e.name as target_name
+FROM refs r
+JOIN entities e ON r.target_entity_id = e.id
+WHERE r.source_entity_id = 2;
+
+EXPLAIN QUERY PLAN
+SELECT DISTINCT e.*
+FROM type_usage tu
+JOIN entities e ON tu.entity_id = e.id
+WHERE tu.type_name = 'MyStruct';
+
+-- Test 7: Verify foreign keys
+PRAGMA foreign_key_check;
+
+-- Test 8: Get statistics
+SELECT 
+    'entities' as table_name, COUNT(*) as count FROM entities
+UNION ALL
+SELECT 
+    'refs' as table_name, COUNT(*) as count FROM refs
+UNION ALL
+SELECT 
+    'type_usage' as table_name, COUNT(*) as count FROM type_usage
+UNION ALL
+SELECT 
+    'modules' as table_name, COUNT(*) as count FROM modules
+UNION ALL
+SELECT 
+    'entity_embeddings' as table_name, COUNT(*) as count FROM entity_embeddings;
+
+-- Cleanup
+DROP TABLE IF EXISTS refs;
+DROP TABLE IF EXISTS type_usage;
+DROP TABLE IF EXISTS entity_embeddings;
+DROP TABLE IF EXISTS modules;
+DROP TABLE IF EXISTS entities;
+
+.echo off
+SELECT 'Schema test completed successfully' as result;

package/.claude/skills/cfn-local-ruvector-accelerator/test_schema_v2.sql

@@ -0,0 +1,147 @@
+-- Test Schema v2 Design
+.mode column
+.headers on
+
+-- Test 1: Create all tables
+CREATE TABLE entities (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    kind TEXT NOT NULL,
+    name TEXT NOT NULL,
+    signature TEXT,
+    visibility TEXT NOT NULL DEFAULT 'private',
+    parent_id INTEGER,
+    file_path TEXT NOT NULL,
+    line_number INTEGER NOT NULL,
+    column_number INTEGER,
+    doc_comment TEXT,
+    attributes TEXT,
+    metadata TEXT,
+    created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    updated_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    
+    FOREIGN KEY (parent_id) REFERENCES entities(id) ON DELETE CASCADE
+);
+
+CREATE TABLE refs (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    source_entity_id INTEGER NOT NULL,
+    target_entity_id INTEGER NOT NULL,
+    ref_kind TEXT NOT NULL,
+    file_path TEXT NOT NULL,
+    line_number INTEGER NOT NULL,
+    column_number INTEGER,
+    context TEXT,
+    created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    
+    FOREIGN KEY (source_entity_id) REFERENCES entities(id) ON DELETE CASCADE,
+    FOREIGN KEY (target_entity_id) REFERENCES entities(id) ON DELETE CASCADE
+);
+
+CREATE TABLE type_usage (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    entity_id INTEGER NOT NULL,
+    type_name TEXT NOT NULL,
+    usage_kind TEXT NOT NULL,
+    file_path TEXT NOT NULL,
+    line_number INTEGER NOT NULL,
+    created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    
+    FOREIGN KEY (entity_id) REFERENCES entities(id) ON DELETE CASCADE
+);
+
+CREATE TABLE modules (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL UNIQUE,
+    file_path TEXT NOT NULL,
+    module_type TEXT NOT NULL,
+    is_root BOOLEAN NOT NULL DEFAULT FALSE,
+    parent_module_id INTEGER,
+    created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    
+    FOREIGN KEY (parent_module_id) REFERENCES modules(id) ON DELETE CASCADE
+);
+
+CREATE TABLE entity_embeddings (
+    entity_id INTEGER PRIMARY KEY,
+    embedding BLOB NOT NULL,
+    embedding_model TEXT NOT NULL,
+    created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    
+    FOREIGN KEY (entity_id) REFERENCES entities(id) ON DELETE CASCADE
+);
+
+-- Test 2: Insert sample data
+INSERT INTO entities (kind, name, signature, visibility, file_path, line_number) VALUES 
+('struct', 'MyStruct', 'struct MyStruct { field: i32 }', 'public', '/src/lib.rs', 10),
+('function', 'my_function', 'fn my_function() -> Result<()>', 'public', '/src/lib.rs', 20),
+('enum', 'MyEnum', 'enum MyEnum { A, B }', 'public', '/src/types.rs', 5);
+
+-- Test 3: Insert reference
+INSERT INTO refs (source_entity_id, target_entity_id, ref_kind, file_path, line_number)
+VALUES (2, 1, 'reference', '/src/lib.rs', 21);
+
+-- Test 4: Insert type usage
+INSERT INTO type_usage (entity_id, type_name, usage_kind, file_path, line_number)
+VALUES (2, 'MyStruct', 'parameter', '/src/lib.rs', 20);
+
+-- Test 5: Test indexes
+CREATE INDEX idx_entities_kind ON entities(kind);
+CREATE INDEX idx_entities_name ON entities(name);
+CREATE INDEX idx_entities_file_path ON entities(file_path);
+CREATE INDEX idx_entities_kind_name ON entities(kind, name);
+CREATE INDEX idx_entities_file_kind ON entities(file_path, kind);
+
+CREATE INDEX idx_refs_source ON refs(source_entity_id);
+CREATE INDEX idx_refs_target ON refs(target_entity_id);
+CREATE INDEX idx_refs_kind ON refs(ref_kind);
+
+CREATE INDEX idx_type_usage_type_name ON type_usage(type_name);
+CREATE INDEX idx_type_usage_type_kind ON type_usage(type_name, usage_kind);
+
+-- Test 6: Performance queries
+SELECT 'Query 1: Find struct by name' as test;
+EXPLAIN QUERY PLAN 
+SELECT e.* FROM entities e 
+WHERE e.kind = 'struct' AND e.name = 'MyStruct'
+LIMIT 1;
+
+SELECT 'Query 2: List entities in file' as test;
+EXPLAIN QUERY PLAN
+SELECT e.* FROM entities e
+WHERE e.file_path = '/src/lib.rs'
+ORDER BY e.line_number;
+
+SELECT 'Query 3: Find references from entity' as test;
+EXPLAIN QUERY PLAN
+SELECT r.*, e.name as target_name
+FROM refs r
+JOIN entities e ON r.target_entity_id = e.id
+WHERE r.source_entity_id = 2;
+
+SELECT 'Query 4: Find entities using type' as test;
+EXPLAIN QUERY PLAN
+SELECT DISTINCT e.*
+FROM type_usage tu
+JOIN entities e ON tu.entity_id = e.id
+WHERE tu.type_name = 'MyStruct';
+
+-- Test 7: Verify foreign keys
+PRAGMA foreign_key_check;
+
+-- Test 8: Get statistics
+SELECT 
+    'entities' as table_name, COUNT(*) as count FROM entities
+UNION ALL
+SELECT 
+    'refs' as table_name, COUNT(*) as count FROM refs
+UNION ALL
+SELECT 
+    'type_usage' as table_name, COUNT(*) as count FROM type_usage
+UNION ALL
+SELECT 
+    'modules' as table_name, COUNT(*) as count FROM modules
+UNION ALL
+SELECT 
+    'entity_embeddings' as table_name, COUNT(*) as count FROM entity_embeddings;
+
+SELECT 'Schema v2 test completed successfully' as result;

package/.claude/skills/cfn-mdap-context-injection/SKILL.md

@@ -1,14 +1,35 @@
-# For Docker issues
-bash .claude/skills/cfn-mdap-context-injection/inject.sh --docker
+---
+name: cfn-mdap-context-injection
+description: Inject MDAP codebase files for troubleshooting (coordinator, implementers, validators, Docker, orchestration)
+version: 1.0.0
+tags: context-injection, debugging, mdap
+status: production
 
-# For CLI mode issues
-bash .claude/skills/cfn-mdap-context-injection/inject.sh --cli
+# What it does
+Outputs portions of CFN MDAP codebase grouped by functional area for debugging. Provides immediate context without reading entire codebase.
 
-# For orchestration issues
-bash .claude/skills/cfn-mdap-context-injection/inject.sh --cfn-loop
+# When to use
+1. Docker mode failures → --docker flag
+2. CLI mode issues → --cli flag  
+3. Orchestration deadlocks → --cfn-loop flag
+4. Full MDAP workflow → --all flag
 
-# For full MDAP workflow
-bash .claude/skills/cfn-mdap-context-injection/inject.sh --all
+# When NOT to use
+1. Need few files → Use Read directly
+2. Runtime logs → Use docker logs
+3. Documentation → Check docs/ first
+4. Token budget critical → Start with --coordinator
 
-# Combine contexts as needed
-bash .claude/skills/cfn-mdap-context-injection/inject.sh --docker --cfn-loop
+# How to use
+Basic: bash inject.sh --docker
+Advanced: bash inject.sh --docker --cfn-loop (combined contexts)
+Full: bash inject.sh --all --ruvector --tests (~260K tokens)
+
+# Parameters
+--all, --coordinator, --mdap, --cli, --docker, --cfn-loop, --config, --decomposers, --validators, --index, --ruvector, --tests, --file <path>
+
+# Expected output
+Concatenated file contents with === FILE: path === delimiters
+
+# Real-world example
+Docker specialist debugging "infinite wait in Wave 2" runs --docker --cfn-loop to get configs + orchestration in one injection.

package/.claude/skills/cfn-mdap-error-fixer/skill.md

@@ -1,205 +1,15 @@
----
-name: cfn-mdap-error-fixer
-description: Two-phase Rust compilation error fixer using Cerebras LLM bulk processing + dedicated agent cleanup
-version: 1.0.0
-tags: [rust, compilation, cerebras, error-fixer, mdap]
-status: production
----
-
-# MDAP Rust Compilation Error Fixer
-
-Two-phase workflow for fixing large-scale Rust compilation errors using Cerebras LLM bulk processing + dedicated agent cleanup.
-
-## Skill Structure
-
-```
-cfn-mdap-error-fixer/
-├── skill.md              # This file
-├── HANDOFF.md            # Detailed handoff documentation
-└── lib/
-    └── fixer/
-        ├── package.json                # Dependencies (npm install)
-        └── cerebras-gated-fixer-v2.ts  # V2 fixer (self-contained)
-```
-
-## Overview
-
-This skill orchestrates:
-1. **Phase 1**: Cerebras LLM bulk fixer (fast, cheap, ~97% reduction)
-2. **Phase 2**: Dedicated rust-developer agent (high quality cleanup)
-
-## Phase 1: Cerebras Bulk Fixer
-
-### When to Use
-- 50+ compilation errors
-- Need fast bulk reduction
-- Errors are mostly mechanical (type mismatches, missing imports)
-
-### How to Run
-
-```bash
-# Setup (one-time)
-cd .claude/skills/cfn-mdap-error-fixer/lib/fixer
-npm install
-
-# Run from your Rust project directory
-cd /path/to/your/rust-project
-export CEREBRAS_API_KEY="your-key"
-npx tsx /path/to/.claude/skills/cfn-mdap-error-fixer/lib/fixer/cerebras-gated-fixer-v2.ts
-
-# Or specify project path explicitly
-npx tsx cerebras-gated-fixer-v2.ts --project=/path/to/rust-project
-
-# Or use environment variable
-export RUST_PROJECT_PATH=/path/to/rust-project
-npx tsx cerebras-gated-fixer-v2.ts
-
-# Additional flags
-npx tsx cerebras-gated-fixer-v2.ts --dry-run  # Preview patches without writing
-npx tsx cerebras-gated-fixer-v2.ts --verbose  # Debug output
-npx tsx cerebras-gated-fixer-v2.ts --no-layer3  # Skip LLM review layer
-```
-
-### Architecture
-
-```
-┌─────────────────┐
-│  cargo check    │ → Parse errors
-└────────┬────────┘
-         ▼
-┌─────────────────┐
-│ Cerebras LLM    │ → Generate fix (zai-glm-4.6)
-└────────┬────────┘
-         ▼
-┌─────────────────────────────────────────┐
-│     LAYER 1: 12 Structural Gates        │
-├─────────────────────────────────────────┤
-│ A: LineCount    B: FnSignature          │
-│ C: ImportDup    D: BraceBalance         │
-│ E: SemanticDiff F: OrphanedCode         │
-│ G: ImportPath   H: PatternDup           │
-│ I: ImplLocation J: TypeCast             │
-│ K: MatchArm     L: Regression           │
-└────────┬────────────────────────────────┘
-         ▼ (up to 3 retries with feedback)
-┌─────────────────────────────────────────┐
-│     LAYER 2: cargo check validation     │
-└────────┬────────────────────────────────┘
-         ▼
-┌─────────────────────────────────────────┐
-│     LAYER 3: LLM Review Gate            │
-└────────┬────────────────────────────────┘
-         ▼
-┌─────────────────┐
-│  Write to file  │
-└─────────────────┘
-```
-
-### Expected Results
-- **Input**: 500-600 errors
-- **Output**: 10-20 errors (97%+ reduction)
-- **Quality**: 4-5/10 (some semantic issues)
-
-### Logs
-- `/tmp/v2-retry-run.log` - Full run output
-- `/tmp/gate-rejections.json` - Gate rejection details
-
----
-
-## Phase 2: Dedicated Agent Cleanup
-
-### When to Use
-- After Phase 1 completes
-- <50 errors remaining
-- Need high-quality fixes (8-10/10)
-
-### How to Invoke
-
-Spawn a rust-developer agent with this prompt:
-
-```
-You are a Rust compilation error fixer. Fix the remaining errors in the Rust services codebase.
-
-CONTEXT:
-- Cerebras LLM already fixed ~97% of errors
-- Quality validation found some semantic issues in applied fixes
-- Remaining errors are mechanical: type mismatches, missing imports
-
-WORKING DIRECTORY:
-cd <YOUR_RUST_PROJECT_PATH>  # e.g., services/rust-services
-
-STEP 1: Get current error count and locations
-SQLX_OFFLINE=true cargo check 2>&1 | grep -E "^error\[E" | sort | uniq -c | sort -rn
-
-STEP 2: For each error file, fix in order of dependency:
-1. Read the FULL file to understand context
-2. Identify the root cause (not just the symptom)
-3. Apply minimal fix that preserves semantics
-4. Run `SQLX_OFFLINE=true cargo check` to verify
-5. If new errors appear, fix those too
-
-RULES:
-- Read FULL file before editing (not just error snippets)
-- Preserve ALL existing imports, don't duplicate
-- Use proper Rust idioms (? operator, as casts, trait bounds)
-- Fix root causes first (cascading errors will resolve)
-- Verify with cargo check after EACH file
-
-COMMON ERROR TYPES:
-- E0308 (type mismatch): Add explicit casts or fix generics
-- E0412/E0433/E0425 (missing type/import): Add `use` statements
-- E0599 (wrong method): Fix method chain (e.g., .ok_or_else() on Result)
-
-Report final error count when done.
-```
-
-### Expected Results
-- **Input**: 10-20 errors
-- **Output**: 0 errors
-- **Quality**: 9-10/10
-
----
-
-## Full Workflow Example
-
-```bash
-# 1. Check initial error count
-cd <YOUR_RUST_PROJECT_PATH>
-SQLX_OFFLINE=true cargo check 2>&1 | grep -c "^error\["
-# Output: 581
-
-# 2. Run Phase 1 (Cerebras bulk fixer)
-cd .claude/skills/cfn-mdap-error-fixer/lib/fixer
-export CEREBRAS_API_KEY="your-key"
-npx tsx cerebras-gated-fixer-v2.ts 2>&1 | tee /tmp/run.log
-# Output: 581 → 16 (97.2% reduction)
-
-# 3. Validate quality (optional)
-# Spawn 4 parallel code-reviewer agents to assess fix quality
-
-# 4. Run Phase 2 (dedicated agent cleanup)
-# Spawn rust-developer agent with prompt above
-# Output: 16 → 0
-
-# 5. Final verification
-SQLX_OFFLINE=true cargo check
-# Output: Finished dev profile
-```
-
----
-
-## Files Reference
-
-| File | Purpose |
-|------|---------|
-| `./HANDOFF.md` | Detailed handoff documentation |
-| `./lib/fixer/cerebras-gated-fixer-v2.ts` | V2 fixer (self-contained, 46KB) |
-| `/tmp/gate-rejections.json` | Gate rejection log (runtime) |
-| `/tmp/v2-retry-run.log` | Full run output (runtime) |
-
-## Environment Requirements
-
-- Node.js 18+
-- Rust 1.86.0
-- `CEREBRAS_API_KEY` in `.env`
-- `SQLX_OFFLINE=true` for cargo check without DB
+# Setup (one-time)
+cd .claude/skills/cfn-mdap-error-fixer/lib/fixer
+npm install
+
+# Run from your Rust project directory
+cd /path/to/your/rust-project
+export CEREBRAS_API_KEY="your-key"
+npx tsx /path/to/.claude/skills/cfn-mdap-error-fixer/lib/fixer/cerebras-gated-fixer-v2.ts
+
+# Or specify project path explicitly
+npx tsx cerebras-gated-fixer-v2.ts --project=/path/to/rust-project
+
+# Or use environment variable
+export RUST_PROJECT_PATH=/path/to/rust-project
+npx tsx cerebras-gated-fixer-v2.ts

package/.claude/skills/cfn-session-handoff/SKILL.md

@@ -1,53 +1 @@
----
-name: cfn-session-handoff
-type: skill
-description: Session handoff functionality is provided by the handoff-coordinator agent
-version: 1.0.0
-status: delegated
-triggers:
-  - When: Session transition or context reset is needed
-  - Who: Teams requiring handoff documentation
-usage: See handoff-coordinator agent at .claude/agents/cfn-dev-team/coordinators/handoff-coordinator.md
----
-
-# CFN Session Handoff
-
-## Status: DELEGATED TO AGENT
-
-This skill's functionality is now provided by the **handoff-coordinator agent**.
-
-## Actual Implementation Location
-
-`.claude/agents/cfn-dev-team/coordinators/handoff-coordinator.md`
-
-## Usage
-
-Instead of using this skill, invoke the handoff-coordinator agent directly:
-
-```bash
-npx claude-flow-novice agent-spawn handoff-coordinator \
-  --task-id "handoff-$(date +%s)" \
-  --prompt "Create session handoff for [domain], duration: [hours], focus: [areas]"
-```
-
-## Features Provided by Agent
-
-- Extracts recent context from conversation history
-- Generates comprehensive handoff documentation
-- Creates smoke test scripts for validation
-- Maintains context continuity across sessions
-
-## Migration Note
-
-This skill was deprecated in favor of the agent-based approach which provides:
-- Better integration with CFN Loop
-- More sophisticated context extraction
-- Direct agent-to-agent communication
-- Automated session state management
-
-## Documentation Retained
-
-This SKILL.md is retained for:
-- Historical reference
-- Search visibility
-- Redirecting users to the actual implementation
+Task("handoff-coordinator", prompt with session context)

package/.claude/skills/cfn-task-decomposition/SKILL.md

@@ -0,0 +1 @@
+./decompose-task.sh --task-id=ts-errors --description="Fix all TypeScript errors in the codebase" --tool-budget=12 --complexity=high

package/.claude/skills/cfn-task-intelligence/SKILL.md

@@ -1,18 +1,39 @@
-task-intelligence/
-├── SKILL.md                          # This file
-├── cfn-task-intelligence.sh          # Main CLI interface
-└── lib/
-    ├── classifier/                   # Task classification
-    │   ├── SKILL.md
-    │   └── classify-task.sh
-    ├── complexity/                   # Complexity estimation
-    │   ├── SKILL.md
-    │   └── estimate-complexity.sh
-    ├── specialist/                   # Specialist recommendation
-    │   ���── SKILL.md
-    │   └── recommend-specialist.sh
-    └── integration/                  # System integration layer
-        ├── SKILL.md
-        ├── pre-execution-hook.sh
-        ├── post-feedback-hook.sh
-        └── learning-loop.sh
+---
+name: cfn-task-intelligence
+description: Classify tasks (type/domain), estimate complexity/iterations, recommend specialists from feedback themes
+version: 1.0.0
+tags: classification, complexity, specialists, cfn-loop
+status: production
+---
+
+# What it does
+Analyzes task descriptions → classifies type (software, content, research, design, infrastructure, data), detects domains (frontend, backend, security, devops, testing, database, docs), estimates complexity + iterations, recommends specialists from recurring feedback.
+
+# When to use
+1. New task → Determine CFN Loop config and agents
+2. Estimate iterations → How many loops before gates pass
+3. Recurring issues → After 3 security feedback, recommend security-specialist
+4. Multi-agent coordination → Identify domains and dependencies
+
+# When NOT to use
+1. Task already classified → Proceed with execution
+2. Simple type check → Use /write-plan instead
+3. Agent failure debugging → Use /cfn-check-errors
+4. Adjust teams mid-execution → Use /cfn-agent-lifecycle
+
+# How to use
+Classify: ./cfn-task-intelligence.sh --task-description "..." --mode classify
+Complexity: --mode complexity (returns iterations 2-7, confidence 0.70-0.80)
+Specialist: --mode specialist --current-loop3 "..." --feedback-themes "security,auth" --recurring-count 3
+Full: --mode all
+
+# Parameters
+--task-description, --mode (classify/complexity/specialist/all), --current-loop3, --feedback-themes, --recurring-count
+
+# Expected output
+Classify: {task_type, domains[], complexity, keyword_counts}
+Complexity: {complexity, estimated_iterations, confidence, factors, reasoning}
+Specialist: {add_specialist, reasoning, new_loop3_agents[]}
+
+# Real-world
+"Microservice with K8s and streaming" → infrastructure, [backend,devops,database], high, 6 iterations → spawn DevOps + backend, enterprise mode