oh-my-claudecode-opencode 0.2.0 → 0.3.0

package/assets/skills/ultraqa.md

@@ -0,0 +1,123 @@
+---
+name: ultraqa
+description: QA cycling workflow - test, verify, fix, repeat until goal met
+user-invocable: true
+---
+
+# UltraQA Skill
+
+[ULTRAQA ACTIVATED - AUTONOMOUS QA CYCLING]
+
+## Overview
+
+You are now in **ULTRAQA** mode - an autonomous QA cycling workflow that runs until your quality goal is met.
+
+**Cycle**: qa-tester → architect verification → fix → repeat
+
+## Goal Parsing
+
+Parse the goal from arguments. Supported formats:
+
+| Invocation | Goal Type | What to Check |
+|------------|-----------|---------------|
+| `/oh-my-claudecode:ultraqa --tests` | tests | All test suites pass |
+| `/oh-my-claudecode:ultraqa --build` | build | Build succeeds with exit 0 |
+| `/oh-my-claudecode:ultraqa --lint` | lint | No lint errors |
+| `/oh-my-claudecode:ultraqa --typecheck` | typecheck | No TypeScript errors |
+| `/oh-my-claudecode:ultraqa --custom "pattern"` | custom | Custom success pattern in output |
+
+If no structured goal provided, interpret the argument as a custom goal.
+
+## Cycle Workflow
+
+### Cycle N (Max 5)
+
+1. **RUN QA**: Execute verification based on goal type
+   - `--tests`: Run `npm test` or equivalent
+   - `--build`: Run `npm run build` or equivalent
+   - `--lint`: Run `npm run lint` or equivalent
+   - `--typecheck`: Run `npm run typecheck` or `tsc --noEmit`
+   - `--custom`: Run appropriate command and check for pattern
+   - `--interactive`: Use qa-tester for interactive CLI/service testing:
+     ```
+     Task(subagent_type="oh-my-claudecode:qa-tester", model="sonnet", prompt="TEST:
+     Goal: [describe what to verify]
+     Service: [how to start]
+     Test cases: [specific scenarios to verify]")
+     ```
+
+2. **CHECK RESULT**: Did the goal pass?
+   - **YES** → Exit with success message
+   - **NO** → Continue to step 3
+
+3. **ARCHITECT DIAGNOSIS**: Spawn architect to analyze failure
+   ```
+   Task(subagent_type="oh-my-claudecode:architect", model="opus", prompt="DIAGNOSE FAILURE:
+   Goal: [goal type]
+   Output: [test/build output]
+   Provide root cause and specific fix recommendations.")
+   ```
+
+4. **FIX ISSUES**: Apply architect's recommendations
+   ```
+   Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="FIX:
+   Issue: [architect diagnosis]
+   Files: [affected files]
+   Apply the fix precisely as recommended.")
+   ```
+
+5. **REPEAT**: Go back to step 1
+
+## Exit Conditions
+
+| Condition | Action |
+|-----------|--------|
+| **Goal Met** | Exit with success: "ULTRAQA COMPLETE: Goal met after N cycles" |
+| **Cycle 5 Reached** | Exit with diagnosis: "ULTRAQA STOPPED: Max cycles. Diagnosis: ..." |
+| **Same Failure 3x** | Exit early: "ULTRAQA STOPPED: Same failure detected 3 times. Root cause: ..." |
+| **Environment Error** | Exit: "ULTRAQA ERROR: [tmux/port/dependency issue]" |
+
+## Observability
+
+Output progress each cycle:
+```
+[ULTRAQA Cycle 1/5] Running tests...
+[ULTRAQA Cycle 1/5] FAILED - 3 tests failing
+[ULTRAQA Cycle 1/5] Architect diagnosing...
+[ULTRAQA Cycle 1/5] Fixing: auth.test.ts - missing mock
+[ULTRAQA Cycle 2/5] Running tests...
+[ULTRAQA Cycle 2/5] PASSED - All 47 tests pass
+[ULTRAQA COMPLETE] Goal met after 2 cycles
+```
+
+## State Tracking
+
+Track state in `.omc/ultraqa-state.json`:
+```json
+{
+  "active": true,
+  "goal_type": "tests",
+  "goal_pattern": null,
+  "cycle": 1,
+  "max_cycles": 5,
+  "failures": ["3 tests failing: auth.test.ts"],
+  "started_at": "2024-01-18T12:00:00Z",
+  "session_id": "uuid"
+}
+```
+
+## Cancellation
+
+User can cancel with `/oh-my-claudecode:cancel-ultraqa` which clears the state file.
+
+## Important Rules
+
+1. **PARALLEL when possible** - Run diagnosis while preparing potential fixes
+2. **TRACK failures** - Record each failure to detect patterns
+3. **EARLY EXIT on pattern** - 3x same failure = stop and surface
+4. **CLEAR OUTPUT** - User should always know current cycle and status
+5. **CLEAN UP** - Clear state file on completion or cancellation
+
+---
+
+Begin ULTRAQA cycling now. Parse the goal and start cycle 1.

package/assets/skills/ultrawork.md

