codingbuddy-rules 1.3.0 → 2.0.0

package/.ai-rules/CHANGELOG.md

@@ -5,6 +5,55 @@ All notable changes to the Multi-AI Coding Assistant Common Rules System will be
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.0] - 2026-01-06
+
+### Added
+
+- **PLAN Mode Primary Agents** with intent-based resolution
+  - `solution-architect.json`: High-level system design and architecture planning
+  - `technical-planner.json`: Low-level implementation planning with TDD and bite-sized tasks
+  - Intent-based automatic selection between architects based on prompt analysis
+  - Support for Korean and English intent patterns
+
+- **AI Model Selection and Resolution**
+  - CLI init prompt for model selection (Sonnet/Opus/Haiku)
+  - `ai.defaultModel` configuration field in `codingbuddy.config.js`
+  - Agent-level model preferences with priority resolution (agent > mode > system)
+  - `resolvedModel` field in MCP tool responses
+
+- **Parallel Agent Execution Support**
+  - `get_agent_system_prompt` MCP tool for generating subagent prompts
+  - `prepare_parallel_agents` MCP tool for batch agent preparation
+  - `parallelAgentsRecommendation` in `parse_mode` response
+  - Default specialist lists per mode (PLAN/ACT/EVAL)
+
+- **Dynamic Language Configuration**
+  - `LanguageService` supporting 10 languages (ko, en, ja, zh, es, de, fr, pt, ru, hi)
+  - `languageInstruction` field in `parse_mode` response
+  - Automatic language detection from project config
+
+- **Agent Activation Transparency**
+  - `ActivationMessageBuilder` for clear agent activation reporting
+  - `activation_message` field showing active agents with tiers
+
+### Changed
+
+- **Primary Agent Resolution**
+  - Extended `PrimaryAgentSource` type to include `intent`
+  - Priority order: explicit > config > intent > context > default
+  - Centralized Primary Agent constants with `_LIST` variants
+
+- **Token Usage Optimization**
+  - Mode-based `core.md` filtering to reduce token consumption
+  - Shared `ResponseUtils` for consolidated response generation
+
+### Fixed
+
+- Canary deployment timestamp mismatch bug
+- Type assertions replaced with proper typing in keyword service
+
+---
+
 ## [1.0.0] - 2025-11-20
 
 ### Added
@@ -48,18 +97,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Added
-- **Clarification Phase** for PLAN mode (`rules/clarification-guide.md`)
-  - Optional phase triggered when AI detects ambiguous requirements
-  - Sequential Q&A with progress indicator (Question N/M format)
-  - Multiple-choice questions preferred for easy response
-  - Ambiguity assessment checklist (6 categories, triggers on 2+ unclear)
-  - Question count guidelines (2-7 questions based on complexity)
-  - Korean/English output format support
-  - Updated `rules/core.md` with Clarification Phase section
-
 ### Planned
-- Real-world usage testing across all 6 AI tools
+- Real-world usage testing across all 7 AI tools (including OpenCode)
 - Performance metrics collection
 - User feedback integration
 - Advanced examples and use cases

package/.ai-rules/adapters/claude-code.md

@@ -165,3 +165,95 @@ recommend_skills({ prompt: "Build a dashboard component" })
 **Supported Languages:** English, Korean, Japanese, Chinese, Spanish
 
 The tool returns skill recommendations with confidence levels (high/medium) and matched patterns for transparency.
