aiwf 0.3.19 → 0.3.21

package/src/lib/validator.js

@@ -119,14 +119,37 @@ async function validateTool(tool) {
  */
 async function validateClaudeCode() {
   try {
-    const requiredFiles = [
+    // 기본 필수 파일 (현재 리포지토리에 존재하는 핵심 명령어)
+    const baseRequired = [
       'aiwf_initialize.md',
       'aiwf_do_task.md',
-      'aiwf_commit.md',
-      'aiwf_code_review.md'
+      'aiwf_commit.md'
+    ];
+
+    // 과거 필수였던 리뷰 명령어의 대체 후보들
+    const reviewPrimary = 'aiwf_code_review.md';
+    const reviewAlternatives = [
+      'aiwf_yolo.md',
+      'aiwf_prime.md',
+      'aiwf_agent_workflow.md'
     ];
 
-    for (const fileName of requiredFiles) {
+    // 디렉토리 존재 및 파일 개수 간단 점검
+    const dirExists = await fs
+      .access(TOOL_DIRS.CLAUDE_COMMANDS)
+      .then(() => true)
+      .catch(() => false);
+    if (!dirExists) {
+      return { success: false, reason: `Missing Claude commands directory: ${TOOL_DIRS.CLAUDE_COMMANDS}` };
+    }
+
+    const allFiles = await fs.readdir(TOOL_DIRS.CLAUDE_COMMANDS);
+    if (allFiles.length < VALIDATION_CONSTANTS.MIN_FILE_COUNT.CLAUDE_COMMANDS) {
+      return { success: false, reason: `Insufficient Claude commands files: expected at least ${VALIDATION_CONSTANTS.MIN_FILE_COUNT.CLAUDE_COMMANDS}, found ${allFiles.length}` };
+    }
+
+    // 기본 필수 파일 존재/크기 확인
+    for (const fileName of baseRequired) {
       const filePath = path.join(TOOL_DIRS.CLAUDE_COMMANDS, fileName);
       const exists = await fs
         .access(filePath)
@@ -135,8 +158,6 @@ async function validateClaudeCode() {
       if (!exists) {
         return { success: false, reason: `Missing file: ${filePath}` };
       }
-      
-      // Check file size
       try {
         const stats = await fs.stat(filePath);
         if (stats.size < VALIDATION_CONSTANTS.MIN_FILE_SIZE) {
@@ -147,6 +168,35 @@ async function validateClaudeCode() {
       }
     }
 
+    // 리뷰 명령어: 기본 파일 또는 대체 파일 중 하나라도 존재하면 통과
+    const reviewPrimaryPath = path.join(TOOL_DIRS.CLAUDE_COMMANDS, reviewPrimary);
+    const primaryExists = await fs.access(reviewPrimaryPath).then(() => true).catch(() => false);
+
+    let alternativeUsed = null;
+    if (!primaryExists) {
+      for (const alt of reviewAlternatives) {
+        const altPath = path.join(TOOL_DIRS.CLAUDE_COMMANDS, alt);
+        const altExists = await fs.access(altPath).then(() => true).catch(() => false);
+        if (altExists) {
+          alternativeUsed = alt;
+          // 크기 확인
+          try {
+            const stats = await fs.stat(altPath);
+            if (stats.size < VALIDATION_CONSTANTS.MIN_FILE_SIZE) {
+              return { success: false, reason: `File ${alt} is too small (${stats.size} bytes)` };
+            }
+          } catch (error) {
+            return { success: false, reason: `Cannot read file ${alt}: ${error.message}` };
+          }
+          break;
+        }
+      }
+    }
+
+    if (!primaryExists && !alternativeUsed) {
+      return { success: false, reason: `Missing file: ${reviewPrimary} (or one of alternatives: ${reviewAlternatives.join(', ')})` };
+    }
+
     return { success: true };
   } catch (error) {
     return { success: false, reason: `Claude Code validation error: ${error.message}` };

package/ai-tools/README.md

@@ -1,105 +0,0 @@
-# AIWF AI Tool Integration Templates
-
-This directory contains integration templates for various AI development tools to work seamlessly with the AI Workflow Framework (AIWF).
-
-## Available Tools
-
-### 1. Claude Code (`claude-code`)
-- **Description**: Official Anthropic Claude Code integration
-- **Features**: Deep AIWF integration, feature ledger sync, AI personas
-- **Installation**: `aiwf ai-tool install claude-code`
-
-### 2. GitHub Copilot (`github-copilot`)
-- **Description**: GitHub Copilot configuration for AIWF projects
-- **Features**: Feature-aware suggestions, sprint task integration
-- **Installation**: `aiwf ai-tool install github-copilot`
-
-### 3. Cursor (`cursor`)
-- **Description**: Cursor IDE integration with AIWF
-- **Features**: Multi-file context, composer enhancement, task tracking
-- **Installation**: `aiwf ai-tool install cursor`
-
-### 4. Windsurf (`windsurf`)
-- **Description**: Windsurf IDE with Cascade AI integration
-- **Features**: Flow-based development, multi-agent support, visual progress
-- **Installation**: `aiwf ai-tool install windsurf`
-
-### 5. Augment (`augment`)
-- **Description**: Augment Code with deep codebase understanding
-- **Features**: Team collaboration, knowledge queries, smart refactoring
-- **Installation**: `aiwf ai-tool install augment`
-
-## Quick Start
-
-1. **List available tools**:
-   ```bash
-   aiwf ai-tool list
-   ```
-
-2. **Install a tool**:
-   ```bash
-   aiwf ai-tool install <tool-name>
-   ```
-
-3. **Update installed tools**:
-   ```bash
-   aiwf ai-tool update <tool-name>
-   ```
-
-4. **Verify installation**:
-   ```bash
-   aiwf ai-tool verify <tool-name>
-   ```
-
-## Integration Features
-
-All templates provide:
-- ✅ Feature Ledger integration
-- ✅ AI Persona support
-- ✅ Sprint task management
-- ✅ Context optimization
-- ✅ Offline cache support
-
-## Directory Structure
-
-```
-ai-tools/
-├── claude-code/
-│   ├── template/
-│   ├── config.json
-│   └── README.md
-├── github-copilot/
-│   ├── template/
-│   ├── config.json
-│   └── README.md
-├── cursor/
-│   ├── template/
-│   ├── config.json
-│   └── README.md
-├── windsurf/
-│   ├── template/
-│   ├── config.json
-│   └── README.md
-└── augment/
-    ├── template/
-    ├── config.json
-    └── README.md
-```
-
-## Customization
-
-Each tool template can be customized:
-1. Edit the template files in the tool directory
-2. Modify config.json for tool-specific settings
-3. Add project-specific rules to the template files
-
-## Support
-
-For issues or questions:
-- Check individual tool README files
-- Visit [AIWF Documentation](https://aiwf.dev)
-- Submit issues on GitHub
-
----
-
-*AIWF AI Tool Integration System v1.0.0*

package/ai-tools/augment/README.md

@@ -1,371 +0,0 @@
-# Augment AIWF Integration Template
-
-## Overview
-
-This template integrates Augment Code's deep codebase understanding and team collaboration features with AIWF's structured development framework. It creates a powerful combination for AI-assisted team development.
-
-## Features
-
-- **Deep Codebase Understanding**: Augment comprehends your entire AIWF structure
-- **Team Collaboration**: Shared feature knowledge and task coordination
-- **Intelligent Code Completion**: Context-aware suggestions based on features
-- **Automated Documentation**: Generate docs aligned with AIWF standards
-- **Smart Refactoring**: Feature-aware code improvements
-- **Knowledge Queries**: Ask questions about your AIWF project
-
-## Installation
-
-```bash
-# Install Augment template
-aiwf ai-tool install augment
-
-# Or manually copy template files
-cp -r .aiwf/ai-tools/augment/template/* .
-```
-
-## Configuration
-
-The template includes:
-
-1. **augment.config.json**: Main configuration
-   - AIWF integration settings
-   - Team collaboration options
-   - AI model preferences
-   - Automation rules
-
-2. **.augment/aiwf-integration.md**: Integration guide
-   - Usage patterns
-   - Team features
-   - Best practices
-   - Command reference
-
-## Core Capabilities
-
-### 1. Feature-Aware Development
-
-Augment understands your Feature Ledger:
-
-```javascript
-// Start typing code
-function createUser() {
-  // Augment suggests:
-  // This relates to Feature FL-002 - User Management
-  // Dependencies: FL-001 (Authentication)
-  // Current status: in_progress
-}
-```
-
-### 2. Team Knowledge Sharing
-
-Share understanding across your team:
-
-```
-@augment who implemented authentication?
-// Alice implemented FL-001 last week
-
-@augment show alice's patterns for error handling
-// Shows consistent patterns from Alice's code
-```
-
-### 3. Sprint Task Management
-
-Stay aligned with sprints:
-
-```
-@augment my current tasks
-// T13_S03 - AI Tool Integration (in_progress)
-// T14_S03 - Performance Optimization (pending)
-
-@augment suggest next task
-// Based on your expertise and dependencies
-```
-
-### 4. Intelligent Documentation
-
-Auto-generate AIWF-compliant docs:
-
-```javascript
-// @augment document this class
-/**
- * UserService handles user management operations
- * 
- * @feature FL-002 - User Management
- * @sprint S03
- * @implements Requirements from FL-002 specification
- * @dependencies FL-001 (Authentication)
- * 
- * @example
- * const userService = new UserService();
- * const user = await userService.createUser(data);
- */
-class UserService {
-  // Implementation
-}
-```
-
-## Usage Examples
-
-### 1. Feature Development
-
-```javascript
-// @augment implement FL-003 payment processing
-
-// Augment provides:
-// - Feature specification summary
-// - Required methods from spec
-// - Integration points with other features
-// - Test requirements
-// - Documentation template
-```
-
-### 2. Code Review
-
-```javascript
-// @augment review this PR for FL-001 compliance
-
-// Augment checks:
-// ✓ Implements all required features
-// ✓ Follows team patterns
-// ✓ Has appropriate tests
-// ⚠ Missing error handling for edge case X
-// ⚠ Consider using established pattern from auth.js
-```
-
-### 3. Refactoring
-
-```javascript
-// @augment refactor payment module for better feature separation
-
-// Augment suggests:
-// 1. Extract FL-003 logic to PaymentService
-// 2. Move FL-001 auth checks to middleware
-// 3. Create feature flags for gradual rollout
-// 4. Add monitoring for new architecture
-```
-
-### 4. Knowledge Queries
-
-```
-@augment how does our authentication flow work?
-// Augment explains FL-001 implementation with code examples
-
-@augment what depends on the user service?
-// Features: FL-003 (payments), FL-004 (notifications)
-// Files: 15 controllers, 8 services, 23 tests
-
-@augment show architecture diagram
-// Generates visual representation of feature dependencies
-```
-
-## Team Collaboration Features
-
-### 1. Expertise Mapping
-
-```
-@augment team expertise
-// Alice: FL-001 (auth), FL-002 (users) - Senior
-// Bob: FL-003 (payments), FL-005 (analytics) - Expert
-// Carol: FL-004 (notifications) - Intermediate
-```
-
-### 2. Task Assignment
-
-```
-@augment assign T14_S03
-// Recommends: Bob (payment expertise, available capacity)
-// Alternative: Alice (general expertise, higher load)
-```
-
-### 3. Code Patterns
-
-```
-@augment show team patterns for error handling
-// Consistent patterns across team:
-// - Custom error classes per feature
-// - Centralized error logging
-// - User-friendly error messages
-```
-
-### 4. Onboarding
-
-```
-@augment create onboarding guide for new developer
-// Generates comprehensive guide:
-// - Project structure
-// - Feature overview
-// - Team patterns
-// - Development workflow
-// - Key architecture decisions
-```
-
-## Advanced Features
-
-### 1. Codebase Analysis
-
-```
-@augment analyze feature coverage
-// FL-001: 95% implemented, 90% tested
-// FL-002: 80% implemented, 85% tested
-// FL-003: 60% implemented, 70% tested
-
-@augment find technical debt
-// - Duplicated auth logic in 3 files
-// - Missing tests for edge cases in FL-002
-// - Outdated dependencies in payment module
-```
-
-### 2. Architecture Insights
-
-```
-@augment analyze architecture
-// - Clean separation between features
-// - Some circular dependencies detected
-// - Opportunity to extract shared utilities
-// - Consider implementing event system
-```
-
-### 3. Performance Analysis
-
-```
-@augment analyze performance bottlenecks
-// - Database queries in user service (N+1)
-// - Synchronous payment processing
-// - Large bundle size from unused imports
-```
-
-### 4. Test Generation
-
-```javascript
-// @augment generate tests for UserService
-
-describe('UserService (FL-002)', () => {
-  // Generates comprehensive test suite
-  // based on feature specifications
-});
-```
-
-## Best Practices
-
-### 1. Feature-First Approach
-
-Always start with feature context:
-- Check Feature Ledger before coding
-- Reference features in all code
-- Update feature status regularly
-
-### 2. Team Alignment
-
-Leverage team features:
-- Share knowledge through Augment
-- Follow team patterns
-- Document decisions
-
-### 3. Sprint Discipline
-
-Stay focused on current work:
-- Check sprint tasks daily
-- Update progress regularly
-- Complete tasks fully
-
-### 4. Continuous Learning
-
-Let Augment teach:
-- Ask about unfamiliar code
-- Learn team patterns
-- Understand architecture
-
-## Configuration Options
-
-### 1. Model Selection
-
-```json
-{
-  "models": {
-    "completion": "augment-fast",      // Quick suggestions
-    "understanding": "augment-deep",   // Complex analysis
-    "documentation": "augment-doc",    // Doc generation
-    "review": "augment-review"         // Code review
-  }
-}
-```
-
-### 2. Team Settings
-
-```json
-{
-  "team": {
-    "sync_interval": "5m",
-    "share_patterns": true,
-    "expertise_tracking": true,
-    "automated_assignment": false
-  }
-}
-```
-
-### 3. Automation
-
-```json
-{
-  "automation": {
-    "auto_document": true,
-    "suggest_refactoring": true,
-    "update_feature_status": true,
-    "generate_tests": false
-  }
-}
-```
-
-## Troubleshooting
-
-### Common Issues
-
-1. **Slow indexing**
-   ```
-   @augment config set indexing.incremental true
-   @augment reindex --fast
-   ```
-
-2. **Team sync problems**
-   ```
-   @augment team sync --reset
-   @augment team verify
-   ```
-
-3. **Feature recognition**
-   ```
-   @augment feature reindex
-   @augment feature validate
-   ```
-
-### Performance Tips
-
-1. Enable caching for faster responses
-2. Use incremental indexing
-3. Compress large contexts
-4. Limit analysis scope when needed
-
-## Updates
-
-Keep Augment template current:
-
-```bash
-# Check version
-aiwf ai-tool version augment
-
-# Update template
-aiwf ai-tool update augment
-
-# Verify installation
-aiwf ai-tool verify augment
-```
-
-## Resources
-
-- [Augment Documentation](https://augmentcode.com/docs)
-- [AIWF Documentation](https://aiwf.dev/docs)
-- [Integration Examples](https://github.com/aiwf/augment-examples)
-- [Team Playbook](https://aiwf.dev/guides/team-collaboration)
-
----
-
-*Augment Integration Template v1.0.0*

package/ai-tools/augment/config.json

@@ -1,30 +0,0 @@
-{
-  "name": "augment",
-  "version": "1.0.0",
-  "description": "Augment Code integration template for AIWF",
-  "compatible_aiwf_version": ">=0.1.0",
-  "features": {
-    "feature_ledger": true,
-    "ai_persona": true,
-    "context_compression": true,
-    "offline_cache": true,
-    "team_collaboration": true
-  },
-  "setup_commands": [],
-  "files_to_copy": [
-    {
-      "source": "template/.augment",
-      "destination": ".augment"
-    },
-    {
-      "source": "template/augment.config.json",
-      "destination": "augment.config.json"
-    }
-  ],
-  "settings": {
-    "aiwf_team_sync": true,
-    "feature_awareness": true,
-    "codebase_understanding": true,
-    "automated_documentation": true
-  }
-}