aiwf 0.3.19 → 0.3.21

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

@@ -1,387 +0,0 @@
-# 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/ai-tools/augment/template/.augment/augment.yaml

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