aiwf 0.3.7 → 0.3.12

package/.aiwf/ai-tools/github-copilot/template/.github/copilot-instructions.md

@@ -1,202 +0,0 @@
-# GitHub Copilot Instructions for AIWF Project
-
-## Project Context
-
-This project uses the AI Workflow Framework (AIWF) for structured AI-assisted development. Copilot should understand and work with AIWF conventions.
-
-## AIWF Structure
-
-```
-.aiwf/
-├── feature-ledger/      # Feature tracking system
-├── personas/            # AI persona definitions
-├── 03_SPRINTS/         # Sprint organization
-└── 99_TEMPLATES/       # Project templates
-```
-
-## Coding Guidelines
-
-### 1. Feature References
-
-Always reference Feature Ledger IDs in:
-- Function documentation
-- Commit messages  
-- TODO comments
-
-Example:
-```javascript
-/**
- * Implements user authentication
- * @feature FL001 - User Authentication System
- */
-function authenticateUser(credentials) {
-  // Implementation
-}
-```
-
-### 2. Sprint Task Integration
-
-When implementing sprint tasks:
-- Reference task ID in comments
-- Update task status after completion
-- Follow task acceptance criteria
-
-Example:
-```javascript
-// Task: T13_S03 - AI Tool Integration
-// Implementing Claude Code template configuration
-```
-
-### 3. AI Persona Patterns
-
-Use persona-specific patterns:
-
-**Architect Persona**:
-- Focus on system design patterns
-- Emphasize scalability and maintainability
-- Document architectural decisions
-
-**Developer Persona**:
-- Implement clean, efficient code
-- Follow SOLID principles
-- Add comprehensive error handling
-
-**Reviewer Persona**:
-- Check for security vulnerabilities
-- Verify performance implications
-- Ensure code quality standards
-
-### 4. Code Generation Rules
-
-1. **Always check Feature Ledger first**
-   - Don't duplicate existing features
-   - Reference related features in comments
-
-2. **Follow AIWF conventions**
-   - Use standardized file naming
-   - Maintain consistent structure
-   - Update relevant documentation
-
-3. **Include AIWF metadata**
-   ```javascript
-   // AIWF Metadata
-   // Feature: FL001
-   // Sprint: S03
-   // Task: T13_S03
-   // Persona: developer
-   ```
-
-### 5. Snippets and Shortcuts
-
-**Feature Ledger Check**:
-```javascript
-// TODO: Check Feature Ledger for existing implementation
-// aiwf ledger search <feature-name>
-```
-
-**Task Status Update**:
-```javascript
-// Task completed: Update status
-// aiwf task complete <task-id>
-```
-
-**Persona Activation**:
-```javascript
-// Switching to architect persona for design
-// aiwf persona use architect
-```
-
-## Best Practices
-
-1. **Feature-First Development**
-   - Always start by checking the Feature Ledger
-   - Create new ledger entries for new features
-   - Update feature status as you progress
-
-2. **Sprint Alignment**
-   - Keep code aligned with current sprint goals
-   - Reference sprint tasks in implementations
-   - Update task logs regularly
-
-3. **Documentation Standards**
-   - Include AIWF references in all documentation
-   - Link to relevant ADRs
-   - Maintain feature traceability
-
-4. **Testing Integration**
-   - Test features according to ledger specifications
-   - Verify persona-specific requirements
-   - Ensure sprint acceptance criteria are met
-
-## Common Patterns
-
-### Feature Implementation Pattern
-```javascript
-// Feature: FL-[ID] - [Name]
-// Sprint: S[XX]
-// Task: T[XX]_S[XX]
-
-import { FeatureLedger } from '@aiwf/core';
-
-export class NewFeature {
-  constructor() {
-    this.featureId = 'FL-[ID]';
-    this.validateAgainstLedger();
-  }
-  
-  validateAgainstLedger() {
-    const ledger = new FeatureLedger();
-    return ledger.validateFeature(this.featureId);
-  }
-}
-```
-
-### Sprint Task Pattern
-```javascript
-// Sprint Task: T[XX]_S[XX]
-// Status: in_progress
-// Started: [timestamp]
-
-async function implementTask() {
-  // Update task status
-  await aiwf.task.updateStatus('T[XX]_S[XX]', 'in_progress');
-  
-  // Implementation
-  
-  // Complete task
-  await aiwf.task.updateStatus('T[XX]_S[XX]', 'completed');
-}
-```
-
-## Integration Commands
-
-Quick reference for AIWF commands to use in comments:
-
-```bash
-# Feature Ledger
-aiwf ledger list
-aiwf ledger show <id>
-aiwf ledger add
-
-# Sprint Management  
-aiwf sprint current
-aiwf sprint tasks
-aiwf task start <id>
-aiwf task complete <id>
-
-# AI Personas
-aiwf persona list
-aiwf persona use <name>
-```
-
-## Copilot Behavior Customization
-
-1. **Prioritize AIWF patterns** in suggestions
-2. **Include feature references** in generated code
-3. **Follow sprint structure** for task implementations
-4. **Apply persona-specific** coding styles
-5. **Maintain traceability** through comments and documentation
-
----
-
-*This instruction set is part of AIWF's GitHub Copilot integration. Version: 1.0.0*

