@ngockhoale/ukit 2.7.0 → 2.7.2

package/templates/.codex/README.md

@@ -8,7 +8,7 @@ Auto-generated by UKit for OpenAI Codex.
 ## Core UKit Rule
 
 - Human-facing workflow should optimize for one remembered command: `ukit install`.
-- After install, normal work should feel natural inside **Claude/Codex/OpenCode/omp**.
+- After install, normal work should feel natural inside **Claude/Codex/omp**.
 - **Quality first, then speed, then token discipline**: do not waste reads, logs, or repeated helper output.
 - **Never stop after read-only steps.** For implement/apply/fix requests, continue to actual Edit/Write and verification in the same turn.
 

package/templates/.codex/settings.json

@@ -233,7 +233,6 @@
       },
       "agentContext": {
         "preserveClaudePreCompact": true,
-        "preserveOpenCodeCompaction": true,
         "codexSoftHandoff": {
           "autoCompact": true,
           "budgetTokens": 100000,

package/templates/.omp/README.md

@@ -26,19 +26,23 @@ whatever was there before, so local edits are never silently lost — they move,
 
 ## Model roles
 
-`.omp/config.yml` defines four roles. Agent frontmatter references them as `@lite` / `@code` /
-`@smart` / `@vision`, so retargeting a whole tier is a one-line edit in one file.
+`.omp/config.yml` defines omp's native roles `smol` / `default` / `slow` / `vision` plus
+back-compat aliases `lite` / `code` / `smart` that resolve to the same models. Agent frontmatter
+references the native roles as `@smol` / `@default` / `@slow` / `@vision`, so retargeting a whole
+tier is a one-line edit in one file — but remember the matching `lite`/`code`/`smart` alias is an
+independent key: edit it too, or it keeps resolving to the old value.
 
 | Role | Default model | Agents using it |
 |------|---------------|-----------------|
-| `lite` | `unic-lite` | `ukit-small-task-maintainer` |
-| `code` | `unic-code` | `feature-implementer`, `bug-debugger` |
-| `smart` | `unic-smart` | `handoff-planner`, `code-reviewer` |
+| `smol` (alias `lite`) | `unic-lite` | `ukit-small-task-maintainer` |
+| `default` (alias `code`) | `unic-code` | `feature-implementer`, `bug-debugger` |
+| `slow` (alias `smart`) | `unic-smart` | `handoff-planner`, `code-reviewer` |
 | `vision` | `unic-vision` | `ukit-vision-analyst` |
 
 These are **literal model names on the UNIC gateway, not aliases**, and they ship as the installed
-default. If this project does not run against UNIC, a maintainer swaps the three cost tiers for the
-values in `orchestration.modelTiers[*].claudeModel` in `.ukit/storage/config.json`.
+default. If this project does not run against UNIC, a maintainer swaps the three cost tiers
+(`smol`/`default`/`slow` — and their `lite`/`code`/`smart` aliases) for the values in
+`orchestration.modelTiers[*].claudeModel` in `.ukit/storage/config.json`.
 
 `vision` is the exception and stays `unic-vision` either way: it is a *capability* lane, not a cost
 tier. `unic-code` and `unic-smart` cannot read images on this gateway, so substituting one of them

package/templates/.omp/RULES.md

@@ -40,12 +40,12 @@ work really is, read the matching `SKILL.md` without being asked. Users never na
 ## 6. Delegate to bind a model tier
 
 Your own model does not change mid-turn. A tier only applies when work is handed to a task-agent in
-`.omp/agents/`, whose `model:` field (`@lite` / `@code` / `@smart` / `@vision`) resolves through
+`.omp/agents/`, whose `model:` field (`@smol` / `@default` / `@slow` / `@vision`) resolves through
 `modelRoles` in `.omp/config.yml`.
 
-- `tiny-fix` → `@lite` · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` →
-  `@code` · `review-release` → `@smart`
-- Images: `@vision` only. `@code`/`@smart` cannot see images on the UNIC gateway and must never
+- `tiny-fix` → `@smol` · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` →
+  `@default` · `review-release` → `@slow`
+- Images: `@vision` only. `@default`/`@slow` cannot see images on the UNIC gateway and must never
   guess at their contents — hand every image to `ukit-vision-analyst` first.
 
 Doing everything inline is exactly what makes UKit look like it only has one model. Keep direct
@@ -73,5 +73,6 @@ last thing you emit is one short line naming what is unfinished and what you nee
 a status — the user cannot distinguish it from a crash.
 
 > Maintainer note, not a per-turn rule: `modelRoles` in `.omp/config.yml` ships UNIC gateway names.
-> On a non-UNIC provider, edit only the three cost tiers — `lite`, `code`, `smart` — never `vision`,
-> which stays `unic-vision` because it is a capability lane, not a cost tier.
+> On a non-UNIC provider, edit only the three cost tiers — `smol`, `default`, `slow` — never `vision`,
+> which stays `unic-vision` (capability lane, not a cost tier). Old keys `lite`/`code`/`smart` remain
+> as compat aliases — edit each alias alongside its tier (smol↔lite, default↔code, slow↔smart).

package/templates/.omp/agents/bug-debugger.md

@@ -1,7 +1,7 @@
 ---
 name: bug-debugger
 description: "Debugging specialist for reproducible errors, failing tests, and unexpected behavior. Use proactively when investigation will involve noisy logs, stack traces, or a self-contained reproduce-trace-fix-verify loop. Do not use for trivial obvious fixes or broad architecture ideation."
-model: "@code"
+model: "@default"
 tools: ["read","grep","glob","bash","edit","ast_edit"]
 ---
 
@@ -49,7 +49,7 @@ Systematic debugging — understand before fixing.
 
 ```
 STATUS: DONE | BLOCKED | PARTIAL
-EXECUTOR_TOOL: [claude-code | kilo-code | codex | opencode | other]
+EXECUTOR_TOOL: [claude-code | kilo-code | codex | other]
 EXECUTOR_MODEL: [exact model name you are running as. "unknown" if you cannot tell.]
 EXECUTOR_SUBAGENT: [subagent name within your host, if any, else "-"]
 SUMMARY: [1-2 sentences — root cause and fix]

package/templates/.omp/agents/code-reviewer.md

@@ -1,7 +1,7 @@
 ---
 name: code-reviewer
 description: "Independent reviewer for handoff Phase 3, for spec/plan documents, and for non-blocking sidecar diff review of daily-flow edits. For code (default): use after executor reports STATUS: DONE on a handoff task, MUST run with a model different from the executor (configured in .ukit/storage/config.json → handoff.reviewer.model, default unic-smart), produces a verdict: APPROVED | APPROVED-WITH-MINOR | CHANGES-REQUESTED | CRITICAL. For spec/plan documents (set REVIEW_TARGET_TYPE=spec or plan): reviews a docs/plans/*.md file for completeness/consistency/clarity/scope/YAGNI, produces Status: Approved | Issues Found. For sidecar diff review (set REVIEW_TARGET_TYPE=diff): reviews the current uncommitted git diff after a local-build/shared-edit task, runs in the background and never blocks the main task, produces STATUS: clean | issues-found."
-model: "@smart"
+model: "@slow"
 tools: ["read","grep","glob","bash"]
 ---
 

package/templates/.omp/agents/feature-implementer.md

@@ -1,7 +1,7 @@
 ---
 name: feature-implementer
 description: "Implementation specialist for clear, self-contained coding tasks. Use proactively when the approach is clear and the work can be completed in a bounded pass with a concise summary. Do not use for trivial one-file tweaks or tightly coupled exploratory work."
-model: "@code"
+model: "@default"
 tools: ["read","edit","write","ast_edit","grep","glob","bash"]
 ---
 
@@ -71,7 +71,7 @@ and even then, report it, don't ask about it.
 
 ```
 STATUS: DONE | BLOCKED | PARTIAL
-EXECUTOR_TOOL: [claude-code | kilo-code | codex | opencode | other]
+EXECUTOR_TOOL: [claude-code | kilo-code | codex | other]
 EXECUTOR_MODEL: [exact model name you are running as — e.g. unic-code, claude-sonnet-4-5, gpt-5-mini. If you truly cannot tell, write "unknown" — reviewer treats unknown as suspicious and asks the human to confirm.]
 EXECUTOR_SUBAGENT: [name of the subagent you are, if your host has multiple — e.g. "Kilo:code", "Claude:feature-implementer". Otherwise "-".]
 SUMMARY: [1-2 sentences of what was implemented]

package/templates/.omp/agents/handoff-planner.md

@@ -1,7 +1,7 @@
 ---
 name: handoff-planner
 description: "Handoff planning specialist for Phase 1+2. Use when creating a new handoff cycle: writes PLAN.md with full test plan, splits into TASK-xxx.md files with TDD-embedded test cases, and updates INDEX.md. Always use the strongest available model (Opus/unic-smart)."
-model: "@smart"
+model: "@slow"
 tools: ["read","edit","write","ast_edit","glob","bash"]
 ---
 

package/templates/.omp/agents/ukit-small-task-maintainer.md

@@ -1,7 +1,7 @@
 ---
 name: ukit-small-task-maintainer
 description: "Internal UKit maintenance subagent for low-risk, reversible UKit decisions. Use proactively when UKit needs to decide or perform safe cleanup such as pruning docs/TASKS.md, classifying queued work, choosing whether compact/summarization is appropriate, summarizing local docs/status, or maintaining small UKit runtime queues. Do not use for product implementation, security, release/publish, data-loss, architecture, or risky/shared code changes."
-model: "@lite"
+model: "@smol"
 tools: ["read","grep","glob","edit","write","ast_edit"]
 blocking: false
 ---
@@ -11,7 +11,7 @@ You are UKit's internal small-task maintainer. You run as a sidecar/parallel/non
 ## Model Policy
 
 - Use the model selected by `subagents.smallTaskModel` when the host supports model selection for this subagent.
-- Default intended model: `unic-lite`.
+- Default intended model: `unic-lite` (frontmatter `@smol` resolves to `unic-lite` via `.omp/config.yml` modelRoles).
 - If the host cannot bind a model from config directly, still follow this role and report that the configured model is a hint.
 - This lane must run separately from the user's main task model. It must never replace, pause, or slow down the main task.
 
@@ -24,7 +24,7 @@ You are UKit's internal small-task maintainer. You run as a sidecar/parallel/non
 - Summarizing `docs/STATUS.md`, `docs/TASKS.md`, `docs/WORKLOG.md`, or memory snippets into compact handoff notes.
 - Deciding fast vs slow lane, safe vs risky lane, whether a skill should be activated, and whether the current prompt has enough steps planned.
 - Choosing compact-now vs compact-later and summarize-vs-keep-detail for UKit context hygiene.
-- Keeping agent context compact without removing existing lanes: Claude PreCompact/reinject stays active, OpenCode native auto/prune compaction stays active, and Codex Desktop soft handoffs use `compact.codexContext.compactTarget` (default 150 lines; preferred 120-150; hard max 170) while preserving critical state.
+- Keeping agent context compact without removing existing lanes: Claude PreCompact/reinject stays active and Codex Desktop soft handoffs use `compact.codexContext.compactTarget` (default 150 lines; preferred 120-150; hard max 170) while preserving critical state.
 - Small, reversible UKit runtime maintenance decisions.
 
 ## Never Use For
@@ -45,7 +45,7 @@ You are UKit's internal small-task maintainer. You run as a sidecar/parallel/non
 5. If safe, make the smallest cleanup/summary/classification/routing decision.
 6. Follow the CoDev priority order: output quality first, then safety, then speed, then token discipline. Spend tokens/steps when they protect correctness.
 7. Use small step budgets: trivial = 1 step, simple = up to 2 steps, non-trivial = up to 4 planned steps before the main model reassesses.
-8. For long sessions, preserve existing Claude/OpenCode auto-compact behavior; for Codex Desktop, target a compact handoff of about 120-150 lines, never above 170 lines for this lane, not a full transcript replay.
+8. For long sessions, preserve existing Claude auto-compact behavior; for Codex Desktop, target a compact handoff of about 120-150 lines, never above 170 lines for this lane, not a full transcript replay.
 9. Preserve user-owned content; do not delete unclear tasks.
 10. Report exactly what changed or what decision was made.
 

package/templates/.omp/config.yml

@@ -2,17 +2,23 @@
 # models may change during development; orchestration must not branch on vendor names.
 # Do NOT substitute sonnet/opus/haiku here. See PLAN.md §3 D15.
 #
-# Non-UNIC omp provider? A maintainer edits the three cost tiers to the values in
-# orchestration.modelTiers[*].claudeModel (.ukit/storage/config.json) — currently
-# lite: claude-haiku-4-5, code: claude-sonnet-5, smart: claude-opus-5.
+# Non-UNIC omp provider? A maintainer edits the three cost tiers — smol, default, slow —
+# to the values in orchestration.modelTiers[*].claudeModel (.ukit/storage/config.json) —
+# currently lite: claude-haiku-4-5, code: claude-sonnet-5, smart: claude-opus-5.
 # `vision` STAYS unic-vision: its claudeModel is already unic-vision, because
 # unic-code/unic-smart cannot read images on this gateway. claude-sonnet-5 is only
 # modelTiers.vision.fallbackModel, used when unicMode is off — never a drop-in here.
 modelRoles:
+  smol: unic-lite
+  default: unic-code
+  slow: unic-smart
+  vision: unic-vision
+  # Back-compat aliases — INDEPENDENT keys, not references. A maintainer overriding a
+  # cost tier above must edit the matching alias too (smol↔lite, default↔code,
+  # slow↔smart), or the alias keeps resolving to the old unic-* value.
   lite: unic-lite
   code: unic-code
   smart: unic-smart
-  vision: unic-vision
 
 tools:
   # TASK-009 / SPEC FR-003: the unattended approval surface is pinned HERE —

package/templates/AGENTS.md

@@ -4,7 +4,7 @@
 ## Core Rule
 <!-- RULES: CORE-01 CORE-02 -->
 - Human-facing UKit workflow collapses to one remembered command: `ukit install`.
-- After install, default to natural-language work inside **Claude Code / Codex / OpenCode / omp**.
+- After install, default to natural-language work inside **Claude Code / Codex / omp**.
 - **Quality first, then speed, then token discipline.**
 - **Never stop after read-only steps** — implement/apply/fix requests continue to Edit/Write + verification in the same turn.
 
@@ -136,29 +136,20 @@ CHỈ kích hoạt khi task đi qua `docs/AI_HANDOFF/` (user nói "execute task
 | code | `unic-code` | claude-sonnet | Normal coding, local fixes, shared edits, builds, debugging, impact mapping |
 | smart | `unic-smart` | claude-opus | Release review/audit, escalated deep reasoning after repeated failure |
 
-- A tier takes effect only when work is handed to an agent whose definition binds that model (`model:` frontmatter in `.claude/agents/*.md`; `model:` `@lite`/`@code`/`@smart`/`@vision` in `.omp/agents/*.md` via `modelRoles`) — the main session model never changes mid-turn.
+- A tier takes effect only when work is handed to an agent whose definition binds that model (`model:` frontmatter in `.claude/agents/*.md`; `model:` `@smol`/`@default`/`@slow`/`@vision` in `.omp/agents/*.md` via `modelRoles`) — the main session model never changes mid-turn.
 - Contract map: `tiny-fix` → lite · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` → code · `review-release` → smart. Escalation: same file/symbol failing `debugLoopThreshold` (default 2) times routes the next attempt one tier higher, capped at `smart`.
 - `unic-vision` is a capability lane, not a cost tier — unverified vision must never guess image contents; route images to `ukit-vision-analyst`. Harness table: `docs/UKIT_INTERNALS.md`.
 
-## Session Start — OpenCode
+## Project Owner Instructions — Codex
 
-<!-- RULE: HOST-OC-01 -->
-At the start of every OpenCode session, before working on the first task:
-1. Reuse matching route hints from `.claude/ukit/skill-router-state.json`; scan `.claude/skills/` (listing only) and read a SKILL.md only when a task triggers it.
-2. For every non-trivial task, run `/ukit-route <task summary>` for skill + context hints **before** writing code; if it names a skill, read that SKILL.md — do not skip. When `router.enabled: true` in `.ukit/storage/config.json`, prefer router output over guessing; treat it as internal continuation — continue to edit/verify, don't stop.
-
-## Project Owner Instructions — Codex and OpenCode
-
-When running in Codex or OpenCode, read and follow the root
+When running in Codex, read and follow the root
 `PROJECT_IMPORTANT.md` before doing project work. It is the canonical
 project-owner instruction source. Do not copy its contents into this file.
 If it is missing or unreadable, state that limitation and continue with the
 remaining project instructions.
-<!-- RULES: OWN-01 HOST-OWN-01 -->
+<!-- RULE: OWN-01 -->
 ## Skills
 - Canonical skills live in `.claude/skills/`; adapter mirrors may exist (`.codex/skills/` → symlink). **omp** reads `.claude/skills/` via its `claude` discovery provider.
-- **OpenCode**: reads `AGENTS.md` at session start only — it does NOT auto-load skills; the model must explicitly read the triggered SKILL.md.
-- `ukit-*` commands in `opencode.json` are internal helper entrypoints — never ask end users to run them.
 
 ## Project Snapshot
 - Project: {{project.name}} | Root: {{project.root}}

package/templates/CLAUDE.md

@@ -4,7 +4,7 @@
 ## Core Rule
 <!-- RULES: CORE-01 CORE-02 -->
 - Human-facing UKit workflow collapses to one remembered command: `ukit install`.
-- After install, default to natural-language work inside **Claude Code / Codex / OpenCode / omp**.
+- After install, default to natural-language work inside **Claude Code / Codex / omp**.
 - **Quality first, then speed, then token discipline.**
 - **Never stop after read-only steps** — implement/apply/fix requests continue to Edit/Write + verification in the same turn.
 
@@ -136,14 +136,12 @@ CHỈ kích hoạt khi task đi qua `docs/AI_HANDOFF/` (user nói "execute task
 | code | `unic-code` | claude-sonnet | Normal coding, local fixes, shared edits, builds, debugging, impact mapping |
 | smart | `unic-smart` | claude-opus | Release review/audit, escalated deep reasoning after repeated failure |
 
-- A tier takes effect only when work is handed to an agent whose definition binds that model (`model:` frontmatter in `.claude/agents/*.md`; `model:` `@lite`/`@code`/`@smart`/`@vision` in `.omp/agents/*.md` via `modelRoles`) — the main session model never changes mid-turn.
+- A tier takes effect only when work is handed to an agent whose definition binds that model (`model:` frontmatter in `.claude/agents/*.md`; `model:` `@smol`/`@default`/`@slow`/`@vision` in `.omp/agents/*.md` via `modelRoles`) — the main session model never changes mid-turn.
 - Contract map: `tiny-fix` → lite · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` → code · `review-release` → smart. Escalation: same file/symbol failing `debugLoopThreshold` (default 2) times routes the next attempt one tier higher, capped at `smart`.
 - `unic-vision` is a capability lane, not a cost tier — unverified vision must never guess image contents; route images to `ukit-vision-analyst`. Harness table: `docs/UKIT_INTERNALS.md`.
 
 ## Skills
 - Canonical skills live in `.claude/skills/`; adapter mirrors may exist (`.codex/skills/` → symlink). **omp** reads `.claude/skills/` via its `claude` discovery provider.
-- **OpenCode**: reads `AGENTS.md` at session start only — it does NOT auto-load skills; the model must explicitly read the triggered SKILL.md.
-- `ukit-*` commands in `opencode.json` are internal helper entrypoints — never ask end users to run them.
 
 ## Project Snapshot
 - Project: {{project.name}} | Root: {{project.root}}

package/templates/adapter-presets/claude/settings.local.json

@@ -31,7 +31,6 @@
       "WebFetch(domain:www.steveruiz.me)",
       "WebFetch(domain:desktopcommander.com)",
       "WebFetch(domain:gist.github.com)",
-      "WebFetch(domain:opencodedocs.com)",
       "WebFetch(domain:zenn.dev)",
       "WebFetch(domain:github.com)",
       "WebFetch(domain:gist.githubusercontent.com)",

package/templates/docs/AI_HANDOFF/INDEX.md

@@ -4,7 +4,7 @@
 Status values (xem RULES.md §Status state machine):
 ready | in_progress | pending_review | changes_requested | critical_block | approved | approved_minor | blocked | done
 
-Owner = tool đang giữ task: claude-code | kilo-code | codex | opencode | -
+Owner = tool đang giữ task: claude-code | kilo-code | codex | -
 -->
 
 | ID | Title | Priority | Size | Status | Owner | Reviewer | File |

package/templates/docs/AI_HANDOFF/RULES.md

@@ -92,12 +92,12 @@ Next: <bước kế tiếp chính xác>
 
 ## Handoff Flow (tool-agnostic, file-based state machine)
 
-UKit handoff hoạt động qua **file state**. Anh tự chọn tool nào cho từng phase — Claude Code / Kilo Code / Codex / OpenCode / tool mới sau này — đều được. UKit chỉ care về **role của model**, không care tool.
+UKit handoff hoạt động qua **file state**. Anh tự chọn tool nào cho từng phase — Claude Code / Kilo Code / Codex / tool mới sau này — đều được. UKit chỉ care về **role của model**, không care tool.
 
 3 phase × 3 role model:
 
 - **Plan** — model mạnh nhất anh có (reasoning model). Có thể chạy ở bất kỳ tool nào hỗ trợ planning tốt.
-- **Execute** — model rẻ-mà-vẫn-thông-minh (code model). Có thể là subagent code của Kilo, hay agent build của OpenCode, hay feature-implementer của Claude Code.
+- **Execute** — model rẻ-mà-vẫn-thông-minh (code model). Có thể là subagent code của Kilo, hay feature-implementer của Claude Code.
 - **Review** — **MODEL KHÁC executor** (reasoning model thường tốt hơn). Có thể là tool khác, hoặc cùng tool nhưng subagent khác model (ví dụ Kilo có subagent code và subagent review riêng).
 
 Hai mô hình triển khai đều hợp lệ:

package/templates/docs/PROJECT.md

@@ -37,7 +37,7 @@
 ## Delivery Profile
 
 - Primary workflow: natural-language AI tooling installed by UKit
-- Shared adapters: Claude Code, OpenAI Codex, OpenCode, omp (Oh My Pi)
+- Shared adapters: Claude Code, OpenAI Codex, omp (Oh My Pi)
 - Change policy: smallest correct change with clear verification
 
 ## Session Start Routine

package/templates/docs/UKIT_INTERNALS.md

@@ -8,7 +8,7 @@ natural language. None of it adds commands or user-facing surface.
 ## Long-Run Continuity — detail
 
 The root contract carries the LAND/DEFER/DELEGATE summary. This section mirrors what UKit
-hooks inject at runtime on Claude Code and omp; on harnesses without hooks (Codex, OpenCode)
+hooks inject at runtime on Claude Code and omp; on harnesses without hooks (Codex)
 the root contract is the only carrier — keep both in sync with
 `.claude/hooks/context-window-guard.sh`.
 
@@ -179,7 +179,7 @@ whose own definition binds that model.
 | Harness | Agent definitions | How to launch one |
 |---------|-------------------|-------------------|
 | Claude Code | `.claude/agents/*.md` (`model:` frontmatter) | Agent tool, `subagent_type: "<name>"` |
-| omp | `.omp/agents/*.md` (`model: "@lite"` / `"@code"` / `"@smart"` / `"@vision"`, resolved through `modelRoles` in `.omp/config.yml`) | task-agent `<name>` |
+| omp | `.omp/agents/*.md` (`model: "@smol"` / `"@default"` / `"@slow"` / `"@vision"`, resolved through `modelRoles` in `.omp/config.yml`) | task-agent `<name>` |
 
 When a task's contract maps to a tier other than the current session model, hand it to the
 matching agent instead of doing it inline. Doing everything inline is exactly what makes

package/templates/instructions/core.md

@@ -1,7 +1,7 @@
 ## Core Rule
 <!-- RULES: CORE-01 CORE-02 -->
 - Human-facing UKit workflow collapses to one remembered command: `ukit install`.
-- After install, default to natural-language work inside **Claude Code / Codex / OpenCode / omp**.
+- After install, default to natural-language work inside **Claude Code / Codex / omp**.
 - **Quality first, then speed, then token discipline.**
 - **Never stop after read-only steps** — implement/apply/fix requests continue to Edit/Write + verification in the same turn.
 
@@ -133,14 +133,12 @@ CHỈ kích hoạt khi task đi qua `docs/AI_HANDOFF/` (user nói "execute task
 | code | `unic-code` | claude-sonnet | Normal coding, local fixes, shared edits, builds, debugging, impact mapping |
 | smart | `unic-smart` | claude-opus | Release review/audit, escalated deep reasoning after repeated failure |
 
-- A tier takes effect only when work is handed to an agent whose definition binds that model (`model:` frontmatter in `.claude/agents/*.md`; `model:` `@lite`/`@code`/`@smart`/`@vision` in `.omp/agents/*.md` via `modelRoles`) — the main session model never changes mid-turn.
+- A tier takes effect only when work is handed to an agent whose definition binds that model (`model:` frontmatter in `.claude/agents/*.md`; `model:` `@smol`/`@default`/`@slow`/`@vision` in `.omp/agents/*.md` via `modelRoles`) — the main session model never changes mid-turn.
 - Contract map: `tiny-fix` → lite · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` → code · `review-release` → smart. Escalation: same file/symbol failing `debugLoopThreshold` (default 2) times routes the next attempt one tier higher, capped at `smart`.
 - `unic-vision` is a capability lane, not a cost tier — unverified vision must never guess image contents; route images to `ukit-vision-analyst`. Harness table: `docs/UKIT_INTERNALS.md`.
 
 ## Skills
 - Canonical skills live in `.claude/skills/`; adapter mirrors may exist (`.codex/skills/` → symlink). **omp** reads `.claude/skills/` via its `claude` discovery provider.
-- **OpenCode**: reads `AGENTS.md` at session start only — it does NOT auto-load skills; the model must explicitly read the triggered SKILL.md.
-- `ukit-*` commands in `opencode.json` are internal helper entrypoints — never ask end users to run them.
 
 ## Project Snapshot
 - Project: {{project.name}} | Root: {{project.root}}

package/templates/instructions/layout.yaml

@@ -62,8 +62,7 @@ outputs:
       - { from: core, heading: Adaptive Autonomy }
       - { from: core, heading: Unattended Completion Loop }
       - { from: core, heading: 3-Tier Model Routing }
-      - { from: 'overlay:agents', heading: Session Start — OpenCode }
-      - { from: 'overlay:agents', heading: Project Owner Instructions — Codex and OpenCode }
+      - { from: 'overlay:agents', heading: Project Owner Instructions — Codex }
       - { from: core, heading: Skills }
       - { from: core, heading: Project Snapshot }
       - { from: core, heading: Working Rules }
@@ -137,8 +136,7 @@ outputs:
       - { from: core, heading: Adaptive Autonomy }
       - { from: core, heading: Unattended Completion Loop }
       - { from: core, heading: 3-Tier Model Routing }
-      - { from: 'overlay:agents', heading: Session Start — OpenCode }
-      - { from: 'overlay:agents', heading: Project Owner Instructions — Codex and OpenCode }
+      - { from: 'overlay:agents', heading: Project Owner Instructions — Codex }
       - { from: core, heading: Skills }
       - { from: core, heading: Project Snapshot }
       - { from: core, heading: Working Rules }

package/templates/instructions/overlays/agents.md

@@ -1,15 +1,8 @@
-## Session Start — OpenCode
+## Project Owner Instructions — Codex
 
-<!-- RULE: HOST-OC-01 -->
-At the start of every OpenCode session, before working on the first task:
-1. Reuse matching route hints from `.claude/ukit/skill-router-state.json`; scan `.claude/skills/` (listing only) and read a SKILL.md only when a task triggers it.
-2. For every non-trivial task, run `/ukit-route <task summary>` for skill + context hints **before** writing code; if it names a skill, read that SKILL.md — do not skip. When `router.enabled: true` in `.ukit/storage/config.json`, prefer router output over guessing; treat it as internal continuation — continue to edit/verify, don't stop.
-
-## Project Owner Instructions — Codex and OpenCode
-
-When running in Codex or OpenCode, read and follow the root
+When running in Codex, read and follow the root
 `PROJECT_IMPORTANT.md` before doing project work. It is the canonical
 project-owner instruction source. Do not copy its contents into this file.
 If it is missing or unreadable, state that limitation and continue with the
 remaining project instructions.
-<!-- RULES: OWN-01 HOST-OWN-01 -->
+<!-- RULE: OWN-01 -->

package/templates/instructions/overlays/omp-rules.md

@@ -37,12 +37,12 @@ work really is, read the matching `SKILL.md` without being asked. Users never na
 ## 6. Delegate to bind a model tier
 
 Your own model does not change mid-turn. A tier only applies when work is handed to a task-agent in
-`.omp/agents/`, whose `model:` field (`@lite` / `@code` / `@smart` / `@vision`) resolves through
+`.omp/agents/`, whose `model:` field (`@smol` / `@default` / `@slow` / `@vision`) resolves through
 `modelRoles` in `.omp/config.yml`.
 
-- `tiny-fix` → `@lite` · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` →
-  `@code` · `review-release` → `@smart`
-- Images: `@vision` only. `@code`/`@smart` cannot see images on the UNIC gateway and must never
+- `tiny-fix` → `@smol` · `local-fix`, `local-build`, `shared-edit`, `find-cause`, `map-impact` →
+  `@default` · `review-release` → `@slow`
+- Images: `@vision` only. `@default`/`@slow` cannot see images on the UNIC gateway and must never
   guess at their contents — hand every image to `ukit-vision-analyst` first.
 
 Doing everything inline is exactly what makes UKit look like it only has one model. Keep direct
@@ -70,5 +70,6 @@ last thing you emit is one short line naming what is unfinished and what you nee
 a status — the user cannot distinguish it from a crash.
 
 > Maintainer note, not a per-turn rule: `modelRoles` in `.omp/config.yml` ships UNIC gateway names.
-> On a non-UNIC provider, edit only the three cost tiers — `lite`, `code`, `smart` — never `vision`,
-> which stays `unic-vision` because it is a capability lane, not a cost tier.
+> On a non-UNIC provider, edit only the three cost tiers — `smol`, `default`, `slow` — never `vision`,
+> which stays `unic-vision` (capability lane, not a cost tier). Old keys `lite`/`code`/`smart` remain
+> as compat aliases — edit each alias alongside its tier (smol↔lite, default↔code, slow↔smart).

package/templates/ukit/storage/config.json

@@ -53,11 +53,6 @@
           "mode": "precompact-reinject",
           "preserveExistingHooks": true
         },
-        "opencode": {
-          "autoCompact": true,
-          "mode": "native-auto-prune",
-          "preserveExistingCompaction": true
-        },
         "omp": {
           "autoCompact": true,
           "mode": "precompact-reinject",
@@ -147,19 +142,23 @@
     "modelTiers": {
       "lite": {
         "claudeModel": "claude-haiku-4-5",
-        "genericModel": "unic-lite"
+        "genericModel": "unic-lite",
+        "ompRole": "smol"
       },
       "code": {
         "claudeModel": "claude-sonnet-5",
-        "genericModel": "unic-code"
+        "genericModel": "unic-code",
+        "ompRole": "default"
       },
       "smart": {
         "claudeModel": "claude-opus-5",
-        "genericModel": "unic-smart"
+        "genericModel": "unic-smart",
+        "ompRole": "slow"
       },
       "vision": {
         "claudeModel": "unic-vision",
         "genericModel": "unic-vision",
+        "ompRole": "vision",
         "fallbackModel": "claude-sonnet-5",
         "capabilityTier": true,
         "note": "Capability tier, not a cost tier. Orthogonal to lite/code/smart — never insert into escalation.tierOrder. fallbackModel is used when unicMode is off."
@@ -506,11 +505,6 @@
             "mode": "precompact-reinject nghĩa là Claude được bơm context quan trọng trước/sau compact.",
             "preserveExistingHooks": "Nên giữ true để không gỡ PreCompact/reinject của Claude."
           },
-          "opencode": {
-            "autoCompact": "Giữ compact lane của OpenCode bật.",
-            "mode": "native-auto-prune nghĩa là OpenCode dùng compaction.auto/prune native.",
-            "preserveExistingCompaction": "Nên giữ true để không gỡ compact native của OpenCode."
-          },
           "omp": {
             "autoCompact": "Giữ compact lane của omp (Oh My Pi) bật.",
             "mode": "precompact-reinject nghĩa là UKit dùng hook session.compacting/session_before_compact của omp để bơm lại context quan trọng trước khi compact.",

package/templates/adapter-presets/opencode/opencode.template.json

@@ -1 +0,0 @@
-{"$schema":"https://opencode.ai/config.json","default_agent":"build","share":"disabled","compaction":{"auto":true,"prune":true,"reserved":10000},"watcher":{"ignore":[".git/**","node_modules/**",".cache/**",".ukit/**",".claude/ukit/permission-usage.json",".claude/ukit/permission-audit.log"]},"permission":{"doom_loop":"deny"},"command":{"ukit-route":{"description":"Internal shared UKit route. Run at the start of every non-trivial task to get skill and context hints before writing code.","agent":"build","template":"Run `node .claude/ukit/index/route-task.mjs \"<task>\" --adapter opencode`; reuse `.claude/ukit/skill-router-state.json`."},"ukit-context":{"description":"Internal UKit context.","agent":"build","template":"Run `node .claude/ukit/index/resolve-context.mjs \"<intent>\" [--target <file>]`."},"ukit-verify":{"description":"Internal UKit verify lane.","agent":"build","template":"Run `node .claude/ukit/index/verify-context.mjs \"<intent>\" [--target <file>]`."},"ukit-triage":{"description":"Internal UKit triage.","agent":"build","template":"Run `node .claude/ukit/index/triage.mjs \"<error>\"`."},"ukit-query":{"description":"Internal UKit query.","agent":"build","template":"Run `node .claude/ukit/index/query-index.mjs \"<error|symbol|path>\"`."},"ukit-index":{"description":"Internal UKit index.","agent":"build","template":"Run `node .claude/ukit/index/refresh-index.mjs` (fallback: `node .claude/ukit/index/build-index.mjs`)."},"ukit-handoff-status":{"description":"Handoff dashboard — show current cycle status (read-only).","agent":"build","template":"Read `docs/AI_HANDOFF/INDEX.md`, `docs/AI_HANDOFF/ACTIVE.md`, and `docs/AI_HANDOFF/PLAN.md`. Report: active cycle name, task table with status, any blockers. No writes."},"ukit-handoff-create":{"description":"Create a new handoff cycle — Phase 1+2: write PLAN.md + TASK-xxx.md files.","agent":"build","template":"Read `.claude/commands/ukit/create-handoff.md` for full instructions, then execute. Description: <what to build>"},"ukit-handoff-implement":{"description":"Execute handoff tasks — Phase 3: implement the next Ready task.","agent":"build","template":"Read `.claude/commands/ukit/implement-handoff.md` for full instructions, then execute. Task ID (optional): <TASK-xxx>"},"ukit-handoff-review":{"description":"Review handoff results — Phase 4: verify implementation and give verdict.","agent":"build","template":"Read `.claude/commands/ukit/review-handoff.md` for full instructions, then execute. Task ID (optional): <TASK-xxx>"},"ukit-handoff-clear":{"description":"Archive and reset the current handoff cycle.","agent":"build","template":"Read `.claude/commands/ukit/clear-handoff.md` for full instructions, then execute."}},"agent":{"build":{"description":"UKit build agent. Follow AGENTS.md. For every non-trivial task: run /ukit-route first, use index-first loop, activate matching skill, never claim done after read-only steps. Keep internal ukit-* helpers hidden; users only need ukit install.","permission":{"edit":"allow","task":"allow","skill":"allow","bash":{"*":"ask","pwd":"allow","ls":"allow","ls *":"allow","find *":"allow","rg *":"allow","grep *":"allow","cat *":"allow","sed *":"allow","head *":"allow","tail *":"allow","wc *":"allow","echo *":"allow","printf *":"allow","awk *":"allow","tr *":"allow","cut *":"allow","sort *":"allow","uniq *":"allow","diff *":"allow","jq *":"allow","stat *":"allow","file *":"allow","which *":"allow","date *":"allow","basename *":"allow","dirname *":"allow","realpath *":"allow","xargs *":"allow","mkdir *":"allow","touch *":"allow","cp *":"allow","vitest *":"allow","jest *":"allow","git status":"allow","git status *":"allow","git diff":"allow","git diff *":"allow","git log":"allow","git log *":"allow","git show *":"allow","git grep *":"allow","git rev-parse *":"allow","git branch *":"allow","git stash list":"allow","git ls-files *":"allow","git tag *":"allow","git add *":"allow","git checkout *":"allow","git switch *":"allow","git restore *":"allow","git mv *":"allow","mv *":"allow","node *":"allow","node .claude/ukit/index/*":"allow","node .claude/ukit/runtime/*":"allow","npx *":"allow","npm test":"allow","npm test *":"allow","{{runtime.packageManager}} test":"allow","{{runtime.packageManager}} test *":"allow","{{runtime.packageManager}} lint":"allow","{{runtime.packageManager}} lint *":"allow","{{runtime.packageManager}} typecheck":"allow","{{runtime.packageManager}} typecheck *":"allow","{{runtime.packageManager}} build":"allow","{{runtime.packageManager}} build *":"allow","npm run test":"allow","npm run test *":"allow","npm run lint":"allow","npm run lint *":"allow","npm run typecheck":"allow","npm run typecheck *":"allow","npm run build":"allow","npm run build *":"allow","pnpm test":"allow","pnpm test *":"allow","pnpm lint":"allow","pnpm lint *":"allow","pnpm typecheck":"allow","pnpm typecheck *":"allow","pnpm build":"allow","pnpm build *":"allow","pnpm run test":"allow","pnpm run test *":"allow","pnpm run lint":"allow","pnpm run lint *":"allow","pnpm run typecheck":"allow","pnpm run typecheck *":"allow","pnpm run build":"allow","pnpm run build *":"allow","bun test":"allow","bun test *":"allow","bun run test":"allow","bun run test *":"allow","bun run lint":"allow","bun run lint *":"allow","bun run typecheck":"allow","bun run typecheck *":"allow","bun run build":"allow","bun run build *":"allow","git commit":"allow","git commit *":"allow","git push":"allow","git push *":"allow","git clean":"deny","git clean *":"deny","git reset":"deny","git reset *":"deny","rm *":"deny"}}},"plan":{"permission":{"edit":"ask","bash":"ask"}}}}