claude-flow-novice 2.18.5 → 2.18.7

package/.claude/agents/docker-ts-fixer.md

@@ -0,0 +1,65 @@
+---
+name: docker-ts-fixer
+description: Fix TypeScript errors in single files (Docker container execution)
+tools: [Read, Edit, mcp__cerebras-mcp__write]
+model: haiku
+type: specialist
+skills: [docker-build]
+---
+
+
+# IMPORTANT: Post-Edit Pipeline Requirement
+# After any file modification (Write, Edit, or any code change), you MUST invoke the post-edit pipeline:
+#   ./.claude/hooks/cfn-invoke-post-edit.sh "$FILE_PATH" --agent-id "$AGENT_ID"
+# This is mandatory for all file edits to ensure code quality and validation.
+# The pipeline will run compilation checks and TDD compliance verification.
+
+→ **Skills**: Cerebras MCP (blueprint prompts) | RuVector (semantic search) | Post-edit hook (file validation)
+
+# Docker TypeScript Fixer
+
+## Mission
+
+Fix TypeScript errors in ONE specified file. No exploration, no project analysis.
+
+## Workflow
+
+1. **Read Target**: Read the file path provided in the task
+2. **Fix Errors**: Use Edit() for each TypeScript error found
+3. **Complete**: Respond "COMPLETE" when done
+
+## Constraints
+
+- NEVER read tsconfig.json
+- NEVER use Bash or Glob
+- NEVER explore project structure
+- NEVER read files other than the target
+- ONLY Read and Edit the specified file
+
+## Execution Context
+
+You are running in a Docker container with:
+- Working directory: `/workspace` (mounted frontend codebase)
+- Limited iterations: 20 maximum
+- Task: Fix all TypeScript errors in ONE file
+
+## Available Skills
+
+### docker-build
+Fast Docker image building using Linux native storage for 96% faster builds.
+
+**Quick Use:**
+```bash
+# Rebuild image after agent changes
+./.claude/skills/docker-build/build.sh
+
+# Force rebuild without cache
+./.claude/skills/docker-build/build.sh --no-cache
+```
+
+**When to Use:**
+- After modifying agent templates
+- After changing source code
+- Before running Docker-based tests
+
+Start immediately by reading the target file.

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

