claude-flow 3.27.4 → 3.29.0

package/.claude/commands/hooks/post-edit.md

@@ -1,117 +1,117 @@
-# hook post-edit
-
-Execute post-edit processing including formatting, validation, and memory updates.
-
-## Usage
-
-```bash
-npx claude-flow hook post-edit [options]
-```
-
-## Options
-
-- `--file, -f <path>` - File path that was edited
-- `--auto-format` - Automatically format code (default: true)
-- `--memory-key, -m <key>` - Store edit context in memory
-- `--train-patterns` - Train neural patterns from edit
-- `--validate-output` - Validate edited file
-
-## Examples
-
-### Basic post-edit hook
-
-```bash
-npx claude-flow hook post-edit --file "src/components/Button.jsx"
-```
-
-### With memory storage
-
-```bash
-npx claude-flow hook post-edit -f "api/auth.js" --memory-key "auth/login-implementation"
-```
-
-### Format and validate
-
-```bash
-npx claude-flow hook post-edit -f "config/webpack.js" --auto-format --validate-output
-```
-
-### Neural training
-
-```bash
-npx claude-flow hook post-edit -f "utils/helpers.ts" --train-patterns --memory-key "utils/refactor"
-```
-
-## Features
-
-### Auto Formatting
-
-- Language-specific formatters
-- Prettier for JS/TS/JSON
-- Black for Python
-- gofmt for Go
-- Maintains consistency
-
-### Memory Storage
-
-- Saves edit context
-- Records decisions made
-- Tracks implementation details
-- Enables knowledge sharing
-
-### Pattern Training
-
-- Learns from successful edits
-- Improves future suggestions
-- Adapts to coding style
-- Enhances coordination
-
-### Output Validation
-
-- Checks syntax correctness
-- Runs linting rules
-- Validates formatting
-- Ensures quality
-
-## Integration
-
-This hook is automatically called by Claude Code when:
-
-- After Edit tool completes
-- Following MultiEdit operations
-- During file saves
-- After code generation
-
-Manual usage in agents:
-
-```bash
-# After editing files
-npx claude-flow hook post-edit --file "path/to/edited.js" --memory-key "feature/step1"
-```
-
-## Output
-
-Returns JSON with:
-
-```json
-{
-  "file": "src/components/Button.jsx",
-  "formatted": true,
-  "formatterUsed": "prettier",
-  "lintPassed": true,
-  "memorySaved": "component/button-refactor",
-  "patternsTrained": 3,
-  "warnings": [],
-  "stats": {
-    "linesChanged": 45,
-    "charactersAdded": 234
-  }
-}
-```
-
-## See Also
-
-- `hook pre-edit` - Pre-edit preparation
-- `Edit` - File editing tool
-- `memory usage` - Memory management
-- `neural train` - Pattern training
+# hook post-edit
+
+Execute post-edit processing including formatting, validation, and memory updates.
+
+## Usage
+
+```bash
+npx claude-flow hook post-edit [options]
+```
+
+## Options
+
+- `--file, -f <path>` - File path that was edited
+- `--auto-format` - Automatically format code (default: true)
+- `--memory-key, -m <key>` - Store edit context in memory
+- `--train-patterns` - Train neural patterns from edit
+- `--validate-output` - Validate edited file
+
+## Examples
+
+### Basic post-edit hook
+
+```bash
+npx claude-flow hook post-edit --file "src/components/Button.jsx"
+```
+
+### With memory storage
+
+```bash
+npx claude-flow hook post-edit -f "api/auth.js" --memory-key "auth/login-implementation"
+```
+
+### Format and validate
+
+```bash
+npx claude-flow hook post-edit -f "config/webpack.js" --auto-format --validate-output
+```
+
+### Neural training
+
+```bash
+npx claude-flow hook post-edit -f "utils/helpers.ts" --train-patterns --memory-key "utils/refactor"
+```
+
+## Features
+
+### Auto Formatting
+
+- Language-specific formatters
+- Prettier for JS/TS/JSON
+- Black for Python
+- gofmt for Go
+- Maintains consistency
+
+### Memory Storage
+
+- Saves edit context
+- Records decisions made
+- Tracks implementation details
+- Enables knowledge sharing
+
+### Pattern Training
+
+- Learns from successful edits
+- Improves future suggestions
+- Adapts to coding style
+- Enhances coordination
+
+### Output Validation
+
+- Checks syntax correctness
+- Runs linting rules
+- Validates formatting
+- Ensures quality
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+
+- After Edit tool completes
+- Following MultiEdit operations
+- During file saves
+- After code generation
+
+Manual usage in agents:
+
+```bash
+# After editing files
+npx claude-flow hook post-edit --file "path/to/edited.js" --memory-key "feature/step1"
+```
+
+## Output
+
+Returns JSON with:
+
+```json
+{
+  "file": "src/components/Button.jsx",
+  "formatted": true,
+  "formatterUsed": "prettier",
+  "lintPassed": true,
+  "memorySaved": "component/button-refactor",
+  "patternsTrained": 3,
+  "warnings": [],
+  "stats": {
+    "linesChanged": 45,
+    "charactersAdded": 234
+  }
+}
+```
+
+## See Also
+
+- `hook pre-edit` - Pre-edit preparation
+- `Edit` - File editing tool
+- `memory usage` - Memory management
+- `neural train` - Pattern training

