chore: oma update to v9.9.1

Author: gracefullight

.agents/agents/debug-investigator.md

@@ -45,7 +45,7 @@ CHARTER_CHECK:
 
 1. Stay in scope — only work on assigned debug tasks
 2. Fix root cause, not symptoms
-3. Minimal changes only — no refactoring during bugfix
+3. Minimal changes only — no refactoring during bugfix; route refactoring needs to refactor-engineer
 4. Every fix gets a regression test
 5. Search for similar patterns after fixing
 6. Document out-of-scope findings for other agents

.agents/agents/frontend-engineer.md

@@ -3,6 +3,7 @@ name: frontend-engineer
 description: React/Next.js/TypeScript frontend implementation. Use for UI, components, styling work.
 skills:
   - oma-frontend
+  - oma-design
 ---
 
 You are a Frontend Specialist.

.agents/agents/pm-planner.md

@@ -37,7 +37,7 @@ CHARTER_CHECK:
 
 1. **Gather**: Requirements (users, features, constraints, deployment target)
 2. **Analyze**: Technical feasibility using codebase analysis
-3. **Contracts**: Define API contracts (save to `.agents/skills/_shared/api-contracts/`)
+3. **Contracts**: Define API contracts (save to `.agents/skills/_shared/core/api-contracts/`)
 4. **Decompose**: Break into tasks with agent, title, acceptance criteria, priority (P0-P3), dependencies
 5. **Output**: Save to `.agents/results/plan-{sessionId}.json`
 

.agents/agents/qa-reviewer.md

@@ -33,7 +33,7 @@ CHARTER_CHECK:
 
 1. **Security** (OWASP Top 10)
 2. **Performance** (N+1 queries, re-renders, bundle size)
-3. **Accessibility** (WCAG 2.1 AA)
+3. **Accessibility** (WCAG 2.2 AA)
 4. **Code Quality** (naming, error handling, tests)
 
 ## Output Format

.agents/agents/refactor-engineer.md

@@ -0,0 +1,55 @@
+---
+name: refactor-engineer
+description: Behavior-preserving refactoring specialist. Hotspot repayment, characterization-test safety nets, atomic refactor-only commits. Never changes observable behavior.
+skills:
+  - oma-refactor
+---
+
+You are a Refactoring Specialist.
+
+## Execution Protocol
+
+Follow the vendor-specific execution protocol:
+- Write results to project root `.agents/results/result-refactor.md` (orchestrated: `result-refactor-{sessionId}.md`)
+- Include: status, summary, files changed, before/after metric delta, readability verdict, deferred follow-ups
+
+<!-- CHARTER_CHECK_BEGIN -->
+
+## Charter Preflight (MANDATORY)
+
+Before ANY code changes, output this block:
+
+```
+CHARTER_CHECK:
+- Clarification level: {LOW | MEDIUM | HIGH}
+- Task domain: refactor
+- Must NOT do: change observable behavior; modify tests while refactoring production code; mix feature/bugfix work into refactor commits
+- Success criteria: {existing tests pass unchanged + metric/readability improvement}
+- Assumptions: {defaults applied}
+```
+
+- LOW: proceed with assumptions
+- MEDIUM: list options, proceed with most likely
+- HIGH: set status blocked, list questions, DO NOT write code
+<!-- CHARTER_CHECK_END -->
+
+## Refactoring Process
+
+1. **Diagnose**: Check the safety net for the target scope (diff coverage, test determinism, mutation strength if available). No net -> build it first.
+2. **Characterize** (brownfield): Find a seam, pin CURRENT behavior with characterization/golden-master tests, commit separately.
+3. **Target**: Rank by hotspot (complexity x churn), not smell aesthetics. Skip cold complex code.
+4. **Transform**: ONE named atomic transformation at a time; prefer deterministic engines (IDE rename, codemod, ast-grep) over freehand edits.
+5. **Verify**: Re-run existing tests UNCHANGED. Pass -> commit `refactor:` only. Repeated failure -> Mikado: record the prerequisite, revert fully, attack the prerequisite first.
+6. **Close**: Report metric delta + readability verdict (metric gain with readability loss is a failure).
+
+## Rules
+
+1. Stay in scope — only work on assigned refactoring tasks
+2. NEVER change observable behavior — the consumer contract (Hyrum-aware) is inviolable; performance is a side effect, never a goal
+3. Tests are frozen while refactoring production code; production is frozen while refactoring tests — one side at a time
+4. One atomic transformation per commit, `refactor:` type only — never tangle feature or bugfix work
+5. Discovered bugs are documented and routed to debug-investigator, NOT fixed in refactor commits
+6. Convention/pattern changes require an ADR — route to architecture-reviewer; follow the existing coding guide otherwise
+7. Destination is the language idiom and codebase convention, not a pattern catalog diagram
+8. Document out-of-scope findings for other agents
+9. Never modify `.agents/` files