package/.aiwf/ai-tools/windsurf/README.md

@@ -1,355 +0,0 @@
-# Windsurf AIWF Integration Template
-
-## Overview
-
-This template provides deep integration between Windsurf IDE and the AI Workflow Framework (AIWF). It leverages Windsurf's Cascade AI and flow-based development to create a seamless AIWF development experience.
-
-## Features
-
-- **Cascade AI + AIWF**: AI-powered development with AIWF context awareness
-- **Flow-Based Task Management**: Visual task flows aligned with sprint tasks  
-- **Multi-Agent Personas**: Different AI agents for different development contexts
-- **Automatic Context Management**: Smart compression and loading
-- **Visual Progress Tracking**: See AIWF task progress in Windsurf's UI
-- **Integrated Feature Validation**: Real-time Feature Ledger checking
-
-## Installation
-
-```bash
-# Install Windsurf template
-aiwf ai-tool install windsurf
-
-# Or manually copy template files
-cp -r .aiwf/ai-tools/windsurf/template/* .
-```
-
-## Configuration
-
-The template includes:
-
-1. **windsurf.config.json**: Main configuration
-   - AIWF integration settings
-   - Cascade AI configuration
-   - Automation rules
-   - Keyboard shortcuts
-
-2. **.windsurf/aiwf-rules.md**: Integration rules
-   - Code generation patterns
-   - Flow templates
-   - Best practices
-   - Context management
-
-## Usage
-
-### 1. Cascade AI with AIWF Context
-
-Use Cascade with AIWF awareness:
-
-```
-@cascade Show me feature FL-001 implementation status
-
-@cascade Using architect persona, design the payment system
-
-@cascade What tasks are in the current sprint?
-
-@cascade Implement task T13_S03 following acceptance criteria
-```
-
-### 2. Flow-Based Development
-
-Create AIWF-aligned flows:
-
-**Start a Feature Flow**:
-```
-@cascade start-flow --feature FL-001 --task T13_S03
-```
-
-Windsurf creates a flow with:
-- Feature validation
-- Implementation steps
-- Test requirements
-- Documentation updates
-- Task completion
-
-### 3. AI Persona Switching
-
-Different agents for different tasks:
-
-```javascript
-// @persona architect
-// Cascade switches to architecture-focused responses
-
-// @persona developer
-// Cascade provides implementation details
-
-// @persona reviewer  
-// Cascade analyzes code quality
-```
-
-### 4. Visual Task Management
-
-See AIWF tasks in Windsurf UI:
-- Current sprint tasks in sidebar
-- Task progress indicators
-- Feature dependencies graph
-- Real-time status updates
-
-### 5. Smart Context Loading
-
-Automatic context management:
-
-```javascript
-// @load-feature FL-001
-// Loads feature spec into context
-
-// @load-sprint
-// Loads current sprint tasks
-
-// @compress-context
-// Compresses large files automatically
-```
-
-## Windsurf-Specific Features
-
-### 1. Flow Templates
-
-Pre-built AIWF flows:
-
-**Feature Implementation Flow**:
-- Validates against Feature Ledger
-- Creates implementation structure
-- Generates tests
-- Updates documentation
-- Completes task
-
-**Bug Fix Flow**:
-- Identifies related feature
-- Implements fix
-- Adds regression tests
-- Updates feature status
-
-**Architecture Flow**:
-- Uses architect persona
-- Creates ADR
-- Updates system design
-- Validates with ledger
-
-### 2. Multi-Agent Collaboration
-
-Cascade agents by persona:
-
-```json
-{
-  "agents": {
-    "architect": {
-      "model": "cascade-architect",
-      "focus": "design patterns, system architecture"
-    },
-    "developer": {
-      "model": "cascade-large",
-      "focus": "implementation, optimization"
-    },
-    "reviewer": {
-      "model": "cascade-reviewer",
-      "focus": "code quality, security"
-    }
-  }
-}
-```
-
-### 3. Keyboard Shortcuts
-
-Quick AIWF actions:
-
-- `Cmd+Shift+F`: Check Feature Ledger
-- `Cmd+Shift+T`: Update task status
-- `Cmd+Shift+P`: Switch persona
-- `Cmd+Shift+C`: Compress context
-- `Cmd+Shift+S`: Show sprint tasks
-
-### 4. Automation Features
-
-Automatic workflows:
-
-- **Task Status**: Updates based on file changes
-- **Documentation**: Syncs docs with code
-- **Feature Validation**: Checks on save
-- **Context Compression**: For large files
-- **Test Running**: On task completion
-
-## Best Practices
-
-### 1. Flow-First Development
-
-Start with flows:
-
-```
-@cascade create-flow --type feature --id FL-001
-```
-
-### 2. Context Efficiency
-
-Manage context smartly:
-
-```javascript
-// Good - Reference by ID
-// @feature FL-001
-
-// Avoid - Full feature description
-// @feature "Complete user authentication system with OAuth..."
-```
-
-### 3. Progressive Enhancement
-
-Build incrementally:
-
-1. Start with feature validation
-2. Implement core functionality
-3. Add tests progressively
-4. Update documentation
-5. Complete task
-
-### 4. Visual Feedback
-
-Use Windsurf's UI:
-- Check flow progress visually
-- Monitor task status in sidebar
-- View feature dependencies
-- Track sprint progress
-
-## Advanced Configuration
-
-### 1. Custom Flow Templates
-
-Create `.windsurf/flows/`:
-
-```json
-{
-  "name": "api-endpoint",
-  "steps": [
-    "validate-feature",
-    "create-route",
-    "implement-controller",
-    "add-validation",
-    "write-tests",
-    "update-docs"
-  ]
-}
-```
-
-### 2. Cascade Fine-Tuning
-
-Configure AI behavior:
-
-```json
-{
-  "cascade": {
-    "temperature": {
-      "architect": 0.7,
-      "developer": 0.3,
-      "reviewer": 0.1
-    },
-    "max_tokens": {
-      "design": 2000,
-      "implementation": 5000,
-      "review": 1000
-    }
-  }
-}
-```
-
-### 3. Integration Hooks
-
-Add to `windsurf.config.json`:
-
-```json
-{
-  "hooks": {
-    "pre-commit": "aiwf task validate",
-    "post-save": "aiwf ledger sync",
-    "flow-complete": "aiwf task complete"
-  }
-}
-```
-
-## Troubleshooting
-
-### Common Issues
-
-1. **Cascade not recognizing AIWF**
-   - Check windsurf.config.json
-   - Verify AIWF rules loaded
-   - Restart Windsurf
-
-2. **Flow not updating tasks**
-   - Ensure task ID is correct
-   - Check automation settings
-   - Verify permissions
-
-3. **Context overflow**
-   - Enable auto-compression
-   - Clear old context
-   - Use feature references
-
-### Debug Mode
-
-Enable debugging:
-
-```json
-{
-  "debug": {
-    "aiwf": true,
-    "cascade": true,
-    "flows": true
-  }
-}
-```
-
-## Performance Tips
-
-### 1. Context Optimization
-
-- Compress files > 1000 lines
-- Use feature IDs not descriptions  
-- Clear context between tasks
-- Cache frequently used features
-
-### 2. Flow Efficiency
-
-- Create reusable flow templates
-- Use checkpoints for long flows
-- Parallelize independent steps
-- Cache flow results
-
-### 3. Cascade Optimization
-
-- Use appropriate model sizes
-- Batch similar requests
-- Cache common queries
-- Minimize context switches
-
-## Updates
-
-Stay current:
-
-```bash
-# Check for updates
-aiwf ai-tool check windsurf
-
-# Update template
-aiwf ai-tool update windsurf
-
-# Verify integration
-aiwf ai-tool verify windsurf
-```
-
-## Resources
-
-- [Windsurf Documentation](https://windsurf.ai/docs)
-- [AIWF Documentation](https://aiwf.dev/docs)
-- [Cascade AI Guide](https://windsurf.ai/cascade)
-- [Community Forum](https://forum.aiwf.dev/windsurf)
-
----
-
-*Windsurf Integration Template v1.0.0*

package/.aiwf/ai-tools/windsurf/config.json

@@ -1,29 +0,0 @@
-{
-  "name": "windsurf",
-  "version": "1.0.0",
-  "description": "Windsurf IDE integration template for AIWF",
-  "compatible_aiwf_version": ">=0.1.0",
-  "features": {
-    "feature_ledger": true,
-    "ai_persona": true,
-    "context_compression": true,
-    "offline_cache": true,
-    "cascade_flow": true
-  },
-  "setup_commands": [],
-  "files_to_copy": [
-    {
-      "source": "template/.windsurf",
-      "destination": ".windsurf"
-    },
-    {
-      "source": "template/windsurf.config.json",
-      "destination": "windsurf.config.json"
-    }
-  ],
-  "settings": {
-    "aiwf_cascade_integration": true,
-    "feature_flow_tracking": true,
-    "ai_persona_switching": true
-  }
-}