aiwf 0.3.8 → 0.3.12

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

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

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

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

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

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

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