aiwf 0.3.1 → 0.3.3

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

@@ -0,0 +1,202 @@
+# 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

@@ -0,0 +1,355 @@
+# 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

@@ -0,0 +1,29 @@
+{
+  "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
+  }
+}