aiwf 0.3.1 → 0.3.2

package/.aiwf/ai-tools/augment/template/augment.config.json

@@ -0,0 +1,64 @@
+{
+  "augment": {
+    "version": "1.0.0",
+    "aiwf_integration": {
+      "enabled": true,
+      "sync_mode": "realtime",
+      "features": {
+        "feature_ledger": {
+          "path": ".aiwf/feature-ledger/",
+          "auto_index": true,
+          "deep_understanding": true
+        },
+        "personas": {
+          "path": ".aiwf/personas/",
+          "team_shared": true,
+          "context_switching": true
+        },
+        "sprints": {
+          "path": ".aiwf/03_SPRINTS/",
+          "team_visibility": true,
+          "progress_tracking": true
+        }
+      }
+    },
+    "codebase_understanding": {
+      "aiwf_aware": true,
+      "feature_mapping": true,
+      "dependency_tracking": true,
+      "architecture_comprehension": true
+    },
+    "team_features": {
+      "shared_context": true,
+      "feature_ownership": true,
+      "task_assignment": true,
+      "code_review_integration": true
+    },
+    "ai_configuration": {
+      "models": {
+        "code_completion": "augment-fast",
+        "code_understanding": "augment-deep",
+        "documentation": "augment-doc",
+        "review": "augment-review"
+      },
+      "context_window": {
+        "size": 150000,
+        "compression": true,
+        "feature_prioritization": true
+      }
+    },
+    "automation": {
+      "feature_discovery": true,
+      "task_suggestions": true,
+      "documentation_generation": true,
+      "test_generation": true,
+      "refactoring_suggestions": true
+    },
+    "integrations": {
+      "ide": ["vscode", "intellij", "vim"],
+      "vcs": ["git", "github", "gitlab"],
+      "ci_cd": ["github-actions", "jenkins", "circleci"],
+      "communication": ["slack", "teams", "discord"]
+    }
+  }
+}

package/.aiwf/ai-tools/claude-code/README.md

