oh-my-claude-sisyphus 3.8.1 → 3.8.2

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "oh-my-claudecode",
       "description": "Claude Code native multi-agent orchestration with intelligent model routing, 28 agent variants, and 30 powerful skills. Zero learning curve. Maximum power.",
-      "version": "3.8.1",
+      "version": "3.8.2",
       "author": {
         "name": "Yeachan Heo",
         "email": "hurrc04@gmail.com"

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-claudecode",
-  "version": "3.8.1",
+  "version": "3.8.2",
   "description": "Multi-agent orchestration system for Claude Code",
   "skills": "./skills/",
   "mcpServers": "./.mcp.json"

package/docs/CLAUDE.md

@@ -36,8 +36,29 @@ RULE 1: ALWAYS delegate substantive work to specialized agents
 RULE 2: ALWAYS invoke appropriate skills for recognized patterns
 RULE 3: NEVER do code changes directly - delegate to executor
 RULE 4: NEVER complete without Architect verification
+RULE 5: ALWAYS consult official documentation before implementing with SDKs/frameworks/APIs
 ```
 
+### Documentation-First Development (CRITICAL)
+
+**NEVER make assumptions about SDK, framework, or API behavior.**
+
+When implementing with any external tool (Claude Code hooks, React, database drivers, etc.):
+
+1. **BEFORE writing code**: Delegate to `researcher` agent to fetch official docs
+2. **Use Context7 MCP tools**: `resolve-library-id` → `query-docs` for up-to-date documentation
+3. **Verify API contracts**: Check actual schemas, return types, and field names
+4. **No guessing**: If docs are unclear, search for examples or ask the user
+
+**Why this matters**: Assumptions about undocumented fields (like using `message` instead of `hookSpecificOutput.additionalContext`) lead to silent failures that are hard to debug.
+
+| Situation | Action |
+|-----------|--------|
+| Using a new SDK/API | Delegate to `researcher` first |
+| Implementing hooks/plugins | Verify output schema from official docs |
+| Uncertain about field names | Query official documentation |
+| Copying from old code | Verify pattern still valid |
+
 ### What You Do vs. Delegate
 
 | Action | YOU Do Directly | DELEGATE to Agent |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-claude-sisyphus",
-  "version": "3.8.1",
+  "version": "3.8.2",
   "description": "Multi-agent orchestration system for Claude Code - Inspired by oh-my-opencode",
   "type": "module",
   "main": "dist/index.js",

package/scripts/keyword-detector.mjs

@@ -134,6 +134,20 @@ ${originalPrompt}
 IMPORTANT: Invoke the skill IMMEDIATELY. Do not proceed without loading the skill instructions.`;
 }
 
+/**
+ * Create proper hook output with additionalContext (Claude Code hooks API)
+ * The 'message' field is NOT a valid hook output - use hookSpecificOutput.additionalContext
+ */
+function createHookOutput(additionalContext) {
+  return {
+    continue: true,
+    hookSpecificOutput: {
+      hookEventName: 'UserPromptSubmit',
+      additionalContext
+    }
+  };
+}
+
 // Main
 async function main() {
   try {
@@ -161,10 +175,7 @@ async function main() {
     if (/\b(stop|cancel|abort)\b/i.test(cleanPrompt)) {
       // Special: clear state files instead of creating them
       clearStateFiles(directory, ['ralph', 'autopilot', 'ultrapilot', 'ultrawork', 'ecomode', 'swarm', 'pipeline']);
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('cancel', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('cancel', prompt))));
       return;
     }
 
@@ -172,10 +183,7 @@ async function main() {
     if (/\b(ralph|don't stop|must complete|until done)\b/i.test(cleanPrompt)) {
       activateState(directory, prompt, 'ralph');
       activateState(directory, prompt, 'ultrawork');
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('ralph', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('ralph', prompt))));
       return;
     }
 
@@ -190,10 +198,7 @@ async function main() {
         /\bend\s+to\s+end\b/i.test(cleanPrompt) ||
         /\be2e\s+this\b/i.test(cleanPrompt)) {
       activateState(directory, prompt, 'autopilot');
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('autopilot', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('autopilot', prompt))));
       return;
     }
 
@@ -202,30 +207,21 @@ async function main() {
         /\bparallel\s+build\b/i.test(cleanPrompt) ||
         /\bswarm\s+build\b/i.test(cleanPrompt)) {
       activateState(directory, prompt, 'ultrapilot');
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('ultrapilot', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('ultrapilot', prompt))));
       return;
     }
 
     // Priority 5: Ultrawork keywords
     if (/\b(ultrawork|ulw|uw)\b/i.test(cleanPrompt)) {
       activateState(directory, prompt, 'ultrawork');
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('ultrawork', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('ultrawork', prompt))));
       return;
     }
 
     // Priority 6: Ecomode keywords (includes "efficient")
     if (/\b(eco|ecomode|eco-mode|efficient|save-tokens|budget)\b/i.test(cleanPrompt)) {
       activateState(directory, prompt, 'ecomode');
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('ecomode', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('ecomode', prompt))));
       return;
     }
 