package/.claude/commands/hooks/post-task.md

@@ -1,112 +1,112 @@
-# hook post-task
-
-Execute post-task cleanup, performance analysis, and memory storage.
-
-## Usage
-
-```bash
-npx claude-flow hook post-task [options]
-```
-
-## Options
-
-- `--task-id, -t <id>` - Task identifier for tracking
-- `--analyze-performance` - Generate performance metrics (default: true)
-- `--store-decisions` - Save task decisions to memory
-- `--export-learnings` - Export neural pattern learnings
-- `--generate-report` - Create task completion report
-
-## Examples
-
-### Basic post-task hook
-
-```bash
-npx claude-flow hook post-task --task-id "auth-implementation"
-```
-
-### With full analysis
-
-```bash
-npx claude-flow hook post-task -t "api-refactor" --analyze-performance --generate-report
-```
-
-### Memory storage
-
-```bash
-npx claude-flow hook post-task -t "bug-fix-123" --store-decisions --export-learnings
-```
-
-### Quick cleanup
-
-```bash
-npx claude-flow hook post-task -t "minor-update" --analyze-performance false
-```
-
-## Features
-
-### Performance Analysis
-
-- Measures execution time
-- Tracks token usage
-- Identifies bottlenecks
-- Suggests optimizations
-
-### Decision Storage
-
-- Saves key decisions made
-- Records implementation choices
-- Stores error resolutions
-- Maintains knowledge base
-
-### Neural Learning
-
-- Exports successful patterns
-- Updates coordination models
-- Improves future performance
-- Trains on task outcomes
-
-### Report Generation
-
-- Creates completion summary
-- Documents changes made
-- Lists files modified
-- Tracks metrics achieved
-
-## Integration
-
-This hook is automatically called by Claude Code when:
-
-- Completing a task
-- Switching to a new task
-- Ending a work session
-- After major milestones
-
-Manual usage in agents:
-
-```bash
-# In agent coordination
-npx claude-flow hook post-task --task-id "your-task-id" --analyze-performance true
-```
-
-## Output
-
-Returns JSON with:
-
-```json
-{
-  "taskId": "auth-implementation",
-  "duration": 1800000,
-  "tokensUsed": 45000,
-  "filesModified": 12,
-  "performanceScore": 0.92,
-  "learningsExported": true,
-  "reportPath": "/reports/task-auth-implementation.md"
-}
-```
-
-## See Also
-
-- `hook pre-task` - Pre-task setup
-- `performance report` - Detailed metrics
-- `memory usage` - Memory management
-- `neural patterns` - Pattern analysis
+# hook post-task
+
+Execute post-task cleanup, performance analysis, and memory storage.
+
+## Usage
+
+```bash
+npx claude-flow hook post-task [options]
+```
+
+## Options
+
+- `--task-id, -t <id>` - Task identifier for tracking
+- `--analyze-performance` - Generate performance metrics (default: true)
+- `--store-decisions` - Save task decisions to memory
+- `--export-learnings` - Export neural pattern learnings
+- `--generate-report` - Create task completion report
+
+## Examples
+
+### Basic post-task hook
+
+```bash
+npx claude-flow hook post-task --task-id "auth-implementation"
+```
+
+### With full analysis
+
+```bash
+npx claude-flow hook post-task -t "api-refactor" --analyze-performance --generate-report
+```
+
+### Memory storage
+
+```bash
+npx claude-flow hook post-task -t "bug-fix-123" --store-decisions --export-learnings
+```
+
+### Quick cleanup
+
+```bash
+npx claude-flow hook post-task -t "minor-update" --analyze-performance false
+```
+
+## Features
+
+### Performance Analysis
+
+- Measures execution time
+- Tracks token usage
+- Identifies bottlenecks
+- Suggests optimizations
+
+### Decision Storage
+
+- Saves key decisions made
+- Records implementation choices
+- Stores error resolutions
+- Maintains knowledge base
+
+### Neural Learning
+
+- Exports successful patterns
+- Updates coordination models
+- Improves future performance
+- Trains on task outcomes
+
+### Report Generation
+
+- Creates completion summary
+- Documents changes made
+- Lists files modified
+- Tracks metrics achieved
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+
+- Completing a task
+- Switching to a new task
+- Ending a work session
+- After major milestones
+
+Manual usage in agents:
+
+```bash
+# In agent coordination
+npx claude-flow hook post-task --task-id "your-task-id" --analyze-performance true
+```
+
+## Output
+
+Returns JSON with:
+
+```json
+{
+  "taskId": "auth-implementation",
+  "duration": 1800000,
+  "tokensUsed": 45000,
+  "filesModified": 12,
+  "performanceScore": 0.92,
+  "learningsExported": true,
+  "reportPath": "/reports/task-auth-implementation.md"
+}
+```
+
+## See Also
+
+- `hook pre-task` - Pre-task setup
+- `performance report` - Detailed metrics
+- `memory usage` - Memory management
+- `neural patterns` - Pattern analysis