+
+## Agent Hierarchy
+
+CodingBuddy uses a layered agent hierarchy for different types of tasks:
+
+### Tier 1: Primary Agents (Mode-specific)
+
+| Mode | Agents | Description |
+|------|--------|-------------|
+| **PLAN** | solution-architect, technical-planner | Design and planning tasks |
+| **ACT** | frontend-developer, backend-developer, devops-engineer, agent-architect | Implementation tasks |
+| **EVAL** | code-reviewer | Code review and evaluation |
+
+### Tier 2: Specialist Agents
+
+Specialist agents can be invoked by any Primary Agent as needed:
+
+- security-specialist
+- accessibility-specialist
+- performance-specialist
+- test-strategy-specialist
+- documentation-specialist
+- architecture-specialist
+- code-quality-specialist
+- seo-specialist
+- design-system-specialist
+
+### Agent Resolution
+
+1. **PLAN mode**: Always uses `solution-architect` or `technical-planner` based on prompt analysis
+2. **ACT mode**: Uses recommended agent from PLAN, or falls back to AI analysis
+3. **EVAL mode**: Always uses `code-reviewer`
+
+## Activation Messages
+
+When agents or skills are activated, CodingBuddy displays activation messages for transparency:
+
+### Output Format
+
+```
+🤖 solution-architect [Primary Agent]
+👤 security-specialist [Specialist] (by solution-architect)
+⚡ brainstorming [Specialist] (by technical-planner)
+```
+
+### Icons
+
+| Icon | Meaning |
+|------|---------|
+| 🤖 | Primary Agent |
+| 👤 | Specialist Agent |
+| ⚡ | Skill |
+
+### ParseMode Response Fields
+
+The `parse_mode` MCP tool returns these agent-related fields:
+
+```json
+{
+  "mode": "PLAN",
+  "delegates_to": "solution-architect",
+  "primary_agent_source": "intent",
+  "activation_message": {
+    "formatted": "🤖 solution-architect [Primary Agent]",
+    "activations": [
+      {
+        "type": "agent",
+        "name": "solution-architect",
+        "tier": "primary",
+        "timestamp": "2024-01-06T12:00:00Z"
+      }
+    ]
+  },
+  "recommended_act_agent": {
+    "agentName": "backend-developer",
+    "reason": "API implementation task detected",
+    "confidence": 0.9
+  }
+}
+```
+
+### Displaying Activation Messages
+
+AI assistants should display the `activation_message.formatted` field at the start of their response:
+
+```
+🤖 solution-architect [Primary Agent]
+
+# Mode: PLAN
+
+...
+```

package/.ai-rules/adapters/opencode.md

@@ -59,11 +59,70 @@ Update your configuration file (`.opencode.json` or `crush.json`):
     },
     "eval-mode": {
       "description": "EVAL mode - Code quality evaluation", 
-      "mode": "subagent",
+      "mode": "primary",
       "prompt": "{file:packages/rules/.ai-rules/agents/eval-mode.json}\n\n[OpenCode Override]\nMode: EVAL. Always respond in Korean. Provide evidence-based evaluation.",
-      "tools": {
-        "write": false,
-        "edit": false
+      "permission": {
+        "edit": "deny",
+        "bash": {
+          "git status": "allow",
+          "git diff*": "allow",
+          "git log*": "allow",
+          "*": "ask"
+        }
+      }
+    },
+    "backend": {
+      "description": "Backend development - Node.js, Python, Go, Java, Rust",
+      "mode": "subagent",
+      "prompt": "{file:packages/rules/.ai-rules/agents/backend-developer.json}\n\n[OpenCode Override]\nAlways respond in Korean. Follow TDD workflow and clean architecture.",
+      "permission": {
+        "edit": "allow",
+        "bash": "allow"
+      }
+    },
+    "architect": {
+      "description": "Architecture and design patterns specialist",
+      "mode": "subagent",
+      "prompt": "{file:packages/rules/.ai-rules/agents/architecture-specialist.json}\n\n[OpenCode Override]\nAlways respond in Korean. Focus on layer boundaries and dependency direction.",
+      "permission": {
+        "edit": "deny",
+        "bash": "ask"
+      }
+    },
+    "tester": {
+      "description": "Test strategy and TDD specialist",
+      "mode": "subagent",
+      "prompt": "{file:packages/rules/.ai-rules/agents/test-strategy-specialist.json}\n\n[OpenCode Override]\nAlways respond in Korean. Enforce 90%+ coverage and no-mocking principle.",
+      "permission": {
+        "edit": "allow",
+        "bash": "allow"
+      }
+    },
+    "security": {
+      "description": "Security audit - OAuth, JWT, XSS/CSRF protection",
+      "mode": "subagent",
+      "prompt": "{file:packages/rules/.ai-rules/agents/security-specialist.json}\n\n[OpenCode Override]\nAlways respond in Korean. Follow OWASP guidelines.",
+      "permission": {
+        "edit": "deny",
+        "bash": "ask"
+      }
+    },
+    "a11y": {
+      "description": "Accessibility - WCAG 2.1 AA compliance",
+      "mode": "subagent",
+      "prompt": "{file:packages/rules/.ai-rules/agents/accessibility-specialist.json}\n\n[OpenCode Override]\nAlways respond in Korean. Verify ARIA and keyboard navigation.",
+      "permission": {
+        "edit": "deny",
+        "bash": "ask"
+      }
+    },
+    "performance": {
+      "description": "Performance optimization specialist",
+      "mode": "subagent",
+      "prompt": "{file:packages/rules/.ai-rules/agents/performance-specialist.json}\n\n[OpenCode Override]\nAlways respond in Korean. Focus on bundle size and runtime optimization.",
+      "permission": {
+        "edit": "deny",
+        "bash": "ask"
       }
     }
   },