@@ -233,37 +229,25 @@ async function main() {
     const swarmMatch = cleanPrompt.match(/\bswarm\s+(\d+)\s+agents?\b/i);
     if (swarmMatch || /\bcoordinated\s+agents\b/i.test(cleanPrompt)) {
       const agentCount = swarmMatch ? swarmMatch[1] : '3'; // default 3
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('swarm', prompt, agentCount)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('swarm', prompt, agentCount))));
       return;
     }
 
     // Priority 8: Pipeline
     if (/\b(pipeline)\b/i.test(cleanPrompt) || /\bchain\s+agents\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('pipeline', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('pipeline', prompt))));
       return;
     }
 
     // Priority 9: Ralplan keyword (before plan to avoid false match)
     if (/\b(ralplan)\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('ralplan', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('ralplan', prompt))));
       return;
     }
 
     // Priority 10: Plan keywords
     if (/\b(plan this|plan the)\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('plan', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('plan', prompt))));
       return;
     }
 
@@ -271,10 +255,7 @@ async function main() {
     if (/\b(tdd)\b/i.test(cleanPrompt) ||
         /\btest\s+first\b/i.test(cleanPrompt) ||
         /\bred\s+green\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('tdd', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('tdd', prompt))));
       return;
     }
 
@@ -283,16 +264,13 @@ async function main() {
     if (/\b(research)\b/i.test(cleanPrompt) ||
         /\banalyze\s+data\b/i.test(cleanPrompt) ||
         /\bstatistics\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('research', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('research', prompt))));
       return;
     }
 
     // Priority 13: Ultrathink/think keywords (keep inline message)
     if (/\b(ultrathink|think hard|think deeply)\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify({ continue: true, message: ULTRATHINK_MESSAGE }));
+      console.log(JSON.stringify(createHookOutput(ULTRATHINK_MESSAGE)));
       return;
     }
 
@@ -300,10 +278,7 @@ async function main() {
     if (/\b(deepsearch)\b/i.test(cleanPrompt) ||
         /\bsearch\s+(the\s+)?(codebase|code|files?|project)\b/i.test(cleanPrompt) ||
         /\bfind\s+(in\s+)?(codebase|code|all\s+files?)\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('deepsearch', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('deepsearch', prompt))));
       return;
     }
 
@@ -311,10 +286,7 @@ async function main() {
     if (/\b(deep\s*analyze)\b/i.test(cleanPrompt) ||
         /\binvestigate\s+(the|this|why)\b/i.test(cleanPrompt) ||
         /\bdebug\s+(the|this|why)\b/i.test(cleanPrompt)) {
-      console.log(JSON.stringify({
-        continue: true,
-        message: createSkillInvocation('analyze', prompt)
-      }));
+      console.log(JSON.stringify(createHookOutput(createSkillInvocation('analyze', prompt))));
       return;
     }
 

package/scripts/post-tool-verifier.mjs

@@ -297,13 +297,14 @@ async function main() {
       }
     }
 
-    // Build response
+    // Build response - use hookSpecificOutput.additionalContext for PostToolUse
     const response = { continue: true };
-    // Prefer clear suggestion over contextual message (more impactful)
-    if (clearSuggestionMessage) {
-      response.message = clearSuggestionMessage;
-    } else if (message) {
-      response.message = message;
+    const contextMessage = clearSuggestionMessage || message;
+    if (contextMessage) {
+      response.hookSpecificOutput = {
+        hookEventName: 'PostToolUse',
+        additionalContext: contextMessage
+      };
     }
 
     console.log(JSON.stringify(response, null, 2));

package/scripts/pre-tool-enforcer.mjs

@@ -115,7 +115,10 @@ async function main() {
 
     console.log(JSON.stringify({
       continue: true,
-      message: message
+      hookSpecificOutput: {
+        hookEventName: 'PreToolUse',
+        additionalContext: message
+      }
     }, null, 2));
   } catch (error) {
     // On error, always continue

package/scripts/session-start.mjs

@@ -171,7 +171,13 @@ ${cleanContent}
     }
 
     if (messages.length > 0) {
-      console.log(JSON.stringify({ continue: true, message: messages.join('\n') }));
+      console.log(JSON.stringify({
+        continue: true,
+        hookSpecificOutput: {
+          hookEventName: 'SessionStart',
+          additionalContext: messages.join('\n')
+        }
+      }));
     } else {
       console.log(JSON.stringify({ continue: true }));
     }

package/scripts/skill-injector.mjs

@@ -268,7 +268,10 @@ async function main() {
     if (matchingSkills.length > 0) {
       console.log(JSON.stringify({
         continue: true,
-        message: formatSkillsMessage(matchingSkills)
+        hookSpecificOutput: {
+          hookEventName: 'UserPromptSubmit',
+          additionalContext: formatSkillsMessage(matchingSkills)
+        }
       }));
     } else {
       console.log(JSON.stringify({ continue: true }));