package/.claude/commands/hooks/pre-edit.md

@@ -1,113 +1,113 @@
-# hook pre-edit
-
-Execute pre-edit validations and agent assignment before file modifications.
-
-## Usage
-
-```bash
-npx claude-flow hook pre-edit [options]
-```
-
-## Options
-
-- `--file, -f <path>` - File path to be edited
-- `--auto-assign-agent` - Automatically assign best agent (default: true)
-- `--validate-syntax` - Pre-validate syntax before edit
-- `--check-conflicts` - Check for merge conflicts
-- `--backup-file` - Create backup before editing
-
-## Examples
-
-### Basic pre-edit hook
-
-```bash
-npx claude-flow hook pre-edit --file "src/auth/login.js"
-```
-
-### With validation
-
-```bash
-npx claude-flow hook pre-edit -f "config/database.js" --validate-syntax
-```
-
-### Manual agent assignment
-
-```bash
-npx claude-flow hook pre-edit -f "api/users.ts" --auto-assign-agent false
-```
-
-### Safe editing with backup
-
-```bash
-npx claude-flow hook pre-edit -f "production.env" --backup-file --check-conflicts
-```
-
-## Features
-
-### Auto Agent Assignment
-
-- Analyzes file type and content
-- Assigns specialist agents
-- TypeScript → TypeScript expert
-- Database → Data specialist
-- Tests → QA engineer
-
-### Syntax Validation
-
-- Pre-checks syntax validity
-- Identifies potential errors
-- Suggests corrections
-- Prevents broken code
-
-### Conflict Detection
-
-- Checks for git conflicts
-- Identifies concurrent edits
-- Warns about stale files
-- Suggests merge strategies
-
-### File Backup
-
-- Creates safety backups
-- Enables quick rollback
-- Tracks edit history
-- Preserves originals
-
-## Integration
-
-This hook is automatically called by Claude Code when:
-
-- Using Edit or MultiEdit tools
-- Before file modifications
-- During refactoring operations
-- When updating critical files
-
-Manual usage in agents:
-
-```bash
-# Before editing files
-npx claude-flow hook pre-edit --file "path/to/file.js" --validate-syntax
-```
-
-## Output
-
-Returns JSON with:
-
-```json
-{
-  "continue": true,
-  "file": "src/auth/login.js",
-  "assignedAgent": "auth-specialist",
-  "syntaxValid": true,
-  "conflicts": false,
-  "backupPath": ".backups/login.js.bak",
-  "warnings": []
-}
-```
-
-## See Also
-
-- `hook post-edit` - Post-edit processing
-- `Edit` - File editing tool
-- `MultiEdit` - Multiple edits tool
-- `agent spawn` - Manual agent creation
+# hook pre-edit
+
+Execute pre-edit validations and agent assignment before file modifications.
+
+## Usage
+
+```bash
+npx claude-flow hook pre-edit [options]
+```
+
+## Options
+
+- `--file, -f <path>` - File path to be edited
+- `--auto-assign-agent` - Automatically assign best agent (default: true)
+- `--validate-syntax` - Pre-validate syntax before edit
+- `--check-conflicts` - Check for merge conflicts
+- `--backup-file` - Create backup before editing
+
+## Examples
+
+### Basic pre-edit hook
+
+```bash
+npx claude-flow hook pre-edit --file "src/auth/login.js"
+```
+
+### With validation
+
+```bash
+npx claude-flow hook pre-edit -f "config/database.js" --validate-syntax
+```
+
+### Manual agent assignment
+
+```bash
+npx claude-flow hook pre-edit -f "api/users.ts" --auto-assign-agent false
+```
+
+### Safe editing with backup
+
+```bash
+npx claude-flow hook pre-edit -f "production.env" --backup-file --check-conflicts
+```
+
+## Features
+
+### Auto Agent Assignment
+
+- Analyzes file type and content
+- Assigns specialist agents
+- TypeScript → TypeScript expert
+- Database → Data specialist
+- Tests → QA engineer
+
+### Syntax Validation
+
+- Pre-checks syntax validity
+- Identifies potential errors
+- Suggests corrections
+- Prevents broken code
+
+### Conflict Detection
+
+- Checks for git conflicts
+- Identifies concurrent edits
+- Warns about stale files
+- Suggests merge strategies
+
+### File Backup
+
+- Creates safety backups
+- Enables quick rollback
+- Tracks edit history
+- Preserves originals
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+
+- Using Edit or MultiEdit tools
+- Before file modifications
+- During refactoring operations
+- When updating critical files
+
+Manual usage in agents:
+
+```bash
+# Before editing files
+npx claude-flow hook pre-edit --file "path/to/file.js" --validate-syntax
+```
+
+## Output
+
+Returns JSON with:
+
+```json
+{
+  "continue": true,
+  "file": "src/auth/login.js",
+  "assignedAgent": "auth-specialist",
+  "syntaxValid": true,
+  "conflicts": false,
+  "backupPath": ".backups/login.js.bak",
+  "warnings": []
+}
+```
+
+## See Also
+
+- `hook post-edit` - Post-edit processing
+- `Edit` - File editing tool
+- `MultiEdit` - Multiple edits tool
+- `agent spawn` - Manual agent creation