@@ -85,6 +144,7 @@ Update your configuration file (`.opencode.json` or `crush.json`):
 | **act-mode.json** | `act-mode` | ACT mode workflow (delegates to frontend-developer) |
 | **eval-mode.json** | `eval-mode` | EVAL mode workflow (delegates to code-reviewer) |
 | **frontend-developer.json** | N/A (delegate) | Primary development implementation |
+| **backend-developer.json** | `backend` | Backend development (Node.js, Python, Go, Java, Rust) |
 | **code-reviewer.json** | N/A (delegate) | Code quality evaluation implementation |
 | **architecture-specialist.json** | `architect` | Architecture and design patterns |
 | **test-strategy-specialist.json** | `tester` | Test strategy and TDD |
@@ -122,11 +182,40 @@ Once connected, you can use:
 - `search_rules`: Query AI rules and guidelines
 - `get_agent_details`: Get specialist agent information
 - `recommend_skills`: Get skill recommendations based on prompt
-- `parse_mode`: Parse PLAN/ACT/EVAL workflow mode (now returns Mode Agent information)
+- `parse_mode`: Parse PLAN/ACT/EVAL workflow mode (includes dynamic language instructions)
+
+#### Dynamic Language Configuration
+
+OpenCode agents get language instructions dynamically from the MCP server:
+
+1. **Set language in codingbuddy.config.js:**
+   ```javascript
+   module.exports = {
+     language: 'ko',  // or 'en', 'ja', 'zh', 'es', etc.
+     // ... other config
+   };
+   ```
+
+2. **Call parse_mode to get dynamic language instruction:**
+   ```bash
+   # AI should call parse_mode when user starts with PLAN/ACT/EVAL
+   # Returns languageInstruction field automatically
+   ```
+
+3. **Remove hardcoded language from agent prompts:**
+   ```json
+   {
+     "agent": {
+       "plan-mode": {
+         "prompt": "{file:...plan-mode.json}\n\n[OpenCode Override]\nMode: PLAN only. Use languageInstruction from parse_mode response.",
+       }
+     }
+   }
+   ```
 
 #### Enhanced parse_mode Response
 
-The `parse_mode` tool now returns additional Mode Agent information:
+The `parse_mode` tool now returns additional Mode Agent information and dynamic language instructions:
 
 ```json
 {
@@ -134,6 +223,8 @@ The `parse_mode` tool now returns additional Mode Agent information:
   "originalPrompt": "새로운 사용자 등록 기능을 만들어줘",
   "instructions": "설계 우선 접근. TDD 관점에서...",
   "rules": [...],
+  "language": "ko",
+  "languageInstruction": "Always respond in Korean (한국어).",
   "agent": "plan-mode",
   "delegates_to": "frontend-developer", 
   "delegate_agent_info": {
@@ -145,6 +236,8 @@ The `parse_mode` tool now returns additional Mode Agent information:
 ```
 
 **New Fields:**
+- `language`: Language code from codingbuddy.config.js
+- `languageInstruction`: Formatted instruction text for AI assistants (🆕)
 - `agent`: Mode Agent name (plan-mode, act-mode, eval-mode)
 - `delegates_to`: Which specialist agent the Mode Agent delegates to
 - `delegate_agent_info`: Detailed information about the delegate agent (optional)
@@ -383,15 +476,15 @@ npx codingbuddy@latest mcp
 
 ```bash
 # Terminal 1: Planning
-opencode --agent plan
+opencode --agent plan-mode
 계획을 세워줘
 
 # Terminal 2: Implementation  
-opencode --agent build
+opencode --agent act-mode
 ACT
 
 # Terminal 3: Review
-opencode --agent reviewer
+opencode --agent eval-mode
 EVAL
 ```