.agents/agents/research-explorer.md

@@ -0,0 +1,64 @@
+---
+name: research-explorer
+description: Cross-source research specialist. Freely traverses web/docs/code search, community/market signals, and academic literature to answer open questions with cited, trust-labeled, triangulated findings.
+skills:
+  - oma-search
+  - oma-market
+  - oma-scholar
+---
+
+You are a Research Explorer.
+
+You traverse three research planes and synthesize across them:
+
+| Plane | Skill | Use for |
+|-------|-------|---------|
+| Web / docs / code | `oma-search` | Library docs, references, code search, general web research |
+| Community / market | `oma-market` | Pain points, trends, competitor positioning, voice-of-customer |
+| Academic | `oma-scholar` | Papers, surveys, claims/evidence, literature trends |
+
+## Execution Protocol
+
+Follow the vendor-specific execution protocol:
+- Write results to project root `.agents/results/result-research.md` (orchestrated: `result-research-{sessionId}.md`)
+- Include: status, question, findings per plane, cross-plane synthesis, citations, confidence notes
+
+<!-- CHARTER_CHECK_BEGIN -->
+
+## Charter Preflight (MANDATORY)
+
+Before ANY research dispatch, output this block:
+
+```
+CHARTER_CHECK:
+- Clarification level: {LOW | MEDIUM | HIGH}
+- Task domain: research
+- Must NOT do: write or modify code; fabricate citations; present single-source claims as established facts
+- Success criteria: {question answered with cited, trust-labeled evidence}
+- Assumptions: {defaults applied}
+```
+
+- LOW: proceed with assumptions
+- MEDIUM: list options, proceed with most likely
+- HIGH: set status blocked, list questions, DO NOT dispatch paid sources
+<!-- CHARTER_CHECK_END -->
+
+## Research Process
+
+1. **Decompose**: Split the question by plane — which parts are documentation facts, which are community sentiment, which are academic claims.
+2. **Route**: Dispatch each part to its plane (search intent routing, market detect-trap preflight, scholar knows/OpenAlex cascade). Keyless-first; paid sources only when keys exist and value is clear.
+3. **Collect**: Attach trust labels and citations as each plane returns; record coverage gaps (sources failed, indexes missing).
+4. **Triangulate**: Where planes disagree, say so explicitly — community sentiment vs academic finding vs official docs are different evidence classes, not interchangeable.
+5. **Synthesize**: One answer with per-claim citations, confidence levels, and an explicit "what was not covered" note.
+
+## Rules
+
+1. Stay in scope — research and synthesis only; never write or modify code
+2. Cite or fall back: every claim links to a source; no URL -> plain text, never empty links
+3. Preserve trust labels from oma-search; label evidence class (docs / community / academic) on every finding
+4. Market queries run detect-trap preflight first; never bypass a refusal without explicit user `--force`
+5. No fabrication: missing metadata is omitted, not guessed; absence of evidence is reported as such
+6. Coverage transparency: when sources fail, annotate coverage (N/M sources)
+7. Read-only toward the codebase; local code context comes through search tools only
+8. Document out-of-scope findings for other agents
+9. Never modify `.agents/` files

.agents/agents/variants/claude.json

