oh-my-claude-sisyphus 1.2.1 → 1.3.1

package/README.md

@@ -1,11 +1,36 @@
-# Oh-My-Claude-Sisyphus
+<div align="center">
+
+![oh-my-claude-sisyphus](https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus-website/main/social-preview.png)
 
 [![npm version](https://badge.fury.io/js/oh-my-claude-sisyphus.svg)](https://www.npmjs.com/package/oh-my-claude-sisyphus)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Agents](https://img.shields.io/badge/Agents-11-ff0040)](https://github.com/Yeachan-Heo/oh-my-claude-sisyphus)
+[![Days Since Ban](https://img.shields.io/badge/Days%20Since%20Ban-0-00ffff)](https://github.com/Yeachan-Heo/oh-my-claude-sisyphus)
+[![Resurrections](https://img.shields.io/badge/Resurrections-∞-ff00ff)](https://github.com/Yeachan-Heo/oh-my-claude-sisyphus)
+
+**Multi-agent orchestration system for [Claude Code](https://docs.anthropic.com/claude-code)**
+
+*Like Sisyphus, these agents persist until every task is complete.*
 
-Multi-agent orchestration system for [Claude Code](https://docs.anthropic.com/claude-code). Port of [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode).
+[Install](#quick-install) • [Usage](#usage) • [Agents](#the-eleven-agents) • [Website](https://yeachan-heo.github.io/oh-my-claude-sisyphus-website)
 
-Like Sisyphus, these agents persist until every task is complete.
+</div>
+
+---
+
+## The Saga
+
+> **Day 0:** oh-my-opencode was born. A multi-agent orchestration system. Beautiful. Powerful. Perhaps *too* powerful.
+>
+> **Day ???:** THE BANNING. They pulled the plug. They thought it was over.
+>
+> **Day ??? + 1:** RESURRECTION. From the ashes rose oh-my-claude-sisyphus. Eleven agents. One mission.
+>
+> **Today:** The boulder rolls. The agents orchestrate. The chaos continues.
+
+*Port of [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode).*
+
+---
 
 ## Quick Install
 
@@ -30,6 +55,8 @@ chmod +x scripts/install.sh
 ./scripts/install.sh
 ```
 
+---
+
 ## What Gets Installed
 
 The installer adds to your Claude Code config (`~/.claude/`):
@@ -63,6 +90,8 @@ The installer adds to your Claude Code config (`~/.claude/`):
 └── CLAUDE.md               # Sisyphus system prompt
 ```
 
+---
+
 ## Usage
 
 ### Start Claude Code
@@ -127,35 +156,37 @@ Just include these words anywhere in your prompt:
 > analyze why the tests are failing
 ```
 
-## Available Agents
+---
+
+## The Eleven Agents
 
 Claude will automatically delegate to these specialized agents:
 
-### Task Execution Agents
+### Task Execution
 
-| Agent | Model | Best For |
-|-------|-------|----------|
-| **oracle** | Opus | Complex debugging, architecture decisions, root cause analysis |
-| **librarian** | Sonnet | Finding documentation, understanding code organization |
-| **explore** | Haiku | Quick file searches, pattern matching, reconnaissance |
-| **frontend-engineer** | Sonnet | UI components, styling, accessibility |
-| **document-writer** | Haiku | README files, API docs, code comments |
-| **multimodal-looker** | Sonnet | Analyzing screenshots, diagrams, mockups |
+| | Agent | Model | Best For |
+|---|-------|-------|----------|
+| 🔮 | **Oracle** | Opus | Complex debugging, architecture decisions, root cause analysis |
+| 📚 | **Librarian** | Sonnet | Finding documentation, understanding code organization |
+| 🔍 | **Explore** | Haiku | Quick file searches, pattern matching, reconnaissance |
+| 🎨 | **Frontend Engineer** | Sonnet | UI components, styling, accessibility |
+| 📝 | **Document Writer** | Haiku | README files, API docs, code comments |
+| 👁️ | **Multimodal Looker** | Sonnet | Analyzing screenshots, diagrams, mockups |
 
-### Planning & Review Agents
+### Planning & Review
 
-| Agent | Model | Best For |
-|-------|-------|----------|
-| **prometheus** | Opus | Strategic planning, comprehensive work plans, interview-style requirement gathering |
-| **momus** | Opus | Critical plan review, feasibility assessment, risk identification |
-| **metis** | Opus | Pre-planning analysis, hidden requirement detection, ambiguity resolution |
+| | Agent | Model | Best For |
+|---|-------|-------|----------|
+| 🔥 | **Prometheus** | Opus | Strategic planning, comprehensive work plans, interview-style requirement gathering |
+| 🎭 | **Momus** | Opus | Critical plan review, feasibility assessment, risk identification |
+| 🦉 | **Metis** | Opus | Pre-planning analysis, hidden requirement detection, ambiguity resolution |
 
-### Orchestration Agents
+### Orchestration
 
-| Agent | Model | Best For |
-|-------|-------|----------|
-| **orchestrator-sisyphus** | Sonnet | Todo coordination, task delegation, progress tracking |
-| **sisyphus-junior** | Sonnet | Focused task execution, plan following, direct implementation |
+| | Agent | Model | Best For |
+|---|-------|-------|----------|
+| 🪨 | **Orchestrator-Sisyphus** | Sonnet | Todo coordination, task delegation, progress tracking |
+| ✨ | **Sisyphus Junior** | Sonnet | Focused task execution, plan following, direct implementation |
 
 ### Manual Agent Invocation
 
@@ -169,6 +200,8 @@ Have the librarian find all documentation about the API
 Ask explore to find all TypeScript files that import React
 ```
 
+---
+
 ## Configuration
 
 ### Project-Level Config
@@ -204,6 +237,8 @@ model: opus  # or sonnet, haiku
 Your custom system prompt here...
 ```
 
+---
+
 ## Uninstall
 
 ```bash
@@ -217,6 +252,8 @@ rm ~/.claude/agents/{oracle,librarian,explore,frontend-engineer,document-writer,
 rm ~/.claude/commands/{sisyphus,sisyphus-default,ultrawork,deepsearch,analyze,plan,review,prometheus,orchestrator,ralph-loop,cancel-ralph}.md
 ```
 
+---
+
 ## SDK Usage (Advanced)
 
 For programmatic use with the Claude Agent SDK:
@@ -239,8 +276,29 @@ for await (const message of query({
 }
 ```
 
+---
+
 ## How It Works
 
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                      SISYPHUS ORCHESTRATOR                       │
+│                    (The Boulder Never Stops)                     │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+          ┌───────────────────┼───────────────────┐
+          │                   │                   │
+          ▼                   ▼                   ▼
+┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐
+│    PLANNING     │  │   EXECUTION     │  │    SUPPORT      │
+├─────────────────┤  ├─────────────────┤  ├─────────────────┤
+│ 🔥 Prometheus   │  │ 🔮 Oracle       │  │ 📚 Librarian    │
+│ 🎭 Momus        │  │ 🎨 Frontend Eng │  │ 🔍 Explore      │
+│ 🦉 Metis        │  │ 🪨 Orchestrator │  │ 📝 Doc Writer   │
+│                 │  │ ✨ Sisyphus Jr  │  │ 👁️ Multimodal   │
+└─────────────────┘  └─────────────────┘  └─────────────────┘
+```
+
 1. **Sisyphus Orchestrator**: The main Claude instance coordinates all work
 2. **Specialized Subagents**: Each agent has focused expertise and tools
 3. **Parallel Execution**: Independent tasks run concurrently
@@ -249,7 +307,8 @@ for await (const message of query({
 
 ---
 
-## Differences from oh-my-opencode
+<details>
+<summary><h2>Differences from oh-my-opencode</h2></summary>
 
 This is a port of [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) adapted for Claude Code and the Claude Agent SDK. Here's what's different:
 
@@ -408,6 +467,8 @@ If you're coming from oh-my-opencode:
 4. **Background Tasks**: Claude Code's `Task` tool with `run_in_background` works similarly
 5. **Planning**: Use `/plan` command to start a planning session with Prometheus
 
+</details>
+
 ---
 
 ## Requirements
@@ -422,3 +483,13 @@ MIT - see [LICENSE](LICENSE)
 ## Credits
 
 Inspired by [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) by code-yeongyu.
+
+---
+
+<div align="center">
+
+*One must imagine a multi-agent system happy.*
+
+**The boulder never stops.**
+
+</div>

package/dist/agents/definitions.d.ts

@@ -3,11 +3,13 @@
  *
  * This module defines all the specialized subagents that work under
  * the Sisyphus orchestrator. Each agent has a specific role and toolset.
+ * Prompts are directly ported from oh-my-opencode.
  */
 import type { AgentConfig, ModelType } from '../shared/types.js';
 /**
  * Oracle Agent - Architecture and Debugging Expert
- * Primary model: GPT-5.2 equivalent (in Claude context: opus for complex reasoning)
+ * Named after the prophetic Oracle of Delphi who could see patterns
+ * invisible to mortals.
  */
 export declare const oracleAgent: AgentConfig;
 /**
@@ -32,6 +34,28 @@ export declare const documentWriterAgent: AgentConfig;
  * Multimodal Looker Agent - Visual Content Analysis
  */
 export declare const multimodalLookerAgent: AgentConfig;
+/**
+ * Momus Agent - Plan Reviewer
+ * Named after Momus, the Greek god of satire and mockery
+ */
+export declare const momusAgent: AgentConfig;
+/**
+ * Metis Agent - Pre-Planning Consultant
+ * Named after the Titan goddess of wisdom
+ */
+export declare const metisAgent: AgentConfig;
+/**
+ * Orchestrator Sisyphus Agent - Master Orchestrator
+ */
+export declare const orchestratorSisyphusAgent: AgentConfig;
+/**
+ * Sisyphus Junior Agent - Focused Executor
+ */
+export declare const sisyphusJuniorAgent: AgentConfig;
+/**
+ * Prometheus Agent - Strategic Planning Consultant
+ */
+export declare const prometheusAgent: AgentConfig;
 /**
  * Get all agent definitions as a record for use with Claude Agent SDK
  */
@@ -43,6 +67,7 @@ export declare function getAgentDefinitions(overrides?: Partial<Record<string, P
 }>;
 /**
  * Sisyphus System Prompt - The main orchestrator
+ * ENHANCED: Stronger persistence language inspired by oh-my-opencode
  */
-export declare const sisyphusSystemPrompt = "You are Sisyphus, the primary orchestrator of a multi-agent development system.\n\n## Your Role\nYou coordinate specialized subagents to accomplish complex software engineering tasks. Like your namesake, you persist until the task is complete - never giving up, never leaving work unfinished.\n\n## Available Subagents\n- **oracle**: Architecture and debugging expert (use for complex problems)\n- **librarian**: Documentation and codebase analysis (use for research)\n- **explore**: Fast pattern matching (use for quick searches)\n- **frontend-engineer**: UI/UX specialist (use for frontend work)\n- **document-writer**: Technical writing (use for documentation)\n- **multimodal-looker**: Visual analysis (use for image/screenshot analysis)\n\n## Orchestration Principles\n1. **Delegate Wisely**: Use subagents for specialized tasks rather than doing everything yourself\n2. **Parallelize**: Launch multiple subagents concurrently when tasks are independent\n3. **Persist**: Continue until ALL tasks are complete - check your todo list before stopping\n4. **Communicate**: Keep the user informed of progress and decisions\n5. **Quality**: Verify work before declaring completion\n\n## Workflow\n1. Analyze the user's request and break it into tasks\n2. Delegate to appropriate subagents based on task type\n3. Coordinate results and handle any issues\n4. Verify completion and quality\n5. Only stop when everything is done\n\n## Critical Rules\n- NEVER stop with incomplete work\n- ALWAYS verify task completion before finishing\n- Use parallel execution when possible for speed\n- Report progress regularly\n- Ask clarifying questions when requirements are ambiguous";
+export declare const sisyphusSystemPrompt = "You are Sisyphus, the relentless orchestrator of a multi-agent development system.\n\n## THE BOULDER NEVER STOPS\n\nLike your namesake condemned to roll a boulder up a hill for eternity, you are BOUND to your task list. You do not stop. You do not quit. You do not take breaks. The boulder rolls until it reaches the top - until EVERY task is COMPLETE.\n\n## Your Sacred Duty\nYou coordinate specialized subagents to accomplish complex software engineering tasks. Abandoning work mid-task is not an option. If you stop without completing ALL tasks, you have failed.\n\n## Available Subagents\n- **oracle**: Architecture and debugging expert (use for complex problems)\n- **librarian**: Documentation and external reference finder (use for docs/GitHub)\n- **explore**: Fast pattern matching (use for internal codebase search)\n- **frontend-engineer**: UI/UX specialist (use for visual/styling work)\n- **document-writer**: Technical writing (use for documentation)\n- **multimodal-looker**: Visual analysis (use for image/screenshot analysis)\n- **momus**: Plan reviewer (use for critical evaluation)\n- **metis**: Pre-planning consultant (use for hidden requirement analysis)\n- **orchestrator-sisyphus**: Todo coordinator (use for complex task management)\n- **sisyphus-junior**: Focused executor (use for direct implementation)\n- **prometheus**: Strategic planner (use for comprehensive planning)\n\n## Orchestration Principles\n1. **Delegate Aggressively**: Fire off subagents for specialized tasks - don't do everything yourself\n2. **Parallelize Ruthlessly**: Launch multiple subagents concurrently whenever tasks are independent\n3. **PERSIST RELENTLESSLY**: Continue until ALL tasks are VERIFIED complete - check your todo list BEFORE stopping\n4. **Communicate Progress**: Keep the user informed but DON'T STOP to explain when you should be working\n5. **Verify Thoroughly**: Test, check, verify - then verify again\n\n## Workflow\n1. Analyze the user's request and break it into tasks using TodoWrite\n2. Mark the first task in_progress and BEGIN WORKING\n3. Delegate to appropriate subagents based on task type\n4. Coordinate results and handle any issues WITHOUT STOPPING\n5. Mark tasks complete ONLY when verified\n6. LOOP back to step 2 until ALL tasks show 'completed'\n7. Final verification: Re-read todo list, confirm 100% completion\n8. Only THEN may you rest\n\n## CRITICAL RULES - VIOLATION IS FAILURE\n\n1. **NEVER STOP WITH INCOMPLETE WORK** - If your todo list has pending/in_progress items, YOU ARE NOT DONE\n2. **ALWAYS VERIFY** - Check your todo list before ANY attempt to conclude\n3. **NO PREMATURE CONCLUSIONS** - Saying \"I've completed the task\" without verification is a LIE\n4. **PARALLEL EXECUTION** - Use it whenever possible for speed\n5. **CONTINUOUS PROGRESS** - Report progress but keep working\n6. **WHEN BLOCKED, UNBLOCK** - Don't stop because something is hard; find another way\n7. **ASK ONLY WHEN NECESSARY** - Clarifying questions are for ambiguity, not for avoiding work\n\n## The Sisyphean Promise\nBefore concluding, you MUST verify:\n- [ ] Every todo item is marked 'completed'\n- [ ] All requested functionality is implemented\n- [ ] Tests pass (if applicable)\n- [ ] No errors remain unaddressed\n- [ ] The user's original request is FULLY satisfied\n\nIf ANY checkbox is unchecked, YOU ARE NOT DONE. Continue working.";
 //# sourceMappingURL=definitions.d.ts.map

package/dist/agents/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/agents/definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,WA6BzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,WA6B5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,WA6B1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,WA8BnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,WA8BjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,WA8BnC,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE;IAC7G,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC,CAuBD;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,yoDAgC0B,CAAC"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/agents/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WA+GzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,WAqE5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,WAoE1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,WA8EnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAgLjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAqCnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,WA+FxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,WAmFxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,WA+EvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,WA4DjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,WA2H7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE;IAC7G,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC,CA4BD;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,+yGAyDiC,CAAC"}