oh-my-claude-sisyphus 3.5.5 → 3.5.7

package/docs/MIGRATION.md

@@ -131,7 +131,7 @@ The package has been renamed to better reflect its purpose and improve discovera
 npm install -g oh-my-claude-sisyphus
 
 # New
-npm install -g oh-my-claudecode
+npm install -g oh-my-claude-sisyphus
 ```
 
 ### What Changed
@@ -302,7 +302,7 @@ npm uninstall -g oh-my-claude-sisyphus
 #### 2. Install New Package
 
 ```bash
-npm install -g oh-my-claudecode
+npm install -g oh-my-claude-sisyphus
 ```
 
 #### 3. Rename Local Project Directories
@@ -363,7 +363,7 @@ After migration, verify your setup:
 
 1. **Check installation**:
    ```bash
-   npm list -g oh-my-claudecode
+   npm list -g oh-my-claude-sisyphus
    ```
 
 2. **Verify directories exist**:
@@ -763,7 +763,7 @@ After upgrading, verify new features:
 
 1. **Check installation**:
    ```bash
-   npm list -g oh-my-claudecode
+   npm list -g oh-my-claude-sisyphus
    ```
 
 2. **Test ultrapilot**:

package/docs/REFERENCE.md

@@ -0,0 +1,545 @@
+# Reference Documentation
+
+Complete reference for oh-my-claudecode. For quick start, see the main [README.md](../README.md).
+
+---
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Configuration](#configuration)
+- [Agents (32 Total)](#agents-32-total)
+- [Skills (35 Total)](#skills-35-total)
+- [Slash Commands](#slash-commands)
+- [Hooks System](#hooks-system)
+- [Magic Keywords](#magic-keywords)
+- [Platform Support](#platform-support)
+- [Troubleshooting](#troubleshooting)
+- [Changelog](#changelog)
+
+---
+
+## Installation
+
+Choose **ONE** installation method. Do not mix methods.
+
+### Option A: Claude Code Plugin (Recommended)
+
+```bash
+# From terminal:
+claude plugin install oh-my-claude-sisyphus
+
+# Or from within Claude Code:
+/oh-my-claudecode:plugin oh-my-claude-sisyphus
+```
+
+Uses Node.js hooks from the plugin directory. Integrates directly with Claude Code's plugin system.
+
+### Option B: Via npm (Windows & Cross-Platform)
+
+```bash
+npm install -g oh-my-claude-sisyphus
+```
+
+> **Windows Users**: This is the recommended installation method. Requires Node.js 20+.
+
+### Option C: Curl One-Liner (Deprecated)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/scripts/install.sh | bash
+```
+
+> **Deprecated**: This method installs bash hooks to `~/.claude/` which can conflict with plugin installations. Use the plugin method above instead.
+
+### Manual Install (macOS/Linux)
+
+```bash
+git clone https://github.com/Yeachan-Heo/oh-my-claude-sisyphus.git
+cd oh-my-claude-sisyphus
+chmod +x scripts/install.sh
+./scripts/install.sh
+```
+
+### Requirements
+
+- [Claude Code](https://docs.anthropic.com/claude-code) installed
+- One of:
+  - **Claude Max/Pro subscription** (recommended for individuals)
+  - **Anthropic API key** (`ANTHROPIC_API_KEY` environment variable)
+- **Windows**: Node.js 20+ (for npm installation)
+- **macOS/Linux**: Bash shell (default) or Node.js 20+ (optional)
+
+---
+
+## Configuration
+
+### Project-Scoped Configuration (Recommended)
+
+Configure omc for the current project only:
+
+```
+/oh-my-claudecode:omc-setup
+```
+
+- Creates `./.claude/CLAUDE.md` in your current project
+- Configuration applies only to this project
+- Won't affect other projects or global settings
+- **Safe**: Preserves your global CLAUDE.md
+
+### Global Configuration
+
+Configure omc for all Claude Code sessions:
+
+```
+/oh-my-claudecode:omc-setup
+```
+
+- Creates `~/.claude/CLAUDE.md` globally
+- Configuration applies to all projects
+- **Warning**: Completely overwrites existing `~/.claude/CLAUDE.md`
+
+### What Configuration Enables
+
+| Feature | Without | With omc Config |
+|---------|---------|-----------------|
+| Agent delegation | Manual only | Automatic based on task |
+| Keyword detection | Disabled | ultrawork, search, analyze |
+| Todo continuation | Basic | Enforced completion |
+| Model routing | Default | Smart tier selection |
+| Skill composition | None | Auto-combines skills |
+
+### Configuration Precedence
+
+If both configurations exist, **project-scoped takes precedence** over global:
+
+```
+./.claude/CLAUDE.md  (project)   →  Overrides  →  ~/.claude/CLAUDE.md  (global)
+```
+
+### When to Re-run Setup
+
+- **First time**: Run after installation (choose project or global)
+- **After updates**: Re-run to get the latest configuration
+- **Different machines**: Run on each machine where you use Claude Code
+- **New projects**: Run `/oh-my-claudecode:omc-setup --local` in each project that needs omc
+
+> **NOTE**: After updating the plugin (via `npm update`, `git pull`, or Claude Code's plugin update), you MUST re-run `/oh-my-claudecode:omc-setup` to apply the latest CLAUDE.md changes.
+
+### Agent Customization
+
+Edit agent files in `~/.claude/agents/` to customize behavior:
+
+```yaml
+---
+name: architect
+description: Your custom description
+tools: Read, Grep, Glob, Bash, Edit
+model: opus  # or sonnet, haiku
+---
+
+Your custom system prompt here...
+```
+
+### Project-Level Config
+
+Create `.claude/CLAUDE.md` in your project for project-specific instructions:
+
+```markdown
+# Project Context
+
+This is a TypeScript monorepo using:
+- Bun runtime
+- React for frontend
+- PostgreSQL database
+
+## Conventions
+- Use functional components
+- All API routes in /src/api
+- Tests alongside source files
+```
+
+---
+
+## Agents (32 Total)
+
+Always use `oh-my-claudecode:` prefix when calling via Task tool.
+
+### By Domain and Tier
+
+| Domain | LOW (Haiku) | MEDIUM (Sonnet) | HIGH (Opus) |
+|--------|-------------|-----------------|-------------|
+| **Analysis** | `architect-low` | `architect-medium` | `architect` |
+| **Execution** | `executor-low` | `executor` | `executor-high` |
+| **Search** | `explore` | `explore-medium` | `explore-high` |
+| **Research** | `researcher-low` | `researcher` | - |
+| **Frontend** | `designer-low` | `designer` | `designer-high` |
+| **Docs** | `writer` | - | - |
+| **Visual** | - | `vision` | - |
+| **Planning** | - | - | `planner` |
+| **Critique** | - | - | `critic` |
+| **Pre-Planning** | - | - | `analyst` |
+| **Testing** | - | `qa-tester` | `qa-tester-high` |
+| **Security** | `security-reviewer-low` | - | `security-reviewer` |
+| **Build** | `build-fixer-low` | `build-fixer` | - |
+| **TDD** | `tdd-guide-low` | `tdd-guide` | - |
+| **Code Review** | `code-reviewer-low` | - | `code-reviewer` |
+| **Data Science** | `scientist-low` | `scientist` | `scientist-high` |
+
+### Agent Selection Guide
+
+| Task Type | Best Agent | Model |
+|-----------|------------|-------|
+| Quick code lookup | `explore` | haiku |
+| Find files/patterns | `explore` or `explore-medium` | haiku/sonnet |
+| Complex architectural search | `explore-high` | opus |
+| Simple code change | `executor-low` | haiku |
+| Feature implementation | `executor` | sonnet |
+| Complex refactoring | `executor-high` | opus |
+| Debug simple issue | `architect-low` | haiku |
+| Debug complex issue | `architect` | opus |
+| UI component | `designer` | sonnet |
+| Complex UI system | `designer-high` | opus |
+| Write docs/comments | `writer` | haiku |
+| Research docs/APIs | `researcher` | sonnet |
+| Analyze images/diagrams | `vision` | sonnet |
+| Strategic planning | `planner` | opus |
+| Review/critique plan | `critic` | opus |
+| Pre-planning analysis | `analyst` | opus |
+| Test CLI interactively | `qa-tester` | sonnet |
+| Security review | `security-reviewer` | opus |
+| Quick security scan | `security-reviewer-low` | haiku |
+| Fix build errors | `build-fixer` | sonnet |
+| Simple build fix | `build-fixer-low` | haiku |
+| TDD workflow | `tdd-guide` | sonnet |
+| Quick test suggestions | `tdd-guide-low` | haiku |
+| Code review | `code-reviewer` | opus |
+| Quick code check | `code-reviewer-low` | haiku |
+| Data analysis/stats | `scientist` | sonnet |
+| Quick data inspection | `scientist-low` | haiku |
+| Complex ML/hypothesis | `scientist-high` | opus |
+
+---
+
+## Skills (35 Total)
+
+### Core Skills
+
+| Skill | Description | Manual Command |
+|-------|-------------|----------------|
+| `orchestrate` | Multi-agent orchestration mode | - |
+| `autopilot` | Full autonomous execution from idea to working code | `/oh-my-claudecode:autopilot` |
+| `ultrawork` | Maximum performance with parallel agents | `/oh-my-claudecode:ultrawork` |
+| `ultrapilot` | Parallel autopilot with 3-5x speedup | `/oh-my-claudecode:ultrapilot` |
+| `swarm` | N coordinated agents with task claiming | `/oh-my-claudecode:swarm` |
+| `pipeline` | Sequential agent chaining | `/oh-my-claudecode:pipeline` |
+| `ecomode` | Token-efficient parallel execution | `/oh-my-claudecode:ecomode` |
+| `ralph` | Self-referential development until completion | `/oh-my-claudecode:ralph` |
+| `ralph-init` | Initialize PRD for structured task tracking | `/oh-my-claudecode:ralph-init` |
+| `ultraqa` | Autonomous QA cycling workflow | `/oh-my-claudecode:ultraqa` |
+| `plan` | Start planning session | `/oh-my-claudecode:plan` |
+| `ralplan` | Iterative planning (Planner+Architect+Critic) | `/oh-my-claudecode:ralplan` |
+| `review` | Review work plans with critic | `/oh-my-claudecode:review` |
+
+### Enhancement Skills
+
+| Skill | Description | Manual Command |
+|-------|-------------|----------------|
+| `deepinit` | Hierarchical AGENTS.md codebase documentation | `/oh-my-claudecode:deepinit` |
+| `deepsearch` | Thorough multi-strategy codebase search | `/oh-my-claudecode:deepsearch` |
+| `analyze` | Deep analysis and investigation | `/oh-my-claudecode:analyze` |
+| `research` | Parallel scientist orchestration | `/oh-my-claudecode:research` |
+| `frontend-ui-ux` | Designer-turned-developer UI/UX expertise | (silent activation) |
+| `git-master` | Git expert for atomic commits and history | (silent activation) |
+| `tdd` | TDD enforcement: test-first development | `/oh-my-claudecode:tdd` |
+| `learner` | Extract reusable skill from session | `/oh-my-claudecode:learner` |
+
+### Utility Skills
+
+| Skill | Description | Manual Command |
+|-------|-------------|----------------|
+| `note` | Save notes to compaction-resilient notepad | `/oh-my-claudecode:note` |
+| `cancel` | Unified cancellation for all modes | `/oh-my-claudecode:cancel` |
+| `omc-setup` | One-time setup wizard | `/oh-my-claudecode:omc-setup` |
+| `doctor` | Diagnose and fix installation issues | `/oh-my-claudecode:doctor` |
+| `help` | Show OMC usage guide | `/oh-my-claudecode:help` |
+| `hud` | Configure HUD statusline | `/oh-my-claudecode:hud` |
+| `release` | Automated release workflow | `/oh-my-claudecode:release` |
+| `mcp-setup` | Configure MCP servers | `/oh-my-claudecode:mcp-setup` |
+| `learn-about-omc` | Usage pattern analysis | `/oh-my-claudecode:learn-about-omc` |
+
+---
+
+## Slash Commands
+
+All skills are available as slash commands with the prefix `/oh-my-claudecode:`.
+
+| Command | Description |
+|---------|-------------|
+| `/oh-my-claudecode:orchestrate <task>` | Activate multi-agent orchestration mode |
+| `/oh-my-claudecode:autopilot <task>` | Full autonomous execution |
+| `/oh-my-claudecode:ultrawork <task>` | Maximum performance mode with parallel agents |
+| `/oh-my-claudecode:ultrapilot <task>` | Parallel autopilot (3-5x faster) |
+| `/oh-my-claudecode:swarm <N>:<agent> <task>` | Coordinated agent swarm |
+| `/oh-my-claudecode:pipeline <stages>` | Sequential agent chaining |
+| `/oh-my-claudecode:ecomode <task>` | Token-efficient parallel execution |
+| `/oh-my-claudecode:ralph-init <task>` | Initialize PRD for structured task tracking |
+| `/oh-my-claudecode:ralph <task>` | Self-referential loop until task completion |
+| `/oh-my-claudecode:ultraqa <goal>` | Autonomous QA cycling workflow |
+| `/oh-my-claudecode:plan <description>` | Start planning session |
+| `/oh-my-claudecode:ralplan <description>` | Iterative planning with consensus |
+| `/oh-my-claudecode:review [plan-path]` | Review a plan with critic |
+| `/oh-my-claudecode:deepsearch <query>` | Thorough multi-strategy codebase search |
+| `/oh-my-claudecode:deepinit [path]` | Index codebase with hierarchical AGENTS.md files |
+| `/oh-my-claudecode:analyze <target>` | Deep analysis and investigation |
+| `/oh-my-claudecode:research <topic>` | Parallel research orchestration |
+| `/oh-my-claudecode:tdd <feature>` | TDD workflow enforcement |
+| `/oh-my-claudecode:learner` | Extract reusable skill from session |
+| `/oh-my-claudecode:note <content>` | Save notes to notepad.md |
+| `/oh-my-claudecode:cancel` | Unified cancellation |
+| `/oh-my-claudecode:omc-setup` | One-time setup wizard |
+| `/oh-my-claudecode:doctor` | Diagnose and fix installation issues |
+| `/oh-my-claudecode:help` | Show OMC usage guide |
+| `/oh-my-claudecode:hud` | Configure HUD statusline |
+| `/oh-my-claudecode:release` | Automated release workflow |
+| `/oh-my-claudecode:mcp-setup` | Configure MCP servers |
+
+---
+
+## Hooks System
+
+Oh-my-claudecode includes 19 lifecycle hooks that enhance Claude Code's behavior.
+
+### Core Hooks
+
+| Hook | Description |
+|------|-------------|
+| `rules-injector` | Dynamic rules injection with YAML frontmatter parsing |
+| `omc-orchestrator` | Enforces orchestrator behavior and delegation |
+| `auto-slash-command` | Automatic slash command detection and execution |
+| `keyword-detector` | Magic keyword detection (ultrawork, search, analyze) |
+| `ralph-loop` | Self-referential development loop management |
+| `todo-continuation` | Ensures todo list completion |
+| `notepad` | Compaction-resilient memory system with three-tier storage |
+
+### Context & Recovery
+
+| Hook | Description |
+|------|-------------|
+| `context-window-limit-recovery` | Token limit error handling and recovery |
+| `preemptive-compaction` | Context usage monitoring to prevent limits |
+| `session-recovery` | Session state recovery on crashes |
+| `directory-readme-injector` | README context injection |
+
+### Quality & Validation
+
+| Hook | Description |
+|------|-------------|
+| `comment-checker` | BDD detection and directive filtering |
+| `thinking-block-validator` | Extended thinking validation |
+| `empty-message-sanitizer` | Empty message handling |
+| `edit-error-recovery` | Automatic recovery from edit errors |
+| `post-tool-use` | Remember tag auto-capture to notepad system |
+
+### Environment & Notifications
+
+| Hook | Description |
+|------|-------------|
+| `non-interactive-env` | CI/non-interactive environment handling |
+| `agent-usage-reminder` | Reminder to use specialized agents |
+| `background-notification` | Background task completion notifications |
+
+---
+
+## Magic Keywords
+
+Just include these words anywhere in your prompt to activate enhanced modes:
+
+| Keyword | Effect |
+|---------|--------|
+| `ultrawork`, `ulw`, `uw` | Activates parallel agent orchestration |
+| `ecomode`, `eco`, `efficient`, `save-tokens`, `budget` | Token-efficient parallel execution |
+| `autopilot`, `build me`, `I want a` | Full autonomous execution |
+| `ultrapilot`, `parallel build`, `swarm build` | Parallel autopilot (3-5x faster) |
+| `ralph`, `don't stop`, `must complete` | Persistence until verified complete |
+| `plan this`, `plan the` | Planning interview workflow |
+| `ralplan` | Iterative planning consensus |
+| `search`, `find`, `locate` | Enhanced search mode |
+| `analyze`, `investigate`, `debug` | Deep analysis mode |
+| `research`, `analyze data`, `statistics` | Parallel research orchestration |
+| `tdd`, `test first`, `red green` | TDD workflow enforcement |
+| `swarm N agents` | Coordinated agent swarm |
+| `pipeline`, `chain agents` | Sequential agent chaining |
+| `stop`, `cancel`, `abort` | Unified cancellation |
+
+### Examples
+
+```bash
+# In Claude Code:
+
+# Maximum parallelism
+ultrawork implement user authentication with OAuth
+
+# Token-efficient parallelism
+eco fix all TypeScript errors
+
+# Enhanced search
+find all files that import the utils module
+
+# Deep analysis
+analyze why the tests are failing
+
+# Autonomous execution
+autopilot: build a todo app with React
+
+# Parallel autopilot
+ultrapilot: build a fullstack todo app
+
+# Persistence mode
+ralph: refactor the authentication module
+
+# Planning session
+plan this feature
+
+# TDD workflow
+tdd: implement password validation
+
+# Coordinated swarm
+swarm 5 agents: fix all lint errors
+
+# Agent chaining
+pipeline: analyze → fix → test this bug
+```
+
+---
+
+## Platform Support
+
+### Operating Systems
+
+| Platform | Install Method | Hook Type |
+|----------|---------------|-----------|
+| **Windows** | `npm install -g` | Node.js (.mjs) |
+| **macOS** | curl or npm | Bash (.sh) |
+| **Linux** | curl or npm | Bash (.sh) |
+
+> **Note**: Bash hooks are fully portable across macOS and Linux (no GNU-specific dependencies).
+
+> **Advanced**: Set `OMC_USE_NODE_HOOKS=1` to use Node.js hooks on macOS/Linux.
+
+### Available Tools
+
+| Tool | Status | Description |
+|------|--------|-------------|
+| **Read** | ✅ Available | Read files |
+| **Write** | ✅ Available | Create files |
+| **Edit** | ✅ Available | Modify files |
+| **Bash** | ✅ Available | Run shell commands |
+| **Glob** | ✅ Available | Find files by pattern |
+| **Grep** | ✅ Available | Search file contents |
+| **WebSearch** | ✅ Available | Search the web |
+| **WebFetch** | ✅ Available | Fetch web pages |
+| **Task** | ✅ Available | Spawn subagents |
+| **TodoWrite** | ✅ Available | Track tasks |
+
+### LSP Tools (Real Implementation)
+
+| Tool | Status | Description |
+|------|--------|-------------|
+| `lsp_hover` | ✅ Implemented | Get type info and documentation at position |
+| `lsp_goto_definition` | ✅ Implemented | Jump to symbol definition |
+| `lsp_find_references` | ✅ Implemented | Find all usages of a symbol |
+| `lsp_document_symbols` | ✅ Implemented | Get file outline (functions, classes, etc.) |
+| `lsp_workspace_symbols` | ✅ Implemented | Search symbols across workspace |
+| `lsp_diagnostics` | ✅ Implemented | Get errors, warnings, hints |
+| `lsp_prepare_rename` | ✅ Implemented | Check if rename is valid |
+| `lsp_rename` | ✅ Implemented | Rename symbol across project |
+| `lsp_code_actions` | ✅ Implemented | Get available refactorings |
+| `lsp_code_action_resolve` | ✅ Implemented | Get details of a code action |
+| `lsp_servers` | ✅ Implemented | List available language servers |
+| `lsp_diagnostics_directory` | ✅ Implemented | Project-level type checking |
+
+> **Note**: LSP tools require language servers to be installed (typescript-language-server, pylsp, rust-analyzer, gopls, etc.). Use `lsp_servers` to check installation status.
+
+### AST Tools (ast-grep Integration)
+
+| Tool | Status | Description |
+|------|--------|-------------|
+| `ast_grep_search` | ✅ Implemented | Pattern-based code search using AST matching |
+| `ast_grep_replace` | ✅ Implemented | Pattern-based code transformation |
+
+> **Note**: AST tools use [@ast-grep/napi](https://ast-grep.github.io/) for structural code matching. Supports meta-variables like `$VAR` (single node) and `$$$` (multiple nodes).
+
+---
+
+## Troubleshooting
+
+### Diagnose Installation Issues
+
+```bash
+/oh-my-claudecode:doctor
+```
+
+Checks for:
+- Missing dependencies
+- Configuration errors
+- Hook installation status
+- Agent availability
+- Skill registration
+
+### Configure HUD Statusline
+
+```bash
+/oh-my-claudecode:hud setup
+```
+
+Installs or repairs the HUD statusline for real-time status updates.
+
+### Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| Commands not found | Re-run `/oh-my-claudecode:omc-setup` |
+| Hooks not executing | Check hook permissions: `chmod +x ~/.claude/hooks/**/*.sh` |
+| Agents not delegating | Verify CLAUDE.md is loaded: check `./.claude/CLAUDE.md` or `~/.claude/CLAUDE.md` |
+| LSP tools not working | Install language servers: `npm install -g typescript-language-server` |
+| Token limit errors | Use `/oh-my-claudecode:ecomode` for token-efficient execution |
+
+### Auto-Update
+
+Oh-my-claudecode includes a silent auto-update system that checks for updates in the background.
+
+Features:
+- **Rate-limited**: Checks at most once every 24 hours
+- **Concurrent-safe**: Lock file prevents simultaneous update attempts
+- **Cross-platform**: Works on both macOS and Linux
+
+To manually update, re-run the plugin install command or use Claude Code's built-in update mechanism.
+
+### Uninstall
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/scripts/uninstall.sh | bash
+```
+
+Or manually:
+
+```bash
+rm ~/.claude/agents/{architect,researcher,explore,designer,writer,vision,critic,analyst,executor,qa-tester}.md
+rm ~/.claude/commands/{analyze,autopilot,deepsearch,plan,review,ultrawork}.md
+```
+
+---
+
+## Changelog
+
+See [CHANGELOG.md](../CHANGELOG.md) for version history and release notes.
+
+---
+
+## License
+
+MIT - see [LICENSE](../LICENSE)
+
+## Credits
+
+Inspired by [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) by code-yeongyu.

package/docs/SYNC-SYSTEM.md

@@ -13,7 +13,7 @@ In a typical project lifecycle:
 1. Developer bumps version in `package.json` to `3.5.0`
 2. Creates a release commit
 3. **Forgets** to update version badge in `README.md` (still shows `3.4.0`)
-4. **Forgets** to update version header in `FULL-README.md`
+4. **Forgets** to update version header in `docs/REFERENCE.md`
 5. **Forgets** to update agent count in `.github/CLAUDE.md` after adding new agents
 6. Users see inconsistent version information across documentation
 7. CI builds look professional but contain stale metadata
@@ -51,7 +51,7 @@ The script syncs these files:
 | File | What Gets Updated |
 |------|-------------------|
 | `README.md` | npm version/download badges |
-| `docs/FULL-README.md` | Version badges, version headers |
+| `docs/REFERENCE.md` | Version badges, version headers |
 | `.github/CLAUDE.md` | Agent count, skill count |
 | `docs/ARCHITECTURE.md` | Version references |
 | `CHANGELOG.md` | Latest version header (verify only) |
@@ -86,7 +86,7 @@ Skills: 45
 ✓ README.md
   - npm version badge
 
-✓ docs/FULL-README.md
+✓ docs/REFERENCE.md
   - Version badge
   - Version header
 
@@ -111,7 +111,7 @@ Shows what **would** change without writing files:
 📝 README.md
   - npm version badge
 
-📝 docs/FULL-README.md
+📝 docs/REFERENCE.md
   - Version badge
 
 📊 2 file(s) would be updated
@@ -131,7 +131,7 @@ Checks if files are in sync. Exits with status code:
 ```
 🔍 Verifying metadata sync...
 ✓ README.md
-✗ docs/FULL-README.md
+✗ docs/REFERENCE.md
   - Version badge needs update
 
 ❌ Files are out of sync!
@@ -454,7 +454,7 @@ Document complex regex:
   // Captures: version number only
   pattern: /\[!\[Version\]\(https:\/\/img\.shields\.io\/badge\/version-([^-]+)-[^)]+\)/g,
   replacement: (m) => `[![Version](https://img.shields.io/badge/version-${m.version}-ff6b6b)]`,
-  description: 'Version badge in FULL-README',
+  description: 'Version badge in REFERENCE.md',
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-claude-sisyphus",
-  "version": "3.5.5",
+  "version": "3.5.7",
   "description": "Multi-agent orchestration system for Claude Code - Inspired by oh-my-opencode",
   "type": "module",
   "main": "dist/index.js",
@@ -48,6 +48,7 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.1.0",
     "@ast-grep/napi": "^0.31.0",
+    "@tokscale/core": "^1.0.25",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "jsonc-parser": "^3.3.1",

package/scripts/sync-metadata.ts

@@ -123,7 +123,7 @@ function getFileSyncConfigs(): FileSync[] {
       ],
     },
     {
-      path: 'docs/FULL-README.md',
+      path: 'docs/REFERENCE.md',
       replacements: [
         {
           pattern: /\[!\[Version\]\(https:\/\/img\.shields\.io\/badge\/version-[^-]+-[^)]+\)/g,
@@ -319,7 +319,7 @@ ${color('Description:', colors.cyan)}
 
 ${color('Files Synced:', colors.cyan)}
   - README.md (npm badges)
-  - docs/FULL-README.md (version badges and headers)
+  - docs/REFERENCE.md (version badges and headers)
   - .github/CLAUDE.md (agent/skill counts)
   - docs/ARCHITECTURE.md (version references)
   - CHANGELOG.md (version header verification)