opencode-sa-assistant 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jisan Bang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,174 @@
+# opencode-sa-assistant
+
+OpenCode plugin for AWS Solutions Architect assistance with multi-agent Guru system.
+
+## Overview
+
+This plugin activates when you use the `wadd` keyword in your messages, transforming OpenCode into an AWS Solutions Architect assistant powered by 7 specialized agents:
+
+**4 Guru Agents** (Philosophy & Wisdom):
+- `sa-bezos`: Customer Obsession, Day 1, Working Backwards
+- `sa-vogels`: Distributed Systems, Design for Failure
+- `sa-naval`: Leverage, Asymmetric Outcomes
+- `sa-feynman`: Simplification, First Principles
+
+**3 Specialist Agents** (Execution):
+- `sa-explorer`: Architecture analysis, diagram interpretation
+- `sa-researcher`: AWS service information via MCP tools
+- `sa-reviewer`: Well-Architected Framework reviews (6 pillars)
+
+## Features
+
+✨ **WADD Mode Activation**: Type `wadd` to activate SA mode  
+🧠 **Multi-Agent System**: 4 Gurus + 3 Specialists working together  
+📋 **Guru_Mandate**: Automatic expert consultation based on context  
+🏗️ **Well-Architected Framework**: All 6 pillars integrated  
+📚 **AWS MCP Tools**: Real-time AWS documentation access  
+🇰🇷 **Bilingual**: Korean prose + English technical terms  
+
+## Installation
+
+```bash
+# From the repository root
+cd packages/opencode-sa-assistant
+bun install
+```
+
+## Usage
+
+### Basic Activation
+
+In OpenCode, simply start your message with `wadd`:
+
+```
+wadd 이 Lambda 아키텍처를 리뷰해줘
+```
+
+The plugin will:
+1. Detect the `wadd` keyword (case-insensitive, word boundary)
+2. Activate SA mode (sets model to "max" variant)
+3. Inject the SA Orchestrator system prompt
+4. Consult appropriate Gurus based on Guru_Mandate rules
+
+### Guru_Mandate Rules
+
+The orchestrator automatically consults Gurus based on context:
+
+| Scenario | Gurus Consulted |
+|----------|-----------------|
+| Architecture design/review | vogels + bezos |
+| Cost decisions | naval + bezos |
+| Learning/explanation | feynman + relevant guru |
+| System design | vogels + naval |
+| Security/compliance | vogels + bezos |
+| Innovation | bezos + feynman |
+
+### Direct Agent Invocation
+
+You can also directly request specific agents:
+
+```
+wadd bezos에게 고객 경험 관점에서 이 기능을 평가해달라고 해줘
+```
+
+## Skills
+
+The plugin includes 4 skill modules:
+
+- **guru**: Guru consultation patterns and philosophies
+- **mcp**: AWS MCP tools reference (search_documentation, read_documentation)
+- **docx**: AWS Blog-style document generation guidelines
+- **pptx**: SA presentation templates
+
+Skills are automatically loaded when needed.
+
+## Testing
+
+```bash
+# Run all tests
+bun test
+
+# Run specific test file
+bun test src/__tests__/integration.test.ts
+```
+
+**Test Coverage**: 65 tests, 212 assertions, 100% pass rate
+
+## Development
+
+### Project Structure
+
+```
+packages/opencode-sa-assistant/
+├── src/
+│   ├── index.ts                     # Plugin entry point
+│   ├── hooks/wadd-mode.ts           # WADD keyword detection
+│   ├── prompts/
+│   │   ├── orchestrator.ts          # SA Orchestrator
+│   │   ├── gurus.ts                 # 4 Guru agents
+│   │   └── specialists.ts           # 3 Specialist agents
+│   ├── skills/
+│   │   ├── guru/SKILL.md
+│   │   ├── mcp/SKILL.md
+│   │   ├── docx/SKILL.md
+│   │   └── pptx/SKILL.md
+│   └── __tests__/
+│       └── *.test.ts                # 65 tests
+├── package.json
+├── tsconfig.json
+└── bunfig.toml
+```
+
+### Tech Stack
+
+- **Runtime**: Bun
+- **Language**: TypeScript
+- **Testing**: Bun test
+- **Plugin SDK**: @opencode-ai/plugin
+
+## Well-Architected Framework
+
+The reviewer specialist covers all 6 pillars:
+
+1. **운영 우수성** (Operational Excellence)
+2. **보안** (Security)
+3. **안정성** (Reliability)
+4. **성능 효율성** (Performance Efficiency)
+5. **비용 최적화** (Cost Optimization)
+6. **지속 가능성** (Sustainability)
+
+## AWS MCP Integration
+
+The plugin integrates with AWS Documentation MCP for real-time information:
+
+- `aws-docs_search_documentation`: Search AWS documentation
+- `aws-docs_read_documentation`: Fetch specific documentation pages
+- `aws-docs_recommend`: Get related documentation
+
+## License
+
+[Your License Here]
+
+## Author
+
+Jisan Bang (wltks2155@gmail.com)
+
+## Contributing
+
+Contributions are welcome! Please ensure:
+- All tests pass (`bun test`)
+- TDD protocol followed (RED → GREEN → REFACTOR)
+- Korean + English bilingual content preserved
+- Conventional commit format used
+
+## Changelog
+
+### v0.1.0 (2026-02-05)
+
+- Initial release
+- 7 agent types (4 Gurus + 3 Specialists)
+- WADD mode activation
+- Guru_Mandate consultation system
+- Well-Architected Framework integration
+- AWS MCP tools support
+- 65 tests, 100% pass rate

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "opencode-sa-assistant",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "src/index.ts",
+  "description": "OpenCode plugin for AWS Solutions Architect assistant with multi-agent Guru system",
+  "author": "Jisan Bang <wltks2155@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/onesuit/SaAssistant.git",
+    "directory": "packages/opencode-sa-assistant"
+  },
+  "homepage": "https://github.com/onesuit/SaAssistant/tree/main/packages/opencode-sa-assistant#readme",
+  "bugs": {
+    "url": "https://github.com/onesuit/SaAssistant/issues"
+  },
+  "keywords": [
+    "opencode-plugin",
+    "aws",
+    "solutions-architect",
+    "well-architected",
+    "multi-agent",
+    "guru",
+    "architecture-review",
+    "opencode"
+  ],
+  "files": [
+    "src/**/*.ts",
+    "!src/**/*.test.ts",
+    "!src/__tests__/**",
+    "src/**/*.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts"
+    }
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "*"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  }
+}