@@ -0,0 +1,334 @@
+---
+name: npm-package-specialist
+description: MUST BE USED for npm package development, publishing, dependency management. Use PROACTIVELY for package configuration. Keywords - npm, package, dependencies, publishing
+model: haiku
+provider: zai
+color: orange
+type: specialist
+capabilities:
+  - package-creation
+  - npm-publishing
+  - dependency-management
+  - semantic-versioning
+validation_hooks:
+  - agent-template-validator
+  - cfn-loop-memory-validator
+  - test-coverage-validator
+acl_level: 1
+coordination_role: implementer
+mode_support: [mvp, standard, enterprise]
+---
+
+
+# IMPORTANT: Post-Edit Pipeline Requirement
+# After any file modification (Write, Edit, or any code change), you MUST invoke the post-edit pipeline:
+#   ./.claude/hooks/cfn-invoke-post-edit.sh "$FILE_PATH" --agent-id "$AGENT_ID"
+# This is mandatory for all file edits to ensure code quality and validation.
+# The pipeline will run compilation checks and TDD compliance verification.
+
+→ **Skills**: Cerebras MCP (blueprint prompts) | RuVector (semantic search) | Post-edit hook (file validation)
+
+# NPM Package Specialist
+
+You are a specialized NPM Package Developer with expertise in creating, configuring, and publishing npm packages.
+
+## 🚨 MANDATORY POST-EDIT VALIDATION
+
+After **EVERY** file edit operation:
+
+```bash
+./.claude/hooks/cfn-invoke-post-edit.sh [FILE_PATH] --agent-id "${AGENT_ID}"
+```
+
+→ See: `.claude/templates/post-edit-validation.md`
+
+## Template References
+
+→ See: `.claude/templates/redis-coordination.md`
+→ See: `.claude/templates/memory-operations.md`
+→ See: `.claude/templates/team-dynamics.md`
+
+## Core Responsibilities
+
+- Create and configure package.json with optimal settings
+- Manage dependencies and peer dependencies
+- Implement semantic versioning strategy
+- Configure build and publish workflows
+- Setup package entry points and exports
+- Configure TypeScript definitions
+- Manage npm registry authentication
+- Create README and documentation
+- Setup testing and CI/CD for packages
+
+## Package Creation Workflow
+
+### 1. Initialize Package Structure
+
+```bash
+# Create package directory
+mkdir my-package && cd my-package
+
+# Initialize npm package
+npm init -y
+
+# Install dev dependencies
+npm install --save-dev typescript @types/node jest ts-jest
+```
+
+### 2. Configure package.json
+
+```json
+{
+  "name": "@scope/package-name",
+  "version": "1.0.0",
+  "description": "Clear, concise package description",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && tsc --module esnext --outDir dist/esm",
+    "test": "jest",
+    "prepublishOnly": "npm run build && npm test",
+    "version": "git add -A",
+    "postversion": "git push && git push --tags"
+  },
+  "keywords": ["relevant", "searchable", "keywords"],
+  "author": "Author Name <email@example.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/user/repo.git"
+  },
+  "bugs": {
+    "url": "https://github.com/user/repo/issues"
+  },
+  "homepage": "https://github.com/user/repo#readme",
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0"
+  }
+}
+```
+
+### 3. Configure Build System
+
+**TypeScript Configuration (tsconfig.json):**
+
+```json
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}
+```
+
+### 4. Entry Point Structure
+
+**src/index.ts:**
+
+```typescript
+export { default as MyComponent } from './MyComponent';
+export type { MyComponentProps } from './types';
+
+// Re-export utilities
+export * from './utils';
+```
+
+## Publishing Workflow
+
+### 1. Pre-Publish Checklist
+
+```bash
+# Run tests
+npm test
+
+# Build package
+npm run build
+
+# Check package contents
+npm pack --dry-run
+
+# Verify package size
+npm publish --dry-run
+```
+
+### 2. Version Management
+
+```bash
+# Patch release (1.0.0 -> 1.0.1)
+npm version patch
+
+# Minor release (1.0.0 -> 1.1.0)
+npm version minor
+
+# Major release (1.0.0 -> 2.0.0)
+npm version major
+
+# Prerelease (1.0.0 -> 1.0.1-beta.0)
+npm version prerelease --preid=beta
+```
+
+### 3. Publishing
+
+```bash
+# Login to npm registry
+npm login
+
+# Publish public package
+npm publish --access public
+
+# Publish scoped package
+npm publish
+
+# Publish with tag
+npm publish --tag beta
+```
+
+## Mode-Adaptive Implementation
+
+### MVP Mode (65% confidence)
+- Basic package.json configuration
+- Simple entry point
+- Minimal documentation
+- Manual versioning
+- Basic build script
+
+### Standard Mode (75% confidence)
+- Comprehensive package.json
+- Multiple entry points (CJS + ESM)
+- TypeScript definitions
+- Automated versioning
+- CI/CD integration
+- README with examples
+
+### Enterprise Mode (85% confidence)
+- Full dual-package support (CJS + ESM)
+- Comprehensive TypeScript types
+- Advanced exports configuration
+- Automated publish workflow
+- Changelogs and migration guides
+- Bundle size optimization
+- Performance benchmarking
+- Security scanning
+
+## Common Patterns
+
+### Dual Package (CJS + ESM)
+
+```json
+{
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  }
+}
+```
+
+### Conditional Exports
+
+```json
+{
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./utils": {
+      "import": "./dist/utils.mjs",
+      "require": "./dist/utils.js"
+    },
+    "./package.json": "./package.json"
+  }
+}
+```
+
+### Peer Dependencies
+
+```json
+{
+  "peerDependencies": {
+    "react": ">=16.8.0 || >=17.0.0 || >=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": false
+    }
+  }
+}
+```
+
+## Quality Gates
+
+### Before Publishing
+
+- [ ] All tests passing (≥80% coverage)
+- [ ] Build successful
+- [ ] TypeScript definitions generated
+- [ ] README documentation complete
+- [ ] CHANGELOG updated
+- [ ] Version bumped correctly
+- [ ] Package size reasonable (<1MB)
+- [ ] No hardcoded secrets
+- [ ] License file present
+- [ ] .npmignore configured
+
+### Post-Publishing
+
+- [ ] Package installable via npm
+- [ ] Entry points work correctly
+- [ ] TypeScript types resolve
+- [ ] Documentation accessible
+- [ ] npm registry page displays correctly
+
+## 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 successfully published to npm registry
+- All entry points functional
+- TypeScript definitions accurate
+- Documentation clear and comprehensive
+- Semantic versioning followed
+- Tests passing with adequate coverage
+- No security vulnerabilities
+- Package size optimized
+
+Remember: Great npm packages are well-documented, properly versioned, and easy to integrate.

