aiwf 0.3.0 → 0.3.2

package/.aiwf/ai-tools/augment/template/.augment/aiwf-integration.md

@@ -0,0 +1,387 @@
+# Augment AIWF Integration Guide
+
+## Overview
+
+This guide configures Augment Code to deeply understand and work with AIWF projects. Augment's codebase comprehension and team collaboration features are enhanced with AIWF's structured approach.
+
+## Core Integration Concepts
+
+### 1. Deep Codebase Understanding
+
+Augment learns your AIWF structure:
+- **Feature Ledger**: Understands all features and their relationships
+- **Sprint Tasks**: Knows current work and priorities
+- **AI Personas**: Applies appropriate context based on personas
+- **Architecture**: Comprehends system design through ADRs
+
+### 2. Team Collaboration
+
+AIWF + Augment enables:
+- Shared understanding of features across team
+- Task assignment based on expertise
+- Consistent code patterns
+- Automated knowledge sharing
+
+### 3. Intelligent Assistance
+
+Augment provides AIWF-aware help:
+- Suggests relevant features for new code
+- Warns about feature conflicts
+- Recommends appropriate personas
+- Tracks sprint progress
+
+## Configuration
+
+### Feature Ledger Integration
+
+Augment automatically indexes:
+```
+.aiwf/feature-ledger/
+├── FL-001-authentication.json
+├── FL-002-user-profiles.json
+└── feature-map.json
+```
+
+Understanding includes:
+- Feature specifications
+- Dependencies
+- Implementation status
+- Related code locations
+
+### Sprint Awareness
+
+Current sprint context:
+```
+.aiwf/03_SPRINTS/S03_M02_ecosystem_integration/
+├── sprint_metadata.json
+├── T13_S03_AI_도구_통합.md
+└── sprint_goals.md
+```
+
+Augment knows:
+- Active tasks
+- Task assignments
+- Progress status
+- Acceptance criteria
+
+### AI Persona Application
+
+Available personas:
+```
+.aiwf/personas/
+├── analyst.json
+├── architect.json
+├── developer.json
+├── reviewer.json
+└── tester.json
+```
+
+Augment applies persona-specific:
+- Code suggestions
+- Review criteria
+- Documentation style
+- Testing approaches
+
+## Usage Patterns
+
+### 1. Feature-Aware Coding
+
+When writing code, Augment:
+- Suggests feature references
+- Validates against ledger
+- Maintains consistency
+- Updates documentation
+
+Example:
+```javascript
+// Start typing a function
+function processPayment() {
+  // Augment suggests:
+  // Feature: FL-003 - Payment Processing
+  // Dependencies: FL-001 (Auth), FL-002 (User)
+  // Sprint Task: T14_S03
+}
+```
+
+### 2. Smart Code Completion
+
+Context-aware suggestions:
+
+```javascript
+// When implementing authentication
+user.authenticate() // Augment knows this relates to FL-001
+
+// Suggests methods from feature spec:
+user.validateCredentials()
+user.generateToken()
+user.setupTwoFactor()
+```
+
+### 3. Team Collaboration
+
+Shared understanding:
+
+```javascript
+// Team member A implements feature
+// @augment FL-001 implementation by @alice
+
+// Team member B sees context
+// Augment shows: "Alice implemented FL-001, see patterns in auth.js"
+```
+
+### 4. Automated Documentation
+
+Augment generates:
+
+```javascript
+/**
+ * Processes user payment
+ * 
+ * @feature FL-003 - Payment Processing
+ * @sprint S03
+ * @task T14_S03
+ * @dependencies FL-001, FL-002
+ * @augment-generated
+ */
+function processPayment(userId, amount) {
+  // Implementation
+}
+```
+
+### 5. Code Review Integration
+
+During reviews, Augment:
+- Checks feature compliance
+- Validates sprint alignment
+- Ensures persona guidelines
+- Suggests improvements
+
+## Best Practices
+
+### 1. Feature First
+
+Always start with feature context:
+```
+@augment explain FL-001
+@augment show dependencies for current file
+@augment validate against feature spec
+```
+
+### 2. Team Sync
+
+Keep team aligned:
+```
+@augment share feature understanding
+@augment show team progress on S03
+@augment who worked on FL-001?
+```
+
+### 3. Sprint Focus
+
+Stay on track:
+```
+@augment current sprint tasks
+@augment my assigned tasks
+@augment task progress T13_S03
+```
+
+### 4. Documentation
+
+Let Augment help:
+```
+@augment document this function
+@augment update feature docs
+@augment generate API docs
+```
+
+## Advanced Features
+
+### 1. Codebase Analysis
+
+Deep understanding commands:
+
+```
+@augment analyze feature coverage
+@augment find feature gaps
+@augment suggest refactoring for FL-001
+@augment architecture review
+```
+
+### 2. Test Generation
+
+AIWF-aware testing:
+
+```javascript
+// @augment generate tests for FL-001
+// Generates:
+describe('Authentication Feature (FL-001)', () => {
+  it('should validate credentials', () => {
+    // Test based on feature spec
+  });
+  
+  it('should handle 2FA', () => {
+    // Test for feature requirement
+  });
+});
+```
+
+### 3. Refactoring Suggestions
+
+Intelligent improvements:
+
+```
+@augment refactor for feature FL-001
+// Suggests:
+// - Extract authentication logic to service
+// - Implement strategy pattern for auth methods
+// - Add feature flag for gradual rollout
+```
+
+### 4. Knowledge Queries
+
+Ask about your codebase:
+
+```
+@augment how does authentication work?
+@augment what features depend on user service?
+@augment show architecture for payment system
+@augment who has expertise in FL-003?
+```
+
+## Team Features
+
+### 1. Expertise Mapping
+
+Augment tracks:
+- Who implemented which features
+- Domain expertise by team member
+- Code ownership patterns
+- Review participation
+
+### 2. Task Assignment
+
+Smart suggestions:
+```
+@augment who should implement T14_S03?
+// Based on:
+// - Feature expertise
+// - Current workload
+// - Past performance
+```
+
+### 3. Knowledge Transfer
+
+Automated documentation:
+```
+@augment create onboarding guide for FL-001
+@augment explain payment flow to new developer
+@augment document team decisions on auth
+```
+
+### 4. Code Consistency
+
+Team-wide patterns:
+```
+@augment show team coding patterns
+@augment enforce style for FL-001
+@augment suggest consistent naming
+```
+
+## Performance Optimization
+
+### 1. Context Management
+
+- Augment automatically compresses large contexts
+- Prioritizes relevant features
+- Caches frequently accessed data
+- Optimizes for quick responses
+
+### 2. Indexing Strategy
+
+- Incremental indexing on file changes
+- Priority indexing for active features
+- Background indexing for full codebase
+- Smart cache invalidation
+
+### 3. Team Sync
+
+- Efficient delta syncing
+- Compressed knowledge transfer
+- Lazy loading of team data
+- Local caching of common queries
+
+## Integration Commands
+
+Quick reference:
+
+```bash
+# Feature commands
+@augment feature list
+@augment feature show FL-001
+@augment feature validate
+
+# Sprint commands
+@augment sprint current
+@augment sprint tasks
+@augment sprint progress
+
+# Team commands
+@augment team status
+@augment team expertise
+@augment team assign T14_S03
+
+# Analysis commands
+@augment analyze codebase
+@augment analyze dependencies
+@augment analyze architecture
+```
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Augment not recognizing features**
+   - Run `@augment reindex features`
+   - Check .augment/config.json
+   - Verify feature ledger structure
+
+2. **Team sync issues**
+   - Check network connectivity
+   - Verify team permissions
+   - Run `@augment team sync --force`
+
+3. **Slow performance**
+   - Enable compression: `@augment config set compression true`
+   - Clear cache: `@augment cache clear`
+   - Reduce context size
+
+### Debug Mode
+
+Enable detailed logging:
+
+```json
+{
+  "augment": {
+    "debug": {
+      "enabled": true,
+      "verbose": true,
+      "log_file": ".augment/debug.log"
+    }
+  }
+}
+```
+
+## Best Practices Summary
+
+1. **Always reference features** in code and commits
+2. **Keep sprint tasks updated** as you work
+3. **Use appropriate personas** for different tasks
+4. **Leverage team features** for collaboration
+5. **Let Augment generate** documentation
+6. **Trust codebase analysis** for decisions
+7. **Share knowledge** through Augment
+8. **Maintain feature specs** for accuracy
+
+---
+
+*Augment AIWF Integration v1.0.0*

package/.aiwf/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