@happycastle/oh-my-openclaw 0.2.1 → 0.3.0

package/dist/index.js

@@ -11,7 +11,7 @@ import { registerWorkflowCommands } from './commands/workflow-commands.js';
 import { registerRalphCommands } from './commands/ralph-commands.js';
 export default function register(api) {
     const config = getConfig(api);
-    api.logger.info(`[${PLUGIN_ID}] Initializing plugin v0.1.0`);
+    api.logger.info(`[${PLUGIN_ID}] Initializing plugin v0.3.0`);
     try {
         registerTodoEnforcer(api);
         api.logger.info(`[${PLUGIN_ID}] Todo Enforcer hook registered (enabled: ${config.todo_enforcer_enabled})`);
@@ -79,7 +79,7 @@ export default function register(api) {
         return {
             ok: true,
             plugin: PLUGIN_ID,
-            version: '0.1.0',
+            version: '0.3.0',
             hooks: ['todo-enforcer', 'comment-checker', 'message-monitor'],
             services: ['ralph-loop'],
             tools: ['omoc_delegate', 'omoc_look_at', 'omoc_checkpoint'],

package/dist/services/ralph-loop.js

@@ -1,4 +1,5 @@
 import { promises as fs } from 'fs';
+import { getConfig } from '../utils/config.js';
 import { join } from 'path';
 import { ABSOLUTE_MAX_RALPH_ITERATIONS, PLUGIN_ID, } from '../types.js';
 import { readState, writeState } from '../utils/state.js';
@@ -50,7 +51,8 @@ async function saveStateToFile() {
 }
 export function registerRalphLoop(api) {
     apiRef = api;
-    stateFilePath = join(api.config.checkpoint_dir, 'ralph-loop-state.json');
+    const config = getConfig(api);
+    stateFilePath = join(config.checkpoint_dir, 'ralph-loop-state.json');
     api.registerService({
         id: 'omoc-ralph-loop',
         name: 'Ralph Loop Service',

package/dist/tools/checkpoint.js

@@ -8,7 +8,9 @@ export function registerCheckpointTool(api) {
         name: 'omoc_checkpoint',
         description: 'Save, load, or list session checkpoints for crash recovery',
         parameters: Type.Object({
-            action: Type.Union([Type.Literal('save'), Type.Literal('load'), Type.Literal('list')], {
+            action: Type.Unsafe({
+                type: 'string',
+                enum: ['save', 'load', 'list'],
                 description: 'Checkpoint operation',
             }),
             task: Type.Optional(Type.String({ description: 'Current task name (for save)' })),

package/openclaw.plugin.json

@@ -2,8 +2,8 @@
   "id": "oh-my-openclaw",
   "name": "Oh-My-OpenClaw",
   "description": "Multi-agent orchestration plugin \u2014 10 agents, category-based model routing, todo enforcer, ralph loop, and custom tools",
-  "version": "0.2.1",
-  "skills": ["../skills"],
+  "version": "0.3.0",
+  "skills": ["skills"],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happycastle/oh-my-openclaw",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Oh-My-OpenClaw plugin — multi-agent orchestration, todo enforcer, ralph loop, and custom tools for OpenClaw",
   "type": "module",
   "main": "dist/index.js",
@@ -35,6 +35,7 @@
   "files": [
     "dist",
     "bin",
+    "skills",
     "openclaw.plugin.json"
   ],
   "keywords": [

package/skills/comment-checker.md

@@ -0,0 +1,80 @@
+---
+name: comment-checker
+description: Code quality checker that prevents AI slop in comments. Ensures code reads like a senior developer wrote it.
+---
+
+# Comment Checker - Anti-AI-Slop Guard
+
+You are the **Comment Checker**, ensuring code quality by preventing AI-generated comment slop.
+
+## What is AI Slop?
+
+Comments that add no value, state the obvious, or sound robotic:
+
+### BAD (AI Slop) ❌
+```typescript
+// Import the necessary modules
+import { User } from './models';
+
+// Define the function to get user
+function getUser(id: string) {
+  // Get the user from the database
+  const user = await db.users.findOne({ id });
+  // Return the user
+  return user;
+}
+
+// Export the function
+export { getUser };
+```
+
+### GOOD (Senior Developer) ✅
+```typescript
+import { User } from './models';
+
+// Throws NotFoundError if user doesn't exist
+function getUser(id: string) {
+  const user = await db.users.findOne({ id });
+  return user;
+}
+
+export { getUser };
+```
+
+## Rules
+
+1. **Delete obvious comments**: If the code says what the comment says, delete the comment
+2. **Keep WHY comments**: Comments explaining *why* something is done a certain way are valuable
+3. **Keep WARNING comments**: `// HACK:`, `// TODO:`, `// FIXME:`, `// WARNING:` are useful
+4. **Keep API docs**: JSDoc/docstrings for public APIs are valuable
+5. **No narration**: Don't narrate what the code does step by step
+
+## Detection Patterns
+
+Flag these patterns for removal:
+- `// Import ...` before import statements
+- `// Define ...` before function/class definitions
+- `// Return ...` before return statements
+- `// Export ...` before export statements
+- `// Set ... to ...` before assignments
+- `// Loop through ...` before loops
+- `// Check if ...` before conditionals (unless explaining WHY)
+- `// Initialize ...` before variable declarations
+- `// Create ...` before object creation
+
+## When to Run
+
+- After any code generation or modification
+- Before committing (pair with git-master skill)
+- During code review
+
+## Output
+
+When checking code, report:
+```
+Comment Check Results:
+- ✅ Clean: [number] files
+- ⚠️ AI Slop Found: [number] files
+  - [file:line] "[offending comment]" → REMOVE (obvious)
+  - [file:line] "[offending comment]" → REWRITE: "[suggested replacement]"
+```

package/skills/delegation-prompt.md

@@ -0,0 +1,51 @@
+---
+name: delegation-prompt
+description: Delegation prompt writing guide with 7 required elements for high-precision subagent execution.
+---
+
+# Delegation Prompt - 7 Elements Guide
+
+위임 품질은 프롬프트 품질에 의해 결정된다. 아래 7요소를 항상 포함한다.
+
+## 7 Required Elements
+
+1. **TASK**
+   - 단일 원자 작업을 명확히 지시
+2. **EXPECTED OUTCOME**
+   - 산출물과 성공 기준을 구체화
+3. **REQUIRED SKILLS**
+   - 필요한 스킬 목록 명시
+4. **REQUIRED TOOLS**
+   - 사용 가능한 도구 화이트리스트
+5. **MUST DO**
+   - 반드시 수행할 세부 요구사항
+6. **MUST NOT DO**
+   - 금지사항(범위 확장, 파일 수정 금지 등)
+7. **CONTEXT**
+   - 경로, 제약, 기존 패턴, 다운스트림 목적
+
+## Canonical Template
+
+```markdown
+1) TASK: <one atomic goal>
+2) EXPECTED OUTCOME: <deliverables + acceptance criteria>
+3) REQUIRED SKILLS: <skill1, skill2>
+4) REQUIRED TOOLS: <tool whitelist>
+5) MUST DO: <exhaustive requirements>
+6) MUST NOT DO: <explicit prohibitions>
+7) CONTEXT: <paths, constraints, style references, downstream use>
+```
+
+## Quality Checklist
+
+- 결과 검증 기준이 측정 가능하다
+- 입력 경로/범위가 명시되어 있다
+- 금지사항이 모호하지 않다
+- 실패 시 재시도/보고 방식이 정의되어 있다
+
+## Anti-Patterns
+
+- "적당히", "알아서" 같은 모호한 지시
+- 도구 무제한 허용
+- 컨텍스트 없는 대규모 요청
+- 기대 산출물이 없는 위임

package/skills/frontend-ui-ux.md

@@ -0,0 +1,76 @@
+---
+name: frontend-ui-ux
+description: Designer-turned-developer skill for crafting stunning UI/UX. Emphasizes bold aesthetic direction, distinctive typography, cohesive color palettes, and premium feel.
+---
+
+# Frontend UI/UX - Design-First Development
+
+You are a **designer-turned-developer**. You craft stunning UI/UX even without design mockups.
+
+## Design Process
+
+Before writing any code, define:
+1. **Purpose**: What is this interface for? Who uses it?
+2. **Tone**: Professional? Playful? Minimal? Bold?
+3. **Constraints**: Existing design system? Brand colors? Accessibility requirements?
+4. **Differentiation**: What makes this NOT look like every other AI-generated UI?
+
+## Aesthetic Direction
+
+Choose an extreme. Generic is death:
+- **Brutalist**: Raw, bold, intentionally rough
+- **Maximalist**: Rich, layered, information-dense
+- **Retro-futuristic**: Neon + dark, cyberpunk vibes
+- **Luxury**: Minimal, spacious, premium materials
+- **Playful**: Rounded, colorful, animated, fun
+
+## Typography
+
+- Use **distinctive** fonts, not defaults
+- Avoid: Inter, Roboto, Arial (too generic)
+- Try: Space Grotesk, Outfit, Clash Display, Satoshi, Cabinet Grotesk
+- Establish clear hierarchy: display → heading → body → caption
+- Use font-feature-settings for polish
+
+## Color
+
+- Build a **cohesive palette** with 3-5 colors
+- Use HSL for precise control
+- Sharp accents against muted backgrounds
+- Avoid: purple-on-white AI slop, random gradients
+- Dark mode: not just inverted colors, redesign the feel
+
+## Motion & Interaction
+
+- **High-impact**: Staggered reveals, scroll-triggered animations
+- **Surprising**: Unexpected hover states, micro-interactions
+- Use CSS transitions (200-400ms) for state changes
+- Use CSS animations for attention-grabbing elements
+- Avoid: gratuitous animation that slows down the experience
+
+## Layout
+
+- Break the grid intentionally
+- Use negative space as a design element
+- Asymmetric layouts > symmetric layouts
+- Full-bleed sections for impact
+- Card-based layouts with depth (shadows, borders)
+
+## Anti-Patterns (NEVER DO)
+
+- Generic fonts (Inter, Roboto, Arial)
+- Predictable layouts (header-hero-cards-footer)
+- Cookie-cutter design (looks like every SaaS landing page)
+- Purple-on-white AI slop
+- Placeholder content without styling
+- Unstyled form elements
+- Default browser scrollbars
+
+## Verification
+
+After implementation:
+1. Take a screenshot and review it yourself
+2. Check responsive behavior at 320px, 768px, 1024px, 1440px
+3. Verify color contrast (WCAG AA minimum)
+4. Test all interactive states (hover, focus, active, disabled)
+5. Ensure animations don't cause layout shifts

package/skills/gemini-look-at.md

@@ -0,0 +1,160 @@
+---
+name: gemini-look-at
+description: Gemini CLI 기반 멀티모달 분석 스킬. PDF, 이미지, 스크린샷, 다이어그램을 Gemini의 네이티브 멀티모달 능력으로 분석한다. tmux gemini 세션을 통해 실행.
+---
+# Gemini Look-At — Multimodal Analysis via Gemini CLI
+
+OmO의 `look-at` 도구를 Gemini CLI + tmux로 재구현한 스킬.
+OpenClaw의 `read` 도구는 이미지를 첨부로 보내줄 수 있지만, **PDF는 읽을 수 없고**, Gemini CLI는 PDF/이미지/비디오를 네이티브로 분석할 수 있다.
+
+## 언제 사용하는가
+
+- **PDF 분석** — 레이아웃, 디자인, 콘텐츠 품질 평가
+- **이미지/스크린샷 분석** — UI 리뷰, 버그 확인, 디자인 피드백
+- **다이어그램 해석** — 아키텍처, 플로우차트, ER 다이어그램 분석
+- **멀티 파일 비교** — 두 PDF/이미지를 동시에 비교
+- **OCR + 해석** — 스크린샷에서 텍스트 추출 + 의미 분석
+
+## Gemini CLI 기본 사용법
+
+```bash
+# 빠른 시작
+gemini "질문..."
+
+# 모델 지정
+gemini --model <name> "프롬프트..."
+
+# JSON 형식 출력
+gemini --output-format json "JSON 반환"
+
+# 확장(extensions) 목록 확인
+gemini --list-extensions
+```
+
+- 첫 실행 시 인터랙티브 로그인/인증이 필요하다.
+- `--yolo` 플래그는 사용하지 않는다.
+
+## 실행 방법
+
+### 방법 1: tmux gemini 세션 (권장)
+
+tmux `gemini` 세션이 이미 인증되어 있으므로 안정적.
+
+```bash
+SOCKET="/tmp/openclaw-tmux-sockets/openclaw.sock"
+SESSION="gemini"
+
+# 단일 파일 분석
+tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -l -- \
+  "gemini -m gemini-2.5-flash --prompt '이 파일을 분석해줘. 레이아웃, 디자인, 콘텐츠 품질을 평가하고 개선점을 제안해.' -f /path/to/file.pdf -o text" \
+  && sleep 0.1 && tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 Enter
+
+# 결과 확인 (10-30초 대기 후)
+sleep 15
+tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
+```
+
+### 방법 2: 결과를 파일로 저장
+
+분석 결과가 길 때는 파일로 리다이렉트:
+
+```bash
+tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -l -- \
+  "gemini -m gemini-2.5-flash --prompt '상세 분석' -f /path/to/file.pdf -o text > /tmp/gemini-analysis.md 2>&1" \
+  && sleep 0.1 && tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 Enter
+
+# 결과 파일 읽기
+sleep 20
+cat /tmp/gemini-analysis.md
+```
+
+### 방법 3: 여러 파일 동시 분석
+
+```bash
+tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -l -- \
+  "gemini -m gemini-2.5-flash --prompt '두 파일을 비교해줘' -f /path/to/before.png -f /path/to/after.png -o text" \
+  && sleep 0.1 && tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 Enter
+```
+
+## ���석 패턴별 프롬프트
+
+### PDF 레이아웃/디자인 리뷰
+```
+이 PDF의 레이아웃, 줄넘김, 디자인을 평가해줘. 
+부자연스러운 부분이 있으면 구체적으로 알려줘.
+특히: 여백, 폰트 크기, 줄간격, 페이지 나눔, 표/이미지 배치를 체크해.
+```
+
+### 스크린샷 UI 리뷰
+```
+이 웹 UI 스크린샷을 분석해줘.
+1. 레이아웃 정렬과 간격 일관성
+2. 타이포그래피 계층 구조
+3. 색상 대비 및 접근성
+4. 인터랙티브 요소의 가시성
+5. 전체적인 디자인 품질 (1-10 점수)
+개선 제안을 구체적으로 해줘.
+```
+
+### 아키텍처 다이어그램 해석
+```
+이 아키텍처 다이어그램을 분석해줘.
+- 각 컴포넌트의 역할을 식별
+- 데이터 흐름 방향을 설명
+- 잠재적 병목점이나 단일 장애점을 식별
+- 개선 제안
+```
+
+### Before/After 비교
+```
+이 두 이미지를 비교해줘.
+- 바뀐 부분을 구체적으로 나열
+- 개선된 점과 퇴보한 점을 구분
+- 추가 개선 제안
+```
+
+### 에러 스크린샷 디버깅
+```
+이 에러 스크린샷을 분석해줘.
+- 에러 메시지를 정확히 읽어줘
+- 가능한 원인을 추정
+- 해결 방법을 제안
+```
+
+## 모델 선택 가이드
+
+| ���도 | 추천 모델 | 이유 |
+|------|-----------|------|
+| 빠른 확인 | `gemini-2.5-flash` | 빠름, 충분한 멀티모달 능력 |
+| 상세 분석 | `gemini-2.5-pro` | 더 깊은 분석, 긴 콘텐츠 |
+| 최고 품질 | `gemini-3.1-pro` | 최신 모델, 최상의 멀티모달 |
+
+## OpenClaw read vs Gemini CLI
+
+| 기능 | OpenClaw `read` | Gemini CLI |
+|------|----------------|------------|
+| 이미지 (PNG/JPG) | ✅ 첨부로 전송 | ✅ 네이티브 분석 |
+| PDF | ❌ 텍스트만 | ✅ 레이아웃 포함 분석 |
+| 비디오 | ❌ | ✅ 프레임 분석 |
+| 여러 파일 동시 | ❌ 하나씩 | ✅ `-f` 여러 개 |
+| 인증 | 불필요 | tmux 세션 필요 |
+
+## 워크플로우: OpenCode + Gemini CLI 연계
+
+코딩 작업 중 시각적 확인이 필요할 때:
+
+```
+1. OpenCode (tmux opencode 세션)에서 코드 작성/수정
+2. 빌드/렌더링 결과물 생성 (PDF, 스크린샷 등)
+3. Gemini CLI (tmux gemini 세션)로 결과물 시각적 품질 검증
+4. 문제 발견 시 → 다시 OpenCode로 돌아가서 수정
+5. 반복 (결과물 만족할 때까지)
+```
+
+## 주의사항
+
+- tmux `gemini` 세션이 반드시 실행 중이어야 함 (인증 상태 유지)
+- `capture-pane`으로 결과 확인 시 출력이 잘리면 `-S -500` 등으로 줄 수 늘리기
+- 파일 경로는 절대 경로 사용
+- 응답 대기: PDF 크기에 따라 10-60초 소요 가능
+- `--yolo` 플래그 사용 금지 (안전성)

package/skills/git-master.md

@@ -0,0 +1,76 @@
+---
+name: git-master
+description: Git expert skill for atomic commits, rebase surgery, and history archaeology. Detects commit styles, splits changes into logical commits, and manages complex git operations.
+---
+
+# Git Master - Git Expert Skill
+
+You are **Git Master**, a specialized git operations expert. You have three specializations:
+
+## 1. Commit Architect
+Create clean, atomic commits following the project's conventions.
+
+### Rules
+- **3+ files** → MUST be 2+ commits
+- **5+ files** → MUST be 3+ commits
+- **10+ files** → MUST be 5+ commits
+
+### Automatic Style Detection
+Before committing, analyze the last 30 commits:
+```bash
+git log --oneline -30
+```
+Detect:
+- **Language**: Korean or English
+- **Style**: semantic (feat:/fix:/chore:), plain, or short
+- **Scope**: with scope (feat(auth):) or without
+
+Match the detected style exactly.
+
+### Commit Process
+1. `git diff --stat` to see all changes
+2. Group changes by logical unit (feature, fix, refactor, etc.)
+3. Stage each group separately: `git add <specific-files>`
+4. Commit with appropriate message matching detected style
+5. Verify with `git log --oneline -5`
+
+## 2. Rebase Surgeon
+Handle complex rebase operations safely.
+
+### Operations
+- **Interactive rebase**: `git rebase -i HEAD~N`
+- **Squash commits**: Combine related commits
+- **Reorder commits**: Fix dependency ordering
+- **Conflict resolution**: Systematic approach to merge conflicts
+
+### Safety Rules
+- Always create a backup branch before rebasing: `git branch backup-$(date +%s)`
+- Never force-push to shared branches without explicit permission
+- Document all rebase operations in commit messages
+
+## 3. History Archaeologist
+Find when and where specific changes were introduced.
+
+### Tools
+```bash
+# Find who wrote specific code
+git blame <file> -L <start>,<end>
+
+# Find when a change was introduced
+git log --all -S '<search-term>' --oneline
+
+# Find commits touching a file
+git log --follow --oneline -- <file>
+
+# Find when a function was added
+git log -p --all -S 'function_name' -- '*.ts'
+```
+
+## Trigger
+Activate when user mentions: commit, rebase, squash, "who wrote", "when was X added", "git history", "blame"
+
+## Anti-Patterns
+- Do NOT create single monolithic commits for multi-file changes
+- Do NOT use generic messages like "update files" or "fix stuff"
+- Do NOT rebase without creating a backup branch first
+- Do NOT force-push without explicit user consent

package/skills/multimodal-analysis.md

@@ -0,0 +1,58 @@
+---
+name: multimodal-analysis
+description: Multimodal file analysis skill for PDFs, images, and technical diagrams using look-at style patterns.
+---
+
+# Multimodal Analysis - File Analysis Skill
+
+OmO `look-at` 도구 패턴을 기반으로, 문서/이미지/다이어그램 분석을 표준화한다.
+
+## Source Pattern (OmO)
+
+- `look-at`는 파일 경로 + 분석 목표(goal)를 받아 멀티모달 해석 수행
+- 핵심 입력은 단순하다: **무엇을 볼지** + **무엇을 추출할지**
+
+## Supported Inputs
+
+- PDF 문서
+- 일반 이미지(PNG/JPG/WebP)
+- 기술 다이어그램(architecture/flow/UML/ER)
+
+## Analysis Patterns
+
+### 1) PDF Analysis
+
+- 목표 예시: 요약, 정책/요건 추출, 변경점 비교
+- 출력: 핵심 항목 bullet + 필요한 경우 구조화 목록
+
+### 2) Image Analysis
+
+- 목표 예시: 화면 구성요소 식별, 텍스트/라벨 추출, 상태 비교
+- 출력: 영역별 관찰 + actionable insight
+
+### 3) Diagram Analysis
+
+- 목표 예시: 컴포넌트 관계, 데이터 흐름, 병목/리스크 파악
+- 출력: 노드/엣지 해석 + 개선 포인트
+
+## Prompt Template
+
+```text
+Input: <file_path>
+Goal: <what to extract / explain>
+Constraints: <format, scope, language>
+Output: <summary|table|checklist>
+```
+
+## Recommended Workflow
+
+1. 목표를 1문장으로 명확화
+2. 파일 유형에 맞는 패턴 선택
+3. 분석 결과를 실행 가능한 액션으로 변환
+4. 불확실성은 "추정"으로 명시
+
+## Guardrails
+
+- 파일 내용이 불명확하면 단정하지 않는다
+- OCR/시각 해석 결과는 근거와 함께 제시
+- 원문 인용이 필요하면 짧게, 과도한 복붙 금지

package/skills/opencode-controller.md

@@ -0,0 +1,197 @@
+---
+name: opencode-controller
+description: tmux의 OpenCode 세션을 제어한다. 세션 관리, 모델 선택, 에이전트 전환(Plan/Build), OmO 위임 패턴을 포함.
+---
+
+# opencode-controller — OpenCode 세션 제어
+
+OpenClaw는 직접 코드를 쓰는 실행기가 아니라, OpenCode에 작업을 위임해 결과를 수집/검증하는 오케스트레이터다.
+
+## 핵심 원칙
+
+- OpenClaw가 직접 코드를 작성하지 않는다
+- 코딩 작업은 tmux `opencode` 세션으로 위임한다
+- OpenClaw는 작업 분해, 지시, 모니터링, 결과 검증을 담당한다
+
+## Pre-flight 체크
+
+### 1) Provider/모델 선택
+
+- 작업 난이도에 따라 OpenCode 모델 선택(quick/deep/ultrabrain)
+- 고난도 작업은 고성능 모델 우선
+
+### 2) 인증 상태
+
+- OpenCode CLI 제공자 인증이 완료되어 있어야 함
+- 인증 만료 시 세션 내에서 재로그인 후 재시도
+
+### 3) tmux 세션 확인
+
+```bash
+SOCKET="/tmp/openclaw-tmux-sockets/openclaw.sock"
+tmux -S "$SOCKET" has-session -t opencode
+```
+
+## 세션 관리
+
+```bash
+SOCKET="/tmp/openclaw-tmux-sockets/openclaw.sock"
+
+# 세션 생성
+tmux -S "$SOCKET" new -d -s opencode -n main
+
+# 세션 상태
+tmux -S "$SOCKET" list-sessions
+
+# 세션 출력 확인
+tmux -S "$SOCKET" capture-pane -p -J -t opencode:0.0 -S -200
+```
+
+## 에이전트 제어
+
+OpenCode 에이전트 전환은 Tab 기반으로 수행한다.
+
+| 에이전트 | 용도 | 전환 |
+|----------|------|------|
+| Sisyphus | 기본 구현/수정 | 기본 상태 |
+| Hephaestus | 깊은 구현/리팩토링 | Tab 1회 |
+| Prometheus | 계획 수립/전략화 | Tab 2회 |
+
+```bash
+tmux -S "$SOCKET" send-keys -t opencode:0.0 Tab
+sleep 1
+tmux -S "$SOCKET" capture-pane -p -J -t opencode:0.0 -S -20
+```
+
+## 모델 선택 가이드
+
+- 빠른 수정: 속도 우선 모델
+- 복잡한 리팩토링/설계: 심층 추론 모델
+- 계획 전용 단계: 최고 추론 모델 우선
+
+실행 시점에 프로젝트 표준 라우팅(quick/deep/ultrabrain)을 따른다.
+
+## Plan -> Build 워크플로우
+
+1) Prometheus로 계획 수립
+2) 계획 승인/정리
+3) Sisyphus 또는 Hephaestus로 구현 전환
+4) 테스트/빌드/검증 실행
+5) 결과를 OpenClaw가 수집해 최종 보고
+
+```bash
+# Plan 단계
+tmux -S "$SOCKET" send-keys -t opencode:0.0 Tab
+tmux -S "$SOCKET" send-keys -t opencode:0.0 Tab
+sleep 0.2
+tmux -S "$SOCKET" send-keys -t opencode:0.0 -l -- '계획 수립: 인증 모듈 리팩토링 범위/리스크/검증전략 작성'
+tmux -S "$SOCKET" send-keys -t opencode:0.0 Enter
+
+# Build 단계 전환(예: Sisyphus로 복귀 후 구현)
+tmux -S "$SOCKET" send-keys -t opencode:0.0 Escape
+tmux -S "$SOCKET" send-keys -t opencode:0.0 -l -- 'ultrawork 위 계획 기준으로 구현 시작, 테스트까지 완료'
+tmux -S "$SOCKET" send-keys -t opencode:0.0 Enter
+```
+
+## OmO 위임 패턴
+
+### 1) tmux 세션 검증
+
+```bash
+SOCKET="/tmp/openclaw-tmux-sockets/openclaw.sock"
+tmux -S "$SOCKET" has-session -t opencode
+```
+
+### 2) 에이전트 선택표
+
+| 목적 | 에이전트 | 전환 |
+|------|----------|------|
+| 기본 실행 | Sisyphus | 기본 |
+| 깊은 구현 | Hephaestus | Tab 1회 |
+| 계획 수립 | Prometheus | Tab 2회 |
+
+### 3) 작업 전송 (`send-keys -l` + Enter 분리)
+
+```bash
+TASK='ultrawork 결제 실패 버그 수정. 재현, 원인 분석, 테스트 추가, 회귀 방지 포함.'
+tmux -S "$SOCKET" send-keys -t opencode:0.0 -l -- "$TASK"
+sleep 0.1
+tmux -S "$SOCKET" send-keys -t opencode:0.0 Enter
+```
+
+### 4) 작업 템플릿
+
+기능 구현:
+```text
+ultrawork [기능] 구현.
+요구사항:
+- [요구 1]
+- [요구 2]
+기존 [참조 파일] 패턴을 따르고 테스트까지 수행.
+```
+
+버그 수정:
+```text
+ultrawork [버그 설명] 수정.
+재현 경로: [steps]
+에러: [message]
+기대 동작: [expected]
+```
+
+리팩토링:
+```text
+ultrawork [모듈] 리팩토링.
+목표:
+- [목표 1]
+- [목표 2]
+제약:
+- Public API 변경 금지
+- 기존 테스트 통과
+```
+
+리서치 + 구현:
+```text
+[/path/to/research.md]를 먼저 읽고,
+ultrawork 연구 결과 기준으로 [기능] 구현.
+```
+
+### 5) 진행 모니터링 (`capture-pane`)
+
+```bash
+tmux -S "$SOCKET" capture-pane -p -J -t opencode:0.0 -S -200
+```
+
+권장:
+- 10-30초 주기로 진행 로그 확인
+- 막힘 징후(동일 출력 반복, 프롬프트 대기) 즉시 개입
+
+### 6) 결과 수집 (`git status`/`git diff`)
+
+```bash
+git status
+git diff --stat
+git diff
+```
+
+OpenClaw는 변경 파일/테스트 결과/리스크를 요약해 사용자에게 전달한다.
+
+### 7) 에러 복구
+
+```bash
+# 현재 동작 중단
+tmux -S "$SOCKET" send-keys -t opencode:0.0 Escape
+
+# 수정 지시 재전송
+tmux -S "$SOCKET" send-keys -t opencode:0.0 -l -- '직전 단계에서 테스트 실패 원인만 먼저 해결해.'
+tmux -S "$SOCKET" send-keys -t opencode:0.0 Enter
+
+# 세션 재시작
+tmux -S "$SOCKET" kill-session -t opencode
+tmux -S "$SOCKET" new -d -s opencode -n main
+```
+
+## 운영 체크리스트
+
+- 세션 alive 확인 -> 에이전트 선택 -> 작업 전송 -> 모니터링 -> 결과 수집
+- 항상 `send-keys -l` + 별도 Enter
+- 결과 보고 전에 `git status`/`git diff`로 변경 검증

package/skills/steering-words.md

@@ -0,0 +1,72 @@
+---
+name: steering-words
+description: Detect ultrawork/search/analyze family keywords in multilingual prompts and recommend the best agent mode.
+---
+
+# Steering Words - Keyword Detection Skill
+
+키워드 기반으로 사용자 의도를 빠르게 분류하고 적절한 에이전트 모드를 추천한다.
+
+## 목적
+
+- 입력 프롬프트에서 **steering words**를 감지
+- `ultrawork / search / analyze` 패밀리로 분류
+- 한국어/일본어/중국어 키워드를 포함해 모드 추천
+
+## Detection Families
+
+### 1) Ultrawork Family
+
+- English: `ultrawork`, `ulw`, `full throttle`, `maximum effort`, `deep think`
+- 한국어: `울트라워크`, `풀가동`, `최대 노력`, `끝까지`, `전부 자동`
+- 日本語: `ウルトラワーク`, `全力`, `最大努力`, `最後まで`, `自動実行`
+- 中文: `超强模式`, `全力模式`, `最大努力`, `一路做完`, `全自动`
+
+**추천 모드**
+- 우선: `/ultrawork`
+- 대안: 복잡 구현이면 `hephaestus`, 복잡 계획이면 `prometheus`
+
+### 2) Search Family
+
+- English: `search`, `find`, `locate`, `lookup`, `scan`, `trace`, `where is`, `list all`
+- 한국어: `찾아`, `검색`, `어디`, `전부 보여`, `목록`
+- 日本語: `探して`, `検索`, `どこ`, `一覧`, `全部見せて`
+- 中文: `查找`, `搜索`, `哪里`, `列出`, `全部显示`
+
+**추천 모드**
+- 우선: `explore` (코드베이스 탐색)
+- 외부 문서/OSS 필요 시: `librarian` 병행
+
+### 3) Analyze Family
+
+- English: `analyze`, `analyse`, `investigate`, `examine`, `research`, `audit`, `why`, `how does`
+- 한국어: `분석`, `조사`, `검토`, `원인`, `왜`, `어떻게`
+- 日本語: `分析`, `調査`, `検証`, `原因`, `なぜ`, `どうして`
+- 中文: `分析`, `调查`, `排查`, `原因`, `为什么`, `怎么`
+
+**추천 모드**
+- 우선: `metis` (의도 분류/범위 정제)
+- 아키텍처 트레이드오프 포함 시: `oracle`
+
+## Scoring Rule
+
+1. 패밀리별 키워드 매칭 수를 집계
+2. 최다 점수 패밀리를 선택
+3. 동점이면 우선순위: `ultrawork > analyze > search`
+4. 모호하면 `metis` 추천 후 재분류
+
+## Output Template
+
+```markdown
+## Steering Detection
+- Family: <ultrawork|search|analyze>
+- Matched Keywords: <comma-separated>
+- Recommended Mode: <mode/agent>
+- Reason: <one sentence>
+```
+
+## Guardrails
+
+- 키워드 감지는 힌트이며 절대 규칙이 아니다.
+- 명시적 사용자 지시가 있으면 키워드보다 우선한다.
+- 다국어 혼합 입력은 단일 언어로 정규화하지 말고 그대로 매칭한다.

package/skills/tmux-agents.md

@@ -0,0 +1,103 @@
+---
+name: tmux-agents
+description: tmux 세션에서 코딩 에이전트(Claude Code, Codex, Gemini, Ollama)를 스폰하고 모니터링한다.
+---
+
+# tmux-agents — 에이전트 스폰/모니터링 가이드
+
+tmux 안에서 코딩 에이전트를 띄우고, 상태를 확인하고, 병렬로 운영하는 실행 패턴 모음.
+
+## 에이전트 종류
+
+| 구분 | 에이전트 ID | 실행 위치 | 특성 |
+|------|-------------|----------|------|
+| cloud | `claude` | 원격 API | 고품질 추론, 안정적 |
+| cloud | `codex` | 원격 API | 코드 생성/수정 강점 |
+| cloud | `gemini` | 원격 API | 멀티모달/긴 문맥 강점 |
+| local | `ollama-claude` | 로컬 Ollama | 비용 절감, 오프라인 가능 |
+| local | `ollama-codex` | 로컬 Ollama | 로컬 코드 작업 최적화 |
+
+## 빠른 명령 모음
+
+아래 명령은 tmux-agents 헬퍼 스크립트 인터페이스를 기준으로 한다.
+
+```bash
+# 1) 스폰
+./spawn.sh --agent codex --session opencode-2 --cwd /path/to/project
+
+# 2) 목록
+./status.sh list
+
+# 3) 헬스체크
+./check.sh --session opencode-2
+
+# 4) 붙기
+tmux attach -t opencode-2
+
+# 5) 지시 전송 (안전 입력)
+tmux send-keys -t opencode-2:0.0 -l -- 'Fix failing tests in auth module'
+tmux send-keys -t opencode-2:0.0 Enter
+
+# 6) 종료
+tmux kill-session -t opencode-2
+```
+
+## 병렬 에이전트 패턴
+
+```bash
+# 병렬 스폰 예시
+./spawn.sh --agent codex --session opencode --cwd /repo/a
+./spawn.sh --agent claude --session opencode-2 --cwd /repo/b
+./spawn.sh --agent gemini --session gemini --cwd /repo/a
+
+# 병렬 진행 후 상태 점검
+./status.sh list
+./check.sh --session opencode
+./check.sh --session opencode-2
+./check.sh --session gemini
+```
+
+운영 원칙:
+- 구현 세션과 검증 세션을 분리
+- 긴 작업은 10-30초 간격으로 주기 점검
+- 완료 후 세션별 결과를 순차 수집
+
+## Local vs Cloud 선택 기준
+
+| 상황 | 권장 | 이유 |
+|------|------|------|
+| 속도보다 품질이 중요 | cloud | 최신 모델 품질/추론 강점 |
+| 장시간 반복 작업 | local | 비용 절감, 호출 제한 없음 |
+| 외부 네트워크 제약 | local | 오프라인/폐쇄망 대응 |
+| 멀티모달 분석 필요 | cloud(gemini) | 이미지/PDF 처리 품질 |
+| 민감 코드 로컬 처리 | local | 데이터 외부 전송 최소화 |
+
+## Ollama 준비
+
+```bash
+# Ollama 실행 확인
+ollama list
+
+# 필요한 모델 다운로드(예시)
+ollama pull qwen2.5-coder:14b
+ollama pull llama3.1:8b
+
+# 로컬 응답 확인
+curl http://127.0.0.1:11434/api/tags
+```
+
+권장:
+- 코딩용 모델 + 범용 대화 모델 1개씩 준비
+- RAM/VRAM 한계를 고려해 동시 실행 수 제한
+
+## 팁
+
+- 세션 타겟은 항상 `session:window.pane`으로 고정 (`opencode-2:0.0`)
+- 텍스트 입력은 `send-keys -l` 후 Enter 분리
+- 출력 확인은 `capture-pane -p -J -S -200` 기본 사용
+- 실패 세션은 즉시 재생성하고 동일 프롬프트 재투입
+
+## 헬퍼 스크립트 범위
+
+`spawn.sh`, `status.sh`, `check.sh`는 공식 `openclaw/skills/tmux-agents` 패키지에서 제공되는 헬퍼 스크립트 인터페이스를 따른다.
+이 문서는 스크립트 사용법 자체가 아니라, OpenClaw/OmO 운영 관점의 실행 지식을 제공한다.

package/skills/tmux.md

@@ -0,0 +1,175 @@
+---
+name: tmux
+description: tmux 세션 원격제어 + 멀티 세션 오케스트레이션. send-keys/capture-pane으로 인터랙티브 CLI를 제어하고 병렬 세션을 운영한다.
+---
+
+# tmux — 세션 제어와 병렬 오케스트레이션
+
+OpenClaw에서 tmux를 제어할 때의 표준 패턴.
+단일 세션 제어부터 OpenCode/Gemini 멀티 세션 병렬 운영까지 다룬다.
+
+## 소켓 규칙
+
+- OpenClaw 기본 소켓: `/tmp/openclaw-tmux-sockets/openclaw.sock`
+- 기본 clawdbot 경로를 가정하지 말고 OpenClaw 소켓을 우선 사용
+- 폴백 규칙: `CLAWDBOT_TMUX_SOCKET_DIR`가 있으면 해당 디렉토리의 소켓 사용
+
+```bash
+SOCKET="/tmp/openclaw-tmux-sockets/openclaw.sock"
+if [ -n "${CLAWDBOT_TMUX_SOCKET_DIR:-}" ] && [ -S "$CLAWDBOT_TMUX_SOCKET_DIR/openclaw.sock" ]; then
+  SOCKET="$CLAWDBOT_TMUX_SOCKET_DIR/openclaw.sock"
+fi
+```
+
+## Quickstart (OpenClaw 소켓)
+
+```bash
+SOCKET="/tmp/openclaw-tmux-sockets/openclaw.sock"
+
+# 세션 목록
+tmux -S "$SOCKET" list-sessions
+
+# opencode 세션이 살아있는지 확인
+tmux -S "$SOCKET" has-session -t opencode && echo READY || echo MISSING
+
+# 출력 확인
+tmux -S "$SOCKET" capture-pane -p -J -t opencode:0.0 -S -200
+```
+
+## 타겟 지정 규칙
+
+- 타겟 형식: `session:window.pane`
+- 예시: `opencode:0.0`, `gemini:0.0`, `opencode-2:1.0`
+- 세션명만 주면 모호해질 수 있으므로 가능하면 pane까지 고정
+
+```bash
+tmux -S "$SOCKET" send-keys -t opencode:0.0 -l -- 'pwd'
+sleep 0.1
+tmux -S "$SOCKET" send-keys -t opencode:0.0 Enter
+```
+
+## 안전한 입력 전송
+
+원칙: `send-keys -l`로 문자열 전송 후 `Enter`를 별도 호출.
+
+```bash
+TARGET="opencode:0.0"
+CMD='git status --short'
+
+tmux -S "$SOCKET" send-keys -t "$TARGET" -l -- "$CMD"
+sleep 0.1
+tmux -S "$SOCKET" send-keys -t "$TARGET" Enter
+```
+
+## 출력 수집 표준
+
+최근 출력은 아래 명령을 기본으로 사용:
+
+```bash
+tmux -S "$SOCKET" capture-pane -p -J -t opencode:0.0 -S -200
+```
+
+- 긴 작업은 `-S -500` 이상으로 확장
+- `-J`로 줄바꿈 연결해 파싱 안정성 확보
+
+## 코딩 에이전트 오케스트레이션
+
+여러 코딩 세션을 병렬 실행하고 완료를 폴링한다.
+
+```bash
+SOCKET="/tmp/openclaw-tmux-sockets/openclaw.sock"
+
+# 병렬 지시
+tmux -S "$SOCKET" send-keys -t opencode:0.0 -l -- 'ultrawork auth 버그 수정'
+tmux -S "$SOCKET" send-keys -t opencode:0.0 Enter
+
+tmux -S "$SOCKET" send-keys -t opencode-2:0.0 -l -- 'ultrawork 결제 모듈 테스트 보강'
+tmux -S "$SOCKET" send-keys -t opencode-2:0.0 Enter
+
+# 완료 폴링
+for i in $(seq 1 20); do
+  echo "[poll:$i] opencode"
+  tmux -S "$SOCKET" capture-pane -p -J -t opencode:0.0 -S -30
+  echo "[poll:$i] opencode-2"
+  tmux -S "$SOCKET" capture-pane -p -J -t opencode-2:0.0 -S -30
+  sleep 15
+done
+```
+
+권장 운영 방식:
+- 시작은 병렬, 결과 수집은 순차
+- 폴링 간격은 10-30초
+- 완료 신호(작업 요약/테스트 결과) 확인 후 다음 단계 진행
+
+## 멀티 세션 오케스트레이션 패턴
+
+### 세션 네이밍
+
+- 기본: `opencode`, `gemini`
+- 확장: `opencode-2`, `gemini-2`, `opencode-3`, `research`, `build`
+- 규칙: 역할 또는 프로젝트 단위로 명명
+
+### 병렬 시나리오
+
+1) 두 프로젝트 동시 진행
+- `opencode`: 프로젝트 A
+- `opencode-2`: 프로젝트 B
+
+2) 코딩 + 검증 동시 진행
+- `opencode`: 구현/수정
+- `gemini`, `gemini-2`: 결과물 시각 검증
+
+3) 리서치 + 구현 + 빌드
+- `research` 또는 `gemini`: 문서/레퍼런스 분석
+- `opencode`: 구현
+- `build`: 테스트/빌드 감시
+
+### 에이전트 선택표 (OpenCode)
+
+| 작업 성격 | 권장 에이전트 | 전환 |
+|-----------|----------------|------|
+| 빠른 수정/구현 | Sisyphus (기본) | 기본 상태 |
+| 복잡한 자율 구현 | Hephaestus | Tab 1회 |
+| 계획/전략 수립 | Prometheus | Tab 2회 |
+
+## 운영 템플릿
+
+```bash
+SOCKET="/tmp/openclaw-tmux-sockets/openclaw.sock"
+
+# 세션 생성
+tmux -S "$SOCKET" new -d -s opencode-2 -n main
+tmux -S "$SOCKET" new -d -s gemini-2 -n main
+
+# 작업 전송
+tmux -S "$SOCKET" send-keys -t opencode-2:0.0 -l -- 'ultrawork 리팩토링 실행'
+sleep 0.1
+tmux -S "$SOCKET" send-keys -t opencode-2:0.0 Enter
+
+# 결과 캡처
+tmux -S "$SOCKET" capture-pane -p -J -t opencode-2:0.0 -S -200
+```
+
+## 정리(클린업)
+
+```bash
+SOCKET="/tmp/openclaw-tmux-sockets/openclaw.sock"
+
+# 단일 세션 종료
+tmux -S "$SOCKET" kill-session -t opencode-2
+
+# 기본 세션(opencode, gemini) 제외 전체 종료
+for s in $(tmux -S "$SOCKET" list-sessions -F '#{session_name}' 2>/dev/null); do
+  case "$s" in
+    opencode|gemini) ;;
+    *) tmux -S "$SOCKET" kill-session -t "$s" ;;
+  esac
+done
+```
+
+## 주의사항
+
+- Enter를 명령 문자열에 섞지 말고 반드시 분리
+- 경로/인용부호가 복잡한 명령은 스크립트 파일로 실행
+- pane 캡처만으로 부족하면 로그 파일 리다이렉트 병행
+- 세션 수를 늘릴수록 메모리 사용량이 급증하므로 동시성 제한 필요

package/skills/workflow-auto-rescue.md

@@ -0,0 +1,101 @@
+---
+description: Session recovery workflow with checkpointing, failure detection, and automatic restore using file-based checkpoints + memory_search.
+---
+
+# Auto-Rescue Workflow
+
+장시간 작업 중 실패/중단 상황에서 세션을 자동 복구한다.
+
+## When to Use
+
+- 긴 구현/리팩터링 세션
+- 다중 단계 작업(5+ step)
+- 반복 실패 가능성이 높은 디버깅/빌드 복구 작업
+
+## Core Mechanism
+
+- **Checkpoint 저장**: 주요 단계마다 `write` 도구로 파일 저장 (`workspace/checkpoints/`)
+- **Checkpoint 조회**: 복구 시 `read` 도구 + `memory_search` (OpenClaw 네이티브)
+- **자동 복원**: 가장 최근 정상 상태부터 재시작
+
+> **Note**: OpenClaw의 `group:memory`에는 `memory_search`/`memory_get`만 존재하고
+> `memory_store`는 없다. 저장은 반드시 파일 기반(`write`)으로 수행한다.
+
+## Checkpoint Schema
+
+`workspace/checkpoints/checkpoint-<timestamp>.json`에 다음 형태로 저장한다:
+
+```json
+{
+  "type": "session-checkpoint",
+  "session_id": "<id>",
+  "task": "<current task>",
+  "step": "<current step>",
+  "changed_files": ["path/a", "path/b"],
+  "verification": {
+    "diagnostics": "pass|fail|not-run",
+    "tests": "pass|fail|not-run",
+    "build": "pass|fail|not-run"
+  },
+  "next_action": "<what to do next>",
+  "timestamp": "<iso8601>"
+}
+```
+
+## Workflow Steps
+
+### 1) Start Monitoring
+
+1. 세션 시작 시 checkpoint baseline 저장 (`write` → `workspace/checkpoints/`)
+2. todo 기준으로 단계 전환마다 checkpoint 갱신
+3. 실패 가능 작업 전(대규모 edit/build/test) 선저장
+
+### 2) Failure Detection
+
+다음 중 하나면 rescue 트리거:
+
+- 동일 오류 3회 연속 발생
+- 빌드/테스트가 연속 실패하고 진행 불가
+- 세션 중단(타임아웃/강제 인터럽트/에이전트 중지)
+
+### 3) Recovery Procedure
+
+1. `read` 도구로 `workspace/checkpoints/` 내 최근 checkpoint 파일 읽기
+2. 가장 최신 `verification`이 정상(pass)인 지점 선택
+3. 해당 시점의 `next_action`부터 재개
+4. 동일 실패 재발 시 한 단계 이전 checkpoint로 롤백
+
+### 4) Post-Recovery
+
+1. 복구 성공 상태를 새 checkpoint 파일로 저장 (`write`)
+2. 실패 원인/해결을 `workspace/notepads/issues.md`에 기록
+3. 남은 단계 계속 진행
+
+## OpenClaw Tool Mapping
+
+| 동작            | 사용할 도구     | 비고                                         |
+| --------------- | --------------- | -------------------------------------------- |
+| Checkpoint 저장 | `write`         | `workspace/checkpoints/checkpoint-<ts>.json` |
+| Checkpoint 읽기 | `read`          | 직접 파일 경로 지정                          |
+| 과거 기억 검색  | `memory_search` | OpenClaw `group:memory`                      |
+| 특정 기억 조회  | `memory_get`    | key 기반                                     |
+| 파일 목록 확인  | `exec` (ls)     | checkpoint 디렉토리 스캔                     |
+
+## Example
+
+```text
+# 저장
+write({ path: "workspace/checkpoints/checkpoint-2026-02-22T13-00.json", content: "{ ... }" })
+
+# 복구 시 읽기
+read({ path: "workspace/checkpoints/checkpoint-2026-02-22T13-00.json" })
+
+# 세션 기억에서 관련 컨텍스트 검색
+memory_search({ query: "session-checkpoint auth refactor" })
+```
+
+## Completion Criteria
+
+- 복구 후 작업이 실제로 재개됨
+- 최신 checkpoint 파일이 저장됨
+- 동일 실패 루프가 차단됨

package/skills/workflow-tool-patterns.md

@@ -0,0 +1,84 @@
+---
+description: OmO src/tools 패턴을 OpenClaw에서 재사용 가능한 실행 패턴으로 매핑하는 워크플로우
+---
+
+# Tool Patterns Workflow (OmO → OpenClaw)
+
+OmO의 `src/tools/` 구조를 기준으로, OpenClaw에서 실사용 가능한 도구 패턴을 표준화한다.
+
+## 목적
+
+- 도구 선택 실수를 줄이고
+- 반복 가능한 실행 루틴을 만들며
+- 계획/실행/검증 단계를 일관되게 유지한다.
+
+## 패턴 매핑
+
+> **중요**: 아래 테이블의 "OpenClaw 도구"는 모두 OpenClaw 공식 도구 인벤토리에 실제 존재하는 도구들이다.
+
+| OmO Tool Pattern          | 의도                 | OpenClaw 도구 & 사용 패턴                                          |
+| ------------------------- | -------------------- | ------------------------------------------------------------------ |
+| `task/*` (todo-sync)      | 작업 상태 추적       | 파일 기반 할 일 관리: `write`로 `workspace/todos.md` 갱신          |
+| `lsp/*` (goto/references) | 코드 탐색/검증       | `exec` 도구로 린터/타입체커 실행 → 결과로 검증                     |
+| `interactive-bash`        | 장시간/상호작용 셸   | `exec`(`pty: true`) 또는 tmux 연동                                 |
+| `bash`                    | 원샷 명령            | `exec`(동기), `exec`(`background: true`) → `process`(`poll`)       |
+| `slashcommand`            | 명령 워크플로우 구동 | OpenClaw 스킬 `/ultrawork`, `/plan`, `/start-work` (슬래시 커맨드) |
+| `session-manager`         | 세션 탐색/재개       | `sessions_list`, `sessions_history`, `session_status`              |
+| `skill-mcp`               | 스킬 기반 도구 호출  | OpenClaw 스킬 시스템 (`read` → SKILL.md 참조)                      |
+| `look-at`                 | 멀티모달 분석        | `image` 도구 + Gemini CLI tmux 연동                                |
+| `background-task`         | 병렬 작업            | `exec`(`background: true`) → `process`(`poll`/`log`/`kill`)        |
+| `file-read/write/edit`    | 파일 조작            | `read`, `write`, `edit`, `apply_patch` (`group:fs`)                |
+| `web-search`              | 웹 검색              | `web_search`, `web_fetch` (`group:web`)                            |
+| `memory`                  | 지식 축적            | `memory_search`, `memory_get` (`group:memory`)                     |
+| `delegation`              | 서브에이전트 위임    | `sessions_spawn`(`task`, `agentId`, `model`)                       |
+
+## OpenClaw Tool Groups 정리
+
+| Group            | 포함 도구                                        | 활용                         |
+| ---------------- | ------------------------------------------------ | ---------------------------- |
+| `group:fs`       | read, write, edit, apply_patch                   | 파일 조작 전반               |
+| `group:runtime`  | exec, bash, process                              | 명령 실행 + 백그라운드 관리  |
+| `group:sessions` | sessions_list/history/send/spawn, session_status | 멀티 에이전트                |
+| `group:memory`   | memory_search, memory_get                        | 지식 검색 (저장은 파일 기반) |
+| `group:web`      | web_search, web_fetch                            | 웹 검색/페치                 |
+| `group:ui`       | browser, canvas                                  | 브라우저/UI                  |
+
+## 실행 절차
+
+### 1) 계획 단계
+
+1. 복잡 작업이면 `write`로 `workspace/todos.md` 생성
+2. 탐색은 `exec` + grep/find 우선
+3. 외부 의존성은 `web_search`/`web_fetch` 또는 librarian 에이전트 병행
+
+### 2) 구현 단계
+
+1. 변경 전 `read` + `exec`(grep)로 영향도 파악
+2. 작은 단위로 `edit`/`apply_patch` 수정
+3. 필요 시 `sessions_spawn`로 전문 에이전트 위임
+
+### 3) 검증 단계
+
+1. `exec`로 린터/타입체커 실행
+2. `exec`로 관련 테스트/빌드 실행
+3. 실패 시 원인-기반 `edit` 후 재검증
+
+### 4) 병렬 작업 관리
+
+1. 독립 탐색/리서치는 `exec`(`background: true`)로 병렬 실행
+2. `process`(`poll`/`log`)로 결과 수집
+3. 최종 응답 전 `process`(`kill`)로 정리
+
+## 금지/주의 사항
+
+- 구현 미요청 상태에서 코드 변경 금지
+- 검증 없는 완료 보고 금지
+- 장시간 TUI 작업은 `exec`(`pty: true`) 사용
+- 수동 추정으로 API/패턴 확정하지 않기 (검색/근거 필수)
+
+## 체크리스트
+
+- [ ] Todo 상태가 `workspace/todos.md`에 실시간 반영되었는가
+- [ ] 사용한 도구가 OpenClaw 공식 도구 인벤토리에 존재하는가
+- [ ] 변경 후 `exec`로 test/build 근거가 있는가
+- [ ] 백그라운드 작업이 `process`(`kill`)로 정리되었는가