aiwf 0.3.18 → 0.3.19

package/ai-tools/augment/template/.augment/augment.yaml

@@ -0,0 +1,347 @@
+# Augment AI Configuration for AIWF Projects
+# Version: 1.0.0
+
+# Project identification
+project:
+  type: aiwf
+  framework_version: 1.0.0
+  name: "${PROJECT_NAME}"
+  description: "AI Workflow Framework project with Augment integration"
+
+# AIWF structure mapping
+structure:
+  root: .aiwf
+  directories:
+    features: 06_FEATURE_LEDGERS
+    sprints: 03_SPRINTS
+    tasks: 04_GENERAL_TASKS
+    personas: personas
+    templates: 99_TEMPLATES
+    architecture: 05_ARCHITECTURAL_DECISIONS
+    state: 10_STATE_OF_PROJECT
+
+# Context providers
+context:
+  providers:
+    - name: feature_ledger
+      type: markdown
+      path: .aiwf/06_FEATURE_LEDGERS/**/*.md
+      parser: aiwf_feature
+      cache: true
+      refresh: on_save
+      
+    - name: current_sprint
+      type: directory
+      path: .aiwf/03_SPRINTS
+      parser: aiwf_sprint
+      watch: true
+      
+    - name: active_persona
+      type: json
+      path: .aiwf/current_persona.json
+      watch: true
+      
+    - name: project_manifest
+      type: markdown
+      path: .aiwf/00_PROJECT_MANIFEST.md
+      parser: aiwf_manifest
+      cache: true
+
+# Code generation patterns
+patterns:
+  # File naming
+  naming:
+    services: "{feature_id}_{name}.service.{ext}"
+    controllers: "{feature_id}_{name}.controller.{ext}"
+    tests: "{name}.spec.{ext}"
+    components: "{name}.component.{ext}"
+    
+  # Import organization
+  imports:
+    order:
+      - external
+      - "@aiwf/core"
+      - "@aiwf/*"
+      - internal
+      - feature
+      - relative
+    grouping: true
+    sorting: alphabetical
+    
+  # Documentation
+  documentation:
+    style: jsdoc
+    required_tags:
+      - "@feature"
+      - "@task"
+      - "@persona"
+    auto_generate:
+      feature_id: true
+      task_id: true
+      sprint_id: true
+      timestamp: false
+
+# Persona configurations
+personas:
+  architect:
+    focus:
+      - system_design
+      - architectural_patterns
+      - scalability
+      - abstractions
+    patterns:
+      - interfaces
+      - abstract_classes
+      - design_patterns
+      - dependency_injection
+    suggestions:
+      priority: architecture_first
+      examples: true
+      alternatives: multiple
+      
+  security:
+    focus:
+      - input_validation
+      - authentication
+      - authorization
+      - encryption
+    patterns:
+      - sanitization
+      - rate_limiting
+      - audit_logging
+      - security_headers
+    warnings:
+      level: high
+      types:
+        - sql_injection
+        - xss
+        - csrf
+        - exposed_secrets
+        
+  frontend:
+    focus:
+      - user_experience
+      - component_design
+      - performance
+      - accessibility
+    patterns:
+      - react_hooks
+      - state_management
+      - responsive_design
+      - lazy_loading
+    frameworks:
+      react: true
+      vue: true
+      angular: true
+      
+  backend:
+    focus:
+      - api_design
+      - data_models
+      - business_logic
+      - integrations
+    patterns:
+      - rest_api
+      - graphql
+      - microservices
+      - event_driven
+    databases:
+      sql: true
+      nosql: true
+      cache: true
+      
+  data_analyst:
+    focus:
+      - data_processing
+      - visualization
+      - statistics
+      - reporting
+    patterns:
+      - pandas_operations
+      - numpy_calculations
+      - chart_generation
+      - data_pipelines
+    libraries:
+      pandas: true
+      numpy: true
+      matplotlib: true
+      seaborn: true
+
+# Code suggestions behavior
+suggestions:
+  # Context awareness
+  context_depth: 3
+  include_related_features: true
+  check_dependencies: true
+  
+  # Validation
+  validation:
+    feature_status: always
+    task_alignment: always
+    sprint_scope: warning
+    persona_match: info
+    
+  # Auto-completion
+  autocomplete:
+    trigger_chars: 3
+    show_metadata: true
+    include_examples: true
+    max_suggestions: 10
+    
+  # Intelligence features
+  intelligence:
+    learn_from_codebase: true
+    adapt_to_style: true
+    suggest_refactoring: true
+    detect_patterns: true
+
+# Integration rules
+rules:
+  # Feature validation
+  - id: feature_validation
+    name: "Require feature validation"
+    severity: error
+    applies_to: ["services", "controllers"]
+    pattern: "class.*"
+    requires: "validateFeature|checkFeature"
+    message: "All services must validate their feature status"
+    
+  # Task references
+  - id: task_reference
+    name: "Task reference required"
+    severity: warning
+    applies_to: ["all"]
+    pattern: "export (class|function|const)"
+    requires: "@task"
+    message: "Exported items should reference their task ID"
+    
+  # Security checks
+  - id: input_sanitization
+    name: "Input sanitization"
+    severity: error
+    applies_to: ["controllers", "api"]
+    pattern: "req\\.(body|params|query)"
+    requires: "sanitize|validate"
+    message: "User input must be sanitized"
+    
+  # Test coverage
+  - id: test_required
+    name: "Test file required"
+    severity: warning
+    applies_to: ["services", "controllers", "utils"]
+    requires_file: "{name}.spec.{ext}"
+    message: "Test file is missing"
+
+# Error handling
+error_handling:
+  style: contextual
+  include_metadata: true
+  patterns:
+    feature_error: |
+      class {Name}Error extends Error {
+        constructor(message, context) {
+          super(`[{feature_id}/{task_id}] ${message}`);
+          this.feature = '{feature_id}';
+          this.task = '{task_id}';
+          this.timestamp = new Date().toISOString();
+        }
+      }
+    
+# Git integration
+git:
+  hooks:
+    pre_commit:
+      - validate_features
+      - check_task_references
+      - run_linter
+    post_commit:
+      - update_feature_progress
+      - log_to_sprint
+      
+  commit_format: "{type}({feature_id}): {message}"
+  branch_format: "feature/{feature_id}-{name}"
+  
+# Performance optimization
+performance:
+  analyze: true
+  suggest_optimizations: true
+  track_metrics: true
+  thresholds:
+    response_time: 100ms
+    bundle_size: 500kb
+    memory_usage: 100mb
+    
+# Testing integration
+testing:
+  framework: jest
+  coverage:
+    threshold: 80
+    include_feature_tests: true
+    require_acceptance_tests: true
+  patterns:
+    unit: "*.spec.{js,ts}"
+    integration: "*.integration.{js,ts}"
+    e2e: "*.e2e.{js,ts}"
+    
+# Documentation generation
+documentation:
+  auto_generate: true
+  update_on_save: true
+  targets:
+    - feature_ledger
+    - api_docs
+    - readme
+    - changelog
+  format:
+    style: markdown
+    include_examples: true
+    include_diagrams: true
+    
+# Custom commands
+commands:
+  - name: "Create Feature"
+    command: "aiwf:create-feature"
+    shortcut: "cmd+shift+f"
+    description: "Create a new feature in Feature Ledger"
+    
+  - name: "Update Task"
+    command: "aiwf:update-task"
+    shortcut: "cmd+shift+t"
+    description: "Update current task status"
+    
+  - name: "Switch Persona"
+    command: "aiwf:switch-persona"
+    shortcut: "cmd+shift+p"
+    description: "Switch active AI persona"
+    
+  - name: "Sprint Status"
+    command: "aiwf:sprint-status"
+    shortcut: "cmd+shift+s"
+    description: "Show current sprint status"
+
+# Cache configuration
+cache:
+  enabled: true
+  location: .augment/cache
+  max_size: 100mb
+  ttl: 24h
+  clear_on:
+    - major_version_change
+    - structure_change
+    - manual_clear
+    
+# Telemetry
+telemetry:
+  enabled: false
+  anonymous: true
+  track:
+    - feature_usage
+    - persona_switches
+    - performance_metrics
+    
+# Experimental features
+experimental:
+  ai_refactoring: false
+  auto_test_generation: false
+  smart_documentation: false
+  predictive_coding: false

package/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/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/moonklabs/aiwf/issues)
+- Community: [Discord Server](https://discord.gg/aiwf)
+
+---
+
+*Claude Code Integration Template v1.0.0*

package/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/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*