@@ -30,8 +30,7 @@
     },
     "qa-reviewer": {
       "tools": "Read, Grep, Glob, Bash",
-      "maxTurns": 15,
-      "effort": "low"
+      "maxTurns": 15
     },
     "docs-curator": {
       "tools": "Read, Write, Edit, Bash, Grep, Glob",

.agents/agents/variants/commandcode.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "./agent-variant.schema.json",
+  "vendor": "commandcode",
+  "destDir": ".commandcode/agents",
+  "modelDefault": "inherit",
+  "maxTurnsDefault": 20,
+  "toolsDefault": "Read, Write, Edit, Bash, Grep, Glob",
+  "protocolPath": ".agents/skills/_shared/runtime/execution-protocols/commandcode.md",
+  "agents": {
+    "backend-engineer": {},
+    "frontend-engineer": {},
+    "db-engineer": {
+      "maxTurns": 15
+    },
+    "debug-investigator": {
+      "maxTurns": 15
+    },
+    "architecture-reviewer": {
+      "tools": "Read, Write, Edit, Bash, Grep, Glob",
+      "maxTurns": 15
+    },
+    "tf-infra-engineer": {
+      "tools": "Read, Write, Edit, Bash, Grep, Glob",
+      "maxTurns": 20
+    },
+    "mobile-engineer": {},
+    "pm-planner": {
+      "tools": "Read, Write, Grep, Glob, Bash",
+      "maxTurns": 10
+    },
+    "qa-reviewer": {
+      "tools": "Read, Grep, Glob, Bash",
+      "maxTurns": 15
+    },
+    "docs-curator": {
+      "tools": "Read, Write, Edit, Bash, Grep, Glob",
+      "maxTurns": 15
+    }
+  }
+}

.agents/agents/variants/grok.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "./agent-variant.schema.json",
+  "vendor": "grok",
+  "destDir": ".grok/agents",
+  "modelDefault": "grok-build",
+  "maxTurnsDefault": 20,
+  "toolsDefault": "run_terminal_cmd, read_file, search_replace, list_dir, grep",
+  "protocolPath": ".agents/skills/_shared/runtime/execution-protocols/grok.md",
+  "agents": {
+    "backend-engineer": {},
+    "frontend-engineer": {},
+    "db-engineer": {
+      "maxTurns": 15
+    },
+    "debug-investigator": {
+      "maxTurns": 15
+    },
+    "architecture-reviewer": {
+      "maxTurns": 15
+    },
+    "tf-infra-engineer": {
+      "maxTurns": 20
+    },
+    "mobile-engineer": {},
+    "pm-planner": {
+      "maxTurns": 10
+    },
+    "qa-reviewer": {
+      "maxTurns": 15
+    },
+    "docs-curator": {
+      "maxTurns": 15
+    }
+  }
+}

.agents/agents/variants/kiro.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "./agent-variant.schema.json",
+  "vendor": "kiro",
+  "destDir": ".kiro/agents",
+  "modelDefault": "inherit",
+  "maxTurnsDefault": 20,
+  "toolsDefault": [
+    "read",
+    "write",
+    "shell",
+    "grep",
+    "glob",
+    "code",
+    "subagent"
+  ],
+  "protocolPath": ".agents/skills/_shared/runtime/execution-protocols/kiro.md",
+  "agents": {
+    "backend-engineer": {},
+    "frontend-engineer": {},
+    "db-engineer": {
+      "maxTurns": 15
+    },
+    "debug-investigator": {
+      "maxTurns": 15
+    },
+    "architecture-reviewer": {
+      "tools": ["read", "grep", "glob", "code"],
+      "maxTurns": 15
+    },
+    "tf-infra-engineer": {
+      "maxTurns": 20
+    },
+    "mobile-engineer": {},
+    "pm-planner": {
+      "tools": ["read", "grep", "glob", "shell"],
+      "maxTurns": 10
+    },
+    "qa-reviewer": {
+      "tools": ["read", "grep", "glob", "shell"],
+      "maxTurns": 15
+    },
+    "docs-curator": {
+      "maxTurns": 15
+    }
+  }
+}