@@ -0,0 +1,151 @@
+# Claude Code AIWF Integration Template
+
+## Overview
+
+This template provides seamless integration between Claude Code and the AI Workflow Framework (AIWF). It enhances Claude Code's capabilities with AIWF's structured development features.
+
+## Features
+
+- **Feature Ledger Integration**: Automatic synchronization with AIWF's feature tracking system
+- **AI Persona Support**: Access to specialized AI personas for different development contexts
+- **Sprint Management**: Integration with AIWF's sprint and task management
+- **Context Compression**: Efficient handling of large codebases
+- **Offline Cache**: Local caching for improved performance
+
+## Installation
+
+```bash
+# Install Claude Code template
+aiwf ai-tool install claude-code
+
+# Or manually copy template files
+cp -r .aiwf/ai-tools/claude-code/template/* .
+```
+
+## Configuration
+
+The template includes:
+
+1. **CLAUDE.md**: Main configuration file for Claude Code
+   - AIWF feature documentation
+   - Command quick reference
+   - Best practices guide
+
+2. **.claude/**: Directory for Claude-specific settings
+   - Context rules
+   - Custom instructions
+   - Project metadata
+
+## Usage
+
+### 1. Feature Ledger Integration
+
+Claude Code automatically recognizes Feature Ledger entries:
+
+```bash
+# View features directly in Claude Code
+@features list
+@features show <feature-id>
+```
+
+### 2. AI Personas
+
+Activate specialized personas within Claude Code:
+
+```
+@persona architect
+Design a microservices architecture for the payment system.
+
+@persona reviewer  
+Review the authentication module for security issues.
+```
+
+### 3. Sprint Tasks
+
+Work with sprint tasks seamlessly:
+
+```
+@task start T13_S03
+@task status
+@task complete T13_S03
+```
+
+### 4. Context Management
+
+Handle large files efficiently:
+
+```
+@compress src/large-module.js
+@expand compressed/large-module.js
+```
+
+## Best Practices
+
+1. **Start with Feature Ledger**: Always check existing features before implementing new ones
+2. **Use Appropriate Personas**: Select the right AI persona for each task type
+3. **Follow Sprint Structure**: Update task status as you progress
+4. **Manage Context Wisely**: Use compression for large files to stay within limits
+5. **Document Decisions**: Reference ADRs in your implementation
+
+## Customization
+
+### Adding Project-Specific Rules
+
+Edit `CLAUDE.md` to add your project-specific guidelines:
+
+```markdown
+### Project-Specific Guidelines
+
+- Use TypeScript for all new modules
+- Follow Clean Architecture principles
+- Implement comprehensive error handling
+```
+
+### Configuring AI Personas
+
+Customize persona behavior in `.claude/personas.json`:
+
+```json
+{
+  "custom_personas": {
+    "backend_specialist": {
+      "focus": "Node.js, API design, database optimization",
+      "style": "pragmatic, performance-focused"
+    }
+  }
+}
+```
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Feature Ledger not syncing**
+   - Run `aiwf ledger sync`
+   - Check `.aiwf/feature-ledger/` permissions
+
+2. **Personas not responding**
+   - Verify persona files in `.aiwf/personas/`
+   - Run `aiwf persona validate`
+
+3. **Context overflow**
+   - Use `aiwf context stats` to check usage
+   - Compress large files with `aiwf context compress`
+
+## Updates
+
+Keep your template updated:
+
+```bash
+aiwf ai-tool update claude-code
+```
+
+## Support
+
+- Documentation: [AIWF Docs](https://aiwf.dev/docs)
+- Issues: [GitHub Issues](https://github.com/aiwf/aiwf/issues)
+- Community: [Discord Server](https://discord.gg/aiwf)
+
+---
+
+*Claude Code Integration Template v1.0.0*

package/.aiwf/ai-tools/claude-code/config.json

@@ -0,0 +1,28 @@
+{
+  "name": "claude-code",
+  "version": "1.0.0",
+  "description": "Claude Code integration template for AIWF",
+  "compatible_aiwf_version": ">=0.1.0",
+  "features": {
+    "feature_ledger": true,
+    "ai_persona": true,
+    "context_compression": true,
+    "offline_cache": true
+  },
+  "setup_commands": [],
+  "files_to_copy": [
+    {
+      "source": "template/.claude",
+      "destination": ".claude"
+    },
+    {
+      "source": "template/CLAUDE.md",
+      "destination": "CLAUDE.md"
+    }
+  ],
+  "settings": {
+    "auto_context_update": true,
+    "feature_ledger_integration": "automatic",
+    "persona_activation": "on_demand"
+  }
+}

package/.aiwf/ai-tools/claude-code/template/CLAUDE.md

@@ -0,0 +1,91 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## AIWF Integration
+
+This project uses the AI Workflow Framework (AIWF) for AI-assisted development. Claude Code is configured to work seamlessly with AIWF features.
+
+### Available AIWF Features
+
+1. **Feature Ledger**: Track and reference all features through `.aiwf/feature-ledger/`
+2. **AI Personas**: Access specialized AI personas for different contexts in `.aiwf/personas/`
+3. **Sprint Management**: Follow structured sprints in `.aiwf/03_SPRINTS/`
+4. **Templates**: Use standardized templates from `.aiwf/99_TEMPLATES/`
+
+### Working with Feature Ledger
+
+When implementing new features:
+1. Check existing features in the ledger first
+2. Reference feature IDs in commit messages
+3. Update feature status as you work
+4. Use `aiwf ledger show <feature-id>` to view details
+
+### AI Persona Usage
+
+Available personas can be activated with:
+- `@persona analyst` - For system analysis tasks
+- `@persona architect` - For architecture decisions
+- `@persona developer` - For implementation tasks
+- `@persona reviewer` - For code reviews
+- `@persona tester` - For testing scenarios
+
+### Context Compression
+
+To manage context limits effectively:
+- Use `aiwf context compress` to optimize large files
+- Reference compressed files with `@compressed/<filename>`
+- Claude Code will automatically expand when needed
+
+### Sprint Task Workflow
+
+1. View current sprint: `aiwf sprint current`
+2. List tasks: `aiwf sprint tasks`
+3. Start a task: `aiwf task start <task-id>`
+4. Complete a task: `aiwf task complete <task-id>`
+
+### Best Practices
+
+1. **Always check Feature Ledger before implementing new features**
+2. **Use appropriate AI personas for specialized tasks**
+3. **Keep context focused using compression when needed**
+4. **Follow sprint structure and update task status**
+5. **Reference ADRs for architectural decisions**
+
+### AIWF Commands Quick Reference
+
+```bash
+# Feature Ledger
+aiwf ledger list              # List all features
+aiwf ledger show <id>         # Show feature details
+aiwf ledger add               # Add new feature
+
+# Sprint Management
+aiwf sprint current           # Show current sprint
+aiwf sprint tasks            # List sprint tasks
+aiwf task start <id>         # Start a task
+aiwf task complete <id>      # Complete a task
+
+# AI Personas
+aiwf persona list            # List available personas
+aiwf persona use <name>      # Activate a persona
+
+# Context Management
+aiwf context compress <file> # Compress large file
+aiwf context stats          # Show context usage
+```
+
+### Project-Specific Guidelines
+
+<!-- Project-specific guidelines will be added here by the development team -->
+
+### Integration Notes
+
+- Feature Ledger is automatically synchronized
+- AI Personas enhance Claude Code's contextual understanding
+- Sprint tasks provide structured development workflow
+- Context compression helps manage large codebases efficiently
+
+---
+
+*This template is part of AIWF's Claude Code integration. Version: 1.0.0*

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

@@ -0,0 +1,314 @@
+# Cursor AIWF Integration Template
+
+## Overview
+
+This template optimizes Cursor IDE for AIWF projects, providing deep integration with Feature Ledger, AI Personas, and Sprint Management systems. It enhances Cursor's AI capabilities with AIWF's structured development approach.
+
+## Features
+
+- **Multi-File Context Awareness**: Cursor understands AIWF's interconnected structure
+- **Feature Ledger Integration**: Automatic feature tracking and referencing
+- **AI Persona Optimization**: Context-aware code suggestions based on active persona
+- **Sprint Task Tracking**: Real-time task status integration
+- **Context Compression**: Efficient handling of large codebases
+- **Composer Enhancement**: AIWF-aware prompts and completions
+
+## Installation
+
+```bash
+# Install Cursor template
+aiwf ai-tool install cursor
+
+# Or manually copy template files
+cp -r .aiwf/ai-tools/cursor/template/.cursorrules .
+cp -r .aiwf/ai-tools/cursor/template/.cursor .
+```
+
+## Configuration
+
+The template includes:
+
+1. **.cursorrules**: Main configuration file
+   - AIWF integration rules
+   - Code generation patterns
+   - Best practices
+   - Project-specific guidelines
+
+2. **.cursor/**: Directory for Cursor-specific settings
+   - Context providers
+   - Custom completions
+   - AIWF shortcuts
+
+## Usage
+
+### 1. Feature-Aware Development
+
+Cursor automatically:
+- Checks Feature Ledger before suggesting implementations
+- Includes feature IDs in generated code
+- Maintains feature traceability
+
+```javascript
+// Start typing a function
+// Cursor suggests:
+/**
+ * Feature: FL-001 - User Authentication
+ * Task: T13_S03
+ */
+function authenticateUser(credentials) {
+  // Feature-aware implementation
+}
+```
+
+### 2. Composer Integration
+
+Use AIWF context in Composer:
+
+```
+Composer> Implement the user profile feature following FL-002 specifications
+
+Composer> Using architect persona, design the payment system architecture
+
+Composer> Compress and analyze the authentication module for optimization
+```
+
+### 3. Multi-File Operations
+
+Leverage Cursor's multi-file edit:
+
+1. **Feature Implementation**
+   - Opens feature file, implementation, tests together
+   - Maintains consistency across files
+   - Updates documentation automatically
+
+2. **Sprint Task Completion**
+   - Updates task status
+   - Modifies related files
+   - Commits with proper references
+
+### 4. Context Management
+
+Efficient context usage:
+
+```javascript
+// Large file handling
+// @compress src/large-module.js
+// Cursor automatically uses compressed version
+
+// Feature reference
+// @feature FL-001
+// Cursor loads feature specification
+```
+
+### 5. AI Persona Integration
+
+Switch personas for different contexts:
+
+```javascript
+// @persona architect
+// Cursor provides architectural patterns and design suggestions
+
+// @persona developer
+// Cursor focuses on implementation details and optimization
+
+// @persona reviewer
+// Cursor highlights potential issues and suggests improvements
+```
+
+## Best Practices
+
+### 1. Start with Context
+
+Always provide AIWF context:
+
+```javascript
+/**
+ * Working on: Sprint S03
+ * Task: T13_S03 - AI Tool Integration
+ * Feature: FL-010 - Tool Templates
+ */
+```
+
+### 2. Use Feature References
+
+Reference features in all code:
+
+```javascript
+// Good
+import { UserAuth } from './features/FL001-auth'; // Feature: FL-001
+
+// Avoid
+import { UserAuth } from './auth'; // No feature reference
+```
+
+### 3. Maintain Task Flow
+
+Follow task lifecycle:
+
+```bash
+# Start work
+aiwf task start T13_S03
+
+# During development (in Cursor)
+// Task: T13_S03 - Status: in_progress
+
+# Complete work
+aiwf task complete T13_S03
+```
+
+### 4. Leverage Compression
+
+For large files:
+
+```bash
+# Compress before including in context
+aiwf context compress src/large-component.js
+
+# Reference in Cursor
+// @compressed large-component.js
+```
+
+## Advanced Features
+
+### 1. Custom Context Providers
+
+Create `.cursor/providers.json`:
+
+```json
+{
+  "providers": [
+    {
+      "name": "feature-ledger",
+      "path": ".aiwf/feature-ledger/",
+      "pattern": "FL-*.json"
+    },
+    {
+      "name": "current-sprint",
+      "path": ".aiwf/03_SPRINTS/current/",
+      "pattern": "*.md"
+    }
+  ]
+}
+```
+
+### 2. AIWF Snippets
+
+Define in `.cursor/snippets.json`:
+
+```json
+{
+  "aiwf-feature": {
+    "prefix": "aiwf-feat",
+    "body": [
+      "/**",
+      " * Feature: FL-${1:XXX} - ${2:Feature Name}",
+      " * Sprint: S${3:XX}",
+      " * Task: T${4:XX}_S${3:XX}",
+      " */"
+    ]
+  }
+}
+```
+
+### 3. Workspace Settings
+
+Configure `.cursor/settings.json`:
+
+```json
+{
+  "aiwf": {
+    "autoCheckFeatureLedger": true,
+    "showTaskStatus": true,
+    "enablePersonaHints": true,
+    "contextCompression": {
+      "threshold": 1000,
+      "automatic": true
+    }
+  }
+}
+```
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Cursor not recognizing AIWF patterns**
+   - Ensure .cursorrules is in project root
+   - Restart Cursor to reload rules
+   - Check file permissions
+
+2. **Feature references missing**
+   - Run `aiwf ledger sync`
+   - Verify Feature Ledger structure
+   - Update .cursorrules if needed
+
+3. **Context overflow**
+   - Use compression for large files
+   - Reference features by ID
+   - Clear unnecessary context
+
+### Debug Mode
+
+Enable AIWF debug in Cursor:
+
+```json
+{
+  "aiwf.debug": true,
+  "aiwf.logLevel": "verbose"
+}
+```
+
+## Integration Tips
+
+### 1. Composer Workflows
+
+Effective Composer prompts:
+
+```
+"Implement FL-001 authentication with test coverage"
+"Using reviewer persona, analyze the payment module"
+"Update all files related to task T13_S03"
+```
+
+### 2. Multi-File Patterns
+
+Common multi-file operations:
+
+- Feature + Tests + Docs
+- API Route + Controller + Service + Tests
+- Component + Styles + Tests + Story
+
+### 3. Context Optimization
+
+Manage context efficiently:
+
+- Use feature IDs instead of full descriptions
+- Compress files over 1000 lines
+- Reference ADRs by number
+- Include only active sprint tasks
+
+## Updates
+
+Keep template synchronized:
+
+```bash
+# Check for updates
+aiwf ai-tool check cursor
+
+# Update template
+aiwf ai-tool update cursor
+
+# Verify installation
+aiwf ai-tool verify cursor
+```
+
+## Resources
+
+- [Cursor Documentation](https://cursor.sh/docs)
+- [AIWF Documentation](https://aiwf.dev/docs)
+- [Integration Guide](https://aiwf.dev/guides/cursor)
+- [Community Forum](https://forum.aiwf.dev/cursor)
+
+---
+
+*Cursor Integration Template v1.0.0*

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

@@ -0,0 +1,29 @@
+{
+  "name": "cursor",
+  "version": "1.0.0",
+  "description": "Cursor IDE integration template for AIWF",
+  "compatible_aiwf_version": ">=0.1.0",
+  "features": {
+    "feature_ledger": true,
+    "ai_persona": true,
+    "context_compression": true,
+    "offline_cache": true,
+    "multi_file_edit": true
+  },
+  "setup_commands": [],
+  "files_to_copy": [
+    {
+      "source": "template/.cursorrules",
+      "destination": ".cursorrules"
+    },
+    {
+      "source": "template/.cursor",
+      "destination": ".cursor"
+    }
+  ],
+  "settings": {
+    "aiwf_context_provider": true,
+    "feature_aware_completions": true,
+    "sprint_task_tracking": true
+  }
+}