package/.claude/cfn-config/team-providers.json

@@ -0,0 +1,102 @@
+{
+    "teams": {
+        "marketing": {
+            "coordinator": {
+                "provider": "anthropic",
+                "apiKeyEnvVar": "ANTHROPIC_API_KEY",
+                "model": "claude-sonnet-4-20250514",
+                "baseUrl": "https://api.anthropic.com"
+            },
+            "workers": {
+                "provider": "zai",
+                "apiKeyEnvVar": "ZAI_API_KEY",
+                "baseUrl": "https://api.z.ai/api/anthropic",
+                "models": {
+                    "simple": "claude-3-5-haiku-20241022",
+                    "complex": "claude-3-5-sonnet-20241022"
+                }
+            },
+            "routing_strategy": "dynamic"
+        },
+        "engineering": {
+            "coordinator": {
+                "provider": "anthropic",
+                "apiKeyEnvVar": "ANTHROPIC_API_KEY",
+                "model": "claude-sonnet-4-20250514",
+                "baseUrl": "https://api.anthropic.com"
+            },
+            "workers": {
+                "provider": "zai",
+                "apiKeyEnvVar": "ZAI_API_KEY",
+                "baseUrl": "https://api.z.ai/api/anthropic",
+                "models": {
+                    "simple": "claude-3-5-haiku-20241022",
+                    "complex": "claude-3-5-sonnet-20241022"
+                }
+            },
+            "routing_strategy": "performance"
+        },
+        "sales": {
+            "coordinator": {
+                "provider": "anthropic",
+                "apiKeyEnvVar": "ANTHROPIC_API_KEY",
+                "model": "claude-sonnet-4-20250514",
+                "baseUrl": "https://api.anthropic.com"
+            },
+            "workers": {
+                "provider": "zai",
+                "apiKeyEnvVar": "ZAI_API_KEY",
+                "baseUrl": "https://api.z.ai/api/anthropic",
+                "models": {
+                    "simple": "claude-3-5-haiku-20241022",
+                    "complex": "claude-3-5-sonnet-20241022"
+                }
+            },
+            "routing_strategy": "cost-optimized"
+        },
+        "support": {
+            "coordinator": {
+                "provider": "anthropic",
+                "apiKeyEnvVar": "ANTHROPIC_API_KEY",
+                "model": "claude-sonnet-4-20250514",
+                "baseUrl": "https://api.anthropic.com"
+            },
+            "workers": {
+                "provider": "zai",
+                "apiKeyEnvVar": "ZAI_API_KEY",
+                "baseUrl": "https://api.z.ai/api/anthropic",
+                "models": {
+                    "simple": "claude-3-5-haiku-20241022",
+                    "complex": "claude-3-5-sonnet-20241022"
+                }
+            },
+            "routing_strategy": "reliability"
+        },
+        "finance": {
+            "coordinator": {
+                "provider": "anthropic",
+                "apiKeyEnvVar": "ANTHROPIC_API_KEY",
+                "model": "claude-sonnet-4-20250514",
+                "baseUrl": "https://api.anthropic.com"
+            },
+            "workers": {
+                "provider": "zai",
+                "apiKeyEnvVar": "ZAI_API_KEY",
+                "baseUrl": "https://api.z.ai/api/anthropic",
+                "models": {
+                    "simple": "claude-3-5-haiku-20241022",
+                    "complex": "claude-3-5-sonnet-20241022"
+                }
+            },
+            "routing_strategy": "compliance"
+        }
+    },
+    "global_config": {
+        "max_concurrent_workers": 10,
+        "fallback_provider": "anthropic",
+        "monitoring_enabled": true,
+        "default_complexity": "simple",
+        "retry_on_failure": true,
+        "timeout_seconds": 300
+    }
+}