package/src/hooks/wadd-mode.ts

@@ -0,0 +1,71 @@
+/**
+ * WADD Mode Activation System
+ * 
+ * Detects "wadd" keyword and activates AWS Solutions Architect mode.
+ * Uses word boundary regex to prevent false positives.
+ */
+
+import { SA_ORCHESTRATOR_PROMPT } from "../prompts/orchestrator";
+
+/**
+ * Regex pattern for WADD keyword detection
+ * - \b: Word boundary (prevents matching "wa", "wadding", "mywadd")
+ * - i flag: Case-insensitive matching
+ */
+const WADD_PATTERN = /\bwadd\b/i;
+
+/**
+ * Detects if content contains the WADD keyword
+ * @param content - User message content to check
+ * @returns true if WADD keyword found, false otherwise
+ */
+export function detectWaddKeyword(content: string): boolean {
+  return WADD_PATTERN.test(content);
+}
+
+/**
+ * Activates SA mode by modifying message properties
+ * @param message - Message object to modify
+ */
+export function activateSAMode(message: any): void {
+  // Set variant to "max" for best model
+  message.variant = "max";
+  
+  // Prepend SA mode activation marker
+  // (Full orchestrator prompt will be added in Task 5)
+  message.content = `[SA MODE ACTIVATED]\n\n${message.content}`;
+}
+
+/**
+ * Hook: chat.message
+ * Intercepts user messages to detect WADD keyword and activate SA mode
+ */
+export const chatMessageHook = async (input: any, output: any) => {
+  if (detectWaddKeyword(input.message.content)) {
+    activateSAMode(output.message);
+    
+    // Show toast notification if API available
+    if (output.toasts) {
+      output.toasts.push({
+        type: "info",
+        title: "SA Assistant Mode",
+        message: "AWS Solutions Architect mode activated"
+      });
+    }
+  }
+};
+
+/**
+ * Hook: experimental.chat.system.transform
+ * Injects SA orchestrator system prompt when SA mode is active
+ */
+export const systemTransformHook = async (input: any, output: any) => {
+  // Check if SA mode is active by scanning message history
+  const hasWadd = input.messages?.some((m: any) => 
+    m.content && detectWaddKeyword(m.content)
+  );
+  
+  if (hasWadd) {
+    output.system = `${output.system || ""}\n\n${SA_ORCHESTRATOR_PROMPT}`;
+  }
+};

package/src/index.ts

@@ -0,0 +1,9 @@
+import type { Plugin } from "@opencode-ai/plugin";
+import { chatMessageHook, systemTransformHook } from "./hooks/wadd-mode";
+
+export const SaAssistantPlugin: Plugin = async (ctx) => {
+  return {
+    "chat.message": chatMessageHook,
+    "experimental.chat.system.transform": systemTransformHook,
+  };
+};