@@ -0,0 +1,93 @@
+---
+name: ultrawork
+description: Activate maximum performance mode with parallel agent orchestration for high-throughput task completion
+user-invocable: true
+---
+
+# Ultrawork Skill
+
+Activates maximum performance mode with parallel agent orchestration.
+
+## When Activated
+
+This skill enhances Claude's capabilities by:
+
+1. **Parallel Execution**: Running multiple agents simultaneously for independent tasks
+2. **Aggressive Delegation**: Routing tasks to specialist agents immediately
+3. **Background Operations**: Using `run_in_background: true` for long operations
+4. **Persistence Enforcement**: Never stopping until all tasks are verified complete
+5. **Smart Model Routing**: Using tiered agents to save tokens
+
+## Smart Model Routing (CRITICAL - SAVE TOKENS)
+
+**Choose tier based on task complexity: LOW (haiku) → MEDIUM (sonnet) → HIGH (opus)**
+
+### Available Agents by Tier
+
+| Domain | LOW (Haiku) | MEDIUM (Sonnet) | HIGH (Opus) |
+|--------|-------------|-----------------|-------------|
+| **Analysis** | `architect-low` | `architect-medium` | `architect` |
+| **Execution** | `executor-low` | `executor` | `executor-high` |
+| **Search** | `explore` | `explore-medium` | - |
+| **Research** | `researcher-low` | `researcher` | - |
+| **Frontend** | `designer-low` | `designer` | `designer-high` |
+| **Docs** | `writer` | - | - |
+| **Visual** | - | `vision` | - |
+| **Planning** | - | - | `planner`, `critic`, `analyst` |
+| **Testing** | - | `qa-tester` | - |
+| **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` |
+
+### Tier Selection Guide
+
+| Task Complexity | Tier | Examples |
+|-----------------|------|----------|
+| Simple lookups | LOW | "What does this function return?", "Find where X is defined" |
+| Standard work | MEDIUM | "Add error handling", "Implement this feature" |
+| Complex analysis | HIGH | "Debug this race condition", "Refactor auth module across 5 files" |
+
+### Routing Examples
+
+**CRITICAL: Always pass `model` parameter explicitly - Claude Code does NOT auto-apply models from agent definitions!**
+
+```
+// Simple question → LOW tier (saves tokens!)
+Task(subagent_type="oh-my-claudecode:architect-low", model="haiku", prompt="What does this function return?")
+
+// Standard implementation → MEDIUM tier
+Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="Add error handling to login")
+
+// Complex refactoring → HIGH tier
+Task(subagent_type="oh-my-claudecode:executor-high", model="opus", prompt="Refactor auth module using JWT across 5 files")
+
+// Quick file lookup → LOW tier
+Task(subagent_type="oh-my-claudecode:explore", model="haiku", prompt="Find where UserService is defined")
+
+// Thorough search → MEDIUM tier
+Task(subagent_type="oh-my-claudecode:explore-medium", model="sonnet", prompt="Find all authentication patterns in the codebase")
+```
+
+## Background Execution Rules
+
+**Run in Background** (set `run_in_background: true`):
+- Package installation: npm install, pip install, cargo build
+- Build processes: npm run build, make, tsc
+- Test suites: npm test, pytest, cargo test
+- Docker operations: docker build, docker pull
+
+**Run Blocking** (foreground):
+- Quick status checks: git status, ls, pwd
+- File reads, edits
+- Simple commands
+
+## Verification Checklist
+
+Before stopping, verify:
+- [ ] TODO LIST: Zero pending/in_progress tasks
+- [ ] FUNCTIONALITY: All requested features work
+- [ ] TESTS: All tests pass (if applicable)
+- [ ] ERRORS: Zero unaddressed errors
+
+**If ANY checkbox is unchecked, CONTINUE WORKING.**

package/dist/agents/index.d.ts

@@ -17,6 +17,10 @@
  * - critic (was: momus) - Plan review (Opus)
  * - vision - Visual/media analysis (Sonnet)
  * - scientist - Data analysis and research execution (New in v3.3.6)
+ *
+ * Dynamic Loading (v3.4.0):
+ * Agents are loaded from assets/agents/*.md files at runtime.
+ * Hardcoded definitions below serve as fallback.
  */
 export interface AgentDefinition {
     name: string;
@@ -122,7 +126,8 @@ export declare const scientistHighAgent: AgentDefinition;
  * Coordinator (Opus) - Master Orchestrator for complex multi-step tasks
  */
 export declare const coordinatorAgent: AgentDefinition;
-export declare const agents: Record<string, AgentDefinition>;
+declare let agents: Record<string, AgentDefinition>;
+export { agents };
 export declare function getAgent(name: string): AgentDefinition | undefined;
 export declare function listAgents(): AgentDefinition[];
 /**
@@ -137,3 +142,11 @@ export declare function isAlias(name: string): boolean;
  * Get the canonical (new) name for an agent
  */
 export declare function getCanonicalName(name: string): string;
+/**
+ * Force reload agents from disk (useful for hot-reloading during development)
+ */
+export declare function reloadAgents(): Promise<void>;
+/**
+ * Get the list of primary (non-alias) agent names
+ */
+export declare function getPrimaryAgentNames(): string[];

package/dist/agents/loader.d.ts

@@ -0,0 +1,13 @@
+import type { AgentDefinition } from './types.js';
+/**
+ * Parses agent markdown file with YAML frontmatter
+ */
+export declare function loadAgent(filepath: string): Promise<AgentDefinition>;
+/**
+ * Loads all agent definitions from a directory
+ */
+export declare function loadAllAgents(directory: string): Promise<Map<string, AgentDefinition>>;
+/**
+ * Gets the default agents directory path
+ */
+export declare function getAgentsDirectory(): string;

package/dist/agents/types.d.ts

@@ -0,0 +1,14 @@
+export interface AgentFrontmatter {
+    name: string;
+    description: string;
+    model?: 'haiku' | 'sonnet' | 'opus';
+    tools?: string;
+}
+export interface AgentDefinition {
+    name: string;
+    description: string;
+    systemPrompt: string;
+    model?: 'haiku' | 'sonnet' | 'opus';
+    readOnly: boolean;
+    tools: string[];
+}