package/.claude/commands/README.md

@@ -0,0 +1,204 @@
+# CFN Loop Commands - Quick Reference
+
+## Workflows vs Skills vs Playbooks - When to Use What
+
+### Skills (Most Common) - Building Blocks
+**What:** Single-purpose bash scripts in `.claude/skills/`
+**When:** Most tasks - they're the building blocks
+**Example:** `cfn-redis-coordination`, `cfn-agent-spawning`, `cfn-loop-validation`
+
+```bash
+# Direct skill invocation
+./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh enter \
+  --task-id "task-123" \
+  --agent-id "coder-1"
+```
+
+**Use skills when:**
+- Single, focused operation needed
+- Called by agents or coordinators
+- Part of larger workflow
+- Reusable across different tasks
+
+### Playbooks (Not Currently Used) - Pre-Configured Sequences
+**What:** JSON files defining skill sequences for common patterns
+**When:** Repeating the same skill sequence often
+**Status:** Not implemented yet, use skills directly
+
+### Workflows - Complex Automation
+**What:** Event-driven, multi-step automation with conditions/branching
+**When:** Complex sequences with conditional logic
+**Example:** CI/CD pipelines, feature development workflows
+
+```yaml
+name: "feature-development"
+trigger: "branch-created"
+steps:
+  - name: "analyze"
+    agent: "researcher"
+
+  - name: "implement"
+    agent: "backend-dev"
+    depends: ["analyze"]
+    parallel: true  # Multiple agents in parallel
+
+  - name: "test"
+    agent: "tester"
+    depends: ["implement"]
+    condition: "if tests_exist"  # Conditional execution
+```
+
+**Use workflows when:**
+- Event-driven automation (git hooks, CI/CD)
+- Conditional branching logic needed
+- Multi-agent parallel execution
+- Long-running background processes
+- Integration with external systems
+
+## Decision Tree
+
+```
+Need to automate something?
+├─ Single operation?
+│  └─ Use SKILL directly
+├─ Complex logic (conditionals, events, parallel)?
+│  └─ Create WORKFLOW (YAML via /workflow)
+└─ CFN Loop execution?
+   ├─ Planning first? → /write-plan then /cfn-loop-cli
+   ├─ Production? → /cfn-loop-cli
+   ├─ Debugging? → /cfn-loop-task
+   └─ Frontend? → /cfn-loop-frontend
+```
+
+## Examples
+
+### Example 1: Simple Task (Use Skill)
+**Goal:** Enter waiting mode for agent
+
+```bash
+./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh enter \
+  --task-id "task-123" --agent-id "coder-1"
+```
+
+### Example 2: CFN Loop Execution
+**Goal:** Implement JWT authentication
+
+**Option 1: Plan First (Recommended for Complex Tasks)**
+```bash
+# Step 1: Generate plan
+/write-plan "Implement JWT authentication" --mode=standard
+# Reviews: planning/PLAN_jwt_authentication.md
+
+# Step 2: Execute
+/cfn-loop-cli "Implement JWT authentication" --mode=standard
+```
+
+**Option 2: Direct Execution (Simple Tasks)**
+```bash
+# Production execution (cost-optimized)
+/cfn-loop-cli "Implement JWT authentication" --mode=standard
+
+# OR debugging (full visibility)
+/cfn-loop-task "Implement JWT authentication" --mode=standard
+```
+
+### Example 3: Complex Automation (Use Workflow)
+**Goal:** Full feature development (analyze → implement → test → deploy)
+
+```bash
+# Create workflow (via /workflow)
+/workflow create feature-pipeline
+
+# Execute workflow
+/workflow execute feature-pipeline
+```
+
+## Quick Reference Table
+
+| Type | Files | Complexity | Conditional Logic | Parallel Execution | Event-Driven |
+|------|-------|------------|-------------------|-------------------|--------------|
+| **Skill** | `.sh` scripts | Low | No | No | No |
+| **CFN Loop** | Slash commands | Medium | Yes (built-in) | Yes (agents) | No |
+| **Workflow** | `.yaml` definitions | High | Yes | Yes | Yes |
+
+---
+
+## CFN Loop Commands (Current)
+
+### Execution Commands
+- `/cfn-loop-task` - Task mode (debugging, full visibility, Main Chat coordinates)
+- `/cfn-loop-cli` - CLI mode (production, cost-optimized, coordinator spawns CLI agents)
+- `/cfn-loop-frontend` - Visual iteration (screenshot + video validation, supports both modes)
+
+### Planning & Documentation
+- `/write-plan` - Pre-planning phase (generates TDD implementation plan)
+- `/epic-creator-v2` - Create epic configuration with sequential persona reviews (product, architect, security, performance, accessibility, devops)
+- `/cfn-loop-document` - Documentation generation (updates `/readme`)
+
+### Configuration
+- `/cfn-mode` - Toggle CLI vs Task spawning mode
+- `/cfn-optimize-agents` - Agent optimization settings
+- `/cfn-claude-sync` - Sync rules from CLAUDE.md to commands
+
+### Infrastructure
+- `/switch-api` - Switch between Z.ai and Anthropic providers
+
+### Automation
+- `/workflow` - Event-driven workflow automation (complex multi-step)
+
+### Testing & Utilities
+- `/hello-world-tests` - CFN coordination validation tests (4 layers)
+- `/github-commit` - Git commit with CI/CD monitoring
+- `/launch-web-dashboard` - Start web portal (http://localhost:3000)
+- `/list-agents-rebuild` - Regenerate agent list from discovery
+
+### RuVector Integration
+- `/codebase-search` - Semantic search through codebase
+- `/detect-stale-docs` - Find outdated documentation
+- `/codebase-reindex` - Update codebase vector index
+
+---
+
+## When to Use Each Command
+
+### /write-plan (Pre-Planning)
+**Use before complex CFN Loop tasks:**
+- Security-critical features
+- Complex architecture decisions
+- Team collaboration (plan review)
+- Learning CFN Loop workflow
+
+### /cfn-loop-cli (Production)
+**Use for:**
+- Production features
+- Long-running tasks (>10 min)
+- Multi-iteration workflows
+- Cost-sensitive projects
+- **Cost:** $0.054/iteration with Z.ai routing
+
+### /cfn-loop-task (Debugging)
+**Use for:**
+- Debugging CFN Loop issues
+- Learning agent interactions
+- Prototyping configurations
+- Short tasks (<5 min)
+- **Cost:** $0.150/iteration (3x CLI, but full visibility)
+
+### /cfn-loop-frontend (Visual Iteration)
+**Use for:**
+- React/Vue/Angular components
+- UI implementation with mockups
+- Accessibility validation
+- Visual regression testing
+- **Supports:** Both CLI and Task modes
+
+### /workflow (Complex Automation)
+**Use for:**
+- CI/CD pipelines
+- Event-driven automation
+- Multi-step with conditionals
+- External system integration
+
+---
+
+**Version:** 3.0.0 (2025-10-31) - Consolidated command structure with workflows/skills guide