HartmutandClaude Sonnet 4.6
c885c89d06
Removed ~160 files of irrelevant claude-flow framework templates: AGENTS removed: - flow-nexus/ (SaaS platform agents, wrong product) - github/ (GitHub-specific, project uses Gitea) - consensus/ (Raft/CRDT/Byzantine — no use case) - payments/ (Ed25519 payment auth) - specialized/ (React Native / mobile) - sublinear/ (HFT trading, matrix math) - data/ (ML model development) - sona/ (LoRA fine-tuning infrastructure) - browser/ (not needed) - devops/ + development/ (GitHub Actions CI/CD) - nested duplicates (analysis/code-review/, documentation/api-docs/) COMMANDS removed: - github/ (13 files — GitHub CLI, useless with Gitea) - sparc/supabase-admin.md (uses Prisma, not Supabase) SKILLS removed: - github-* (5 dirs — GitHub-specific) - v3-* (9 dirs — claude-flow v3 internal development) HELPERS removed: - github-safe.js, github-setup.sh (GitHub CLI wrappers) - v3*.sh, ddd-tracker.sh, adr-compliance.sh, sync-v3-metrics.sh (V3 metrics) - swarm-*.sh, learning-*.sh, daemon-manager.sh (unused swarm infra) - statusline.js (duplicate of .cjs), guidance-hook*.sh etc. WORKTREES: pruned + deleted .claude/worktrees/ (freed 1.3 GB) Kept: hook-handler.cjs, auto-memory-hook.mjs, statusline.cjs, router.js, session.js, memory.js, intelligence.cjs, settings.json, agents/core/, agents/analysis/, agents/architecture/, agents/testing/, agents/v3/security-*, all user-created commands (plan, implement, review, research, perf, visualaudit, gitlooper). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude Flow V3 Helpers
This directory contains helper scripts and utilities for V3 development.
🚀 Quick Start
# Initialize V3 development environment
.claude/helpers/v3.sh init
# Quick status check
.claude/helpers/v3.sh status
# Update progress metrics
.claude/helpers/v3.sh update domain 3
.claude/helpers/v3.sh update agent 8
.claude/helpers/v3.sh update security 2
Available Helpers
🎛️ V3 Master Tool
v3.sh- Main command-line interface for all V3 operations.claude/helpers/v3.sh help # Show all commands .claude/helpers/v3.sh status # Quick development status .claude/helpers/v3.sh update domain 3 # Update specific metrics .claude/helpers/v3.sh validate # Validate configuration .claude/helpers/v3.sh full-status # Complete status overview
📊 V3 Progress Management
update-v3-progress.sh- Update V3 development metrics# Usage examples: .claude/helpers/update-v3-progress.sh domain 3 # Mark 3 domains complete .claude/helpers/update-v3-progress.sh agent 8 # 8 agents active .claude/helpers/update-v3-progress.sh security 2 # 2 CVEs fixed .claude/helpers/update-v3-progress.sh performance 2.5x # Performance boost .claude/helpers/update-v3-progress.sh status # Show current status
🔍 Configuration Validation
validate-v3-config.sh- Comprehensive environment validation- Checks all required directories and files
- Validates JSON configuration files
- Verifies Node.js and development tools
- Confirms Git repository status
- Validates file permissions
⚡ Quick Status
v3-quick-status.sh- Compact development progress overview- Shows domain, agent, and DDD progress
- Displays security and performance metrics
- Color-coded status indicators
- Current Git branch information
Helper Script Standards
File Naming
- Use kebab-case:
update-v3-progress.sh - Include version prefix:
v3-*for V3-specific helpers - Use descriptive names that indicate purpose
Script Requirements
- Must be executable (
chmod +x) - Include proper error handling (
set -e) - Provide usage help when called without arguments
- Use consistent exit codes (0 = success, non-zero = error)
Configuration Integration
Helpers are configured in .claude/settings.json:
{
"helpers": {
"directory": ".claude/helpers",
"enabled": true,
"v3ProgressUpdater": ".claude/helpers/update-v3-progress.sh"
}
}
Development Guidelines
- Security First: All helpers must validate inputs
- Idempotent: Scripts should be safe to run multiple times
- Fast Execution: Keep helper execution under 1 second when possible
- Clear Output: Provide clear success/error messages
- JSON Safe: When updating JSON files, use
jqfor safety
Adding New Helpers
- Create script in
.claude/helpers/ - Make executable:
chmod +x script-name.sh - Add to settings.json helpers section
- Test thoroughly before committing
- Update this README with usage documentation