ocmm 0.5.0 → 0.5.2

package/plugins/deepwork/skills/frontend/SKILL.md

@@ -96,7 +96,7 @@ Domains: `product` `style` `typography` `color` `landing` `chart` `ux` `react` `
 
 ## Shared axioms (all three rulesets agree — apply always)
 
-- **No design system = no UI work.** `DESIGN.md` exists before components do; every color, font size, and spacing value traces back to a token in it.
+- **No design system = no UI work.** `DESIGN.md` exists before components do; every color, font size, and spacing value traces back to a token in it. For greenfield UI, its `## 0. Research Log` records the local design candidates and selected direction before product screens are built.
 - **Never weaken UX to buy points.** No dropping animations, hiding content, or simplifying interactions for a score or a deadline.
 - **No emojis as icons.** SVG icon sets only (Lucide, Heroicons, Radix, Phosphor).
 - **GPU-composited animation only** — `transform`, `opacity`, `filter`; never animate layout properties.
@@ -117,5 +117,6 @@ Use for any frontend, web UI, UX, visual, design, styling, layout, animation, pe
 ## Codex Compatibility
 
 - When this skill mentions TodoWrite, use Codex `update_plan`.
-- When this skill mentions OpenCode `task(...)`, use the current callable Codex subagent-dispatch tool and preserve the task contract; prefer an exact profile selector, then complete direct composition, then generic/flat dispatch with role and required skills in the message.
+- When this skill mentions OpenCode `task(...)`, use the current callable Codex subagent-dispatch tool and preserve the task contract. Treat an agent_type, agent_path, or agent_nickname field as an exact profile selector only when its current schema or documentation explicitly guarantees that behavior; otherwise prefer complete direct composition, then generic/flat dispatch.
+- A generic/flat child message must be self-contained and labeled `TASK`, `ROLE`, `DELIVERABLE`, `SCOPE`, `VERIFY`, `REQUIRED SKILLS`, `CONTEXT`, and `CONSTRAINTS`; do not claim it loaded a `dw-*` profile.
 - When this skill mentions OpenCode-specific tool names, choose the nearest Codex tool with the same intent and preserve the workflow contract.

package/plugins/deepwork/skills/frontend/references/design/README.md

@@ -34,8 +34,9 @@ Before touching any UI code, before routing to any reference, before even thinki
 2. Explore the project: what is the product domain? Who are the users? What feeling should it evoke?
 3. If the project has existing UI code, **extract** the implicit system (colors, fonts, spacing already in use) rather than inventing from scratch.
 4. If the project is greenfield, **ask the user one question**: "What should this feel like?" — or infer from context.
-5. Write `DESIGN.md` at project root following the 7-section structure from the reference.
-6. **Do not proceed to any component implementation until `DESIGN.md` exists and is committed to context.**
+5. For greenfield UI, start `DESIGN.md` with `## 0. Research Log`: record 2-3 relevant local Layer B/design candidates, the selected Layer A + Layer B and rationale, and any optional evidence from `ui-ux-db`, a user-provided image, or a local mockup. If a source/tool is unavailable or irrelevant, record why; do not force network research.
+6. Write `DESIGN.md` at project root following the nine-section structure from the reference.
+7. **Do not proceed to any component implementation until `DESIGN.md` exists and is committed to context.**
 
 #### If YES design system exists → READ IT, FOLLOW IT
 
@@ -46,6 +47,10 @@ Before touching any UI code, before routing to any reference, before even thinki
 
 **This gate is non-negotiable. No design system = no UI work. Period.**
 
+### Primitive Showcase Gate (MANDATORY for greenfield product UI)
+
+Before building a product screen, add the intended primitives and states to `DESIGN.md` Section 5 under `Planned Showcase Primitives`. This is a pre-implementation verification checklist, not reusable component documentation. Verify each relevant primitive in a component showcase or equivalent state page: default, hover, focus, disabled, loading, empty, and error. Keep component documentation only for implemented reusable patterns used 2+ times. For runnable UI, retain real-browser validation at 375 / 768 / 1280px; when a runnable surface is unavailable, state exactly which states and breakpoints were not verified rather than claiming the gate passed.
+
 
 ## Phase 0.5 — React Dev Tooling Gate (MANDATORY for React projects)
 
@@ -180,7 +185,8 @@ Once references are loaded, before writing any UI code:
 6. **Server vs client components (Next.js).** If motion/state/portals are involved, isolate as a `'use client'` leaf component. Don't bleed `'use client'` to the page level.
 7. **Match the project's existing patterns FIRST.** If the codebase already uses CSS Modules, don't introduce Tailwind. If it uses styled-components, don't introduce CSS-in-JS variants. The references guide *style*, not *infrastructure*.
 8. **All tokens trace back to `DESIGN.md`.** No orphan hex codes, no magic px values. If you need a new token, update `DESIGN.md` first.
-9. **New reusable patterns (used 2+ times) get documented back into `DESIGN.md` Section 5.**
+9. **Implemented reusable patterns used 2+ times get documented back into `DESIGN.md` Section 5.**
+10. **Greenfield product screens passed the Primitive Showcase Gate.** Complete the Section 5 `Planned Showcase Primitives` pre-implementation verification checklist for default, hover, focus, disabled, loading, empty, and error states before composing them into a product screen; the checklist is not reusable component documentation.
 
 ## Quick lookup table — most common requests
 

package/plugins/deepwork/skills/frontend/references/design/design-system-architecture.md

@@ -15,11 +15,19 @@ Every frontend project MUST have a `DESIGN.md` at its root. This file is the sin
 
 ## DESIGN.md Structure
 
-The file has 7 sections. Every section is mandatory. Skip nothing.
+The file has nine sections, numbered 0 through 8. Every section is mandatory. Skip nothing. Section 0 applies to greenfield UI; existing-project extraction may state that historical research is unavailable instead of inventing it.
 
 ```markdown
 # [Project Name] Design System
 
+## 0. Research Log
+
+For greenfield UI, record the design decision before writing product screens.
+
+- **Candidates considered**: 2-3 relevant local Layer B/design references, with a short reason each fits or does not fit.
+- **Selection**: the chosen Layer A execution skill and Layer B/design reference, with rationale tied to the product and audience.
+- **Evidence (optional)**: a local `ui-ux-db` lookup, user-provided image, or local mockup. If a tool/source is unavailable or not relevant, record the reason instead of forcing network research.
+
 ## 1. Atmosphere & Identity
 
 One paragraph. What this product FEELS like. Not what it does — how it feels to use.
@@ -112,18 +120,23 @@ All spacing derives from a base of **4px**.
 
 ## 5. Components
 
-Document reusable patterns as they emerge. Format:
+### Planned Showcase Primitives
+
+This is a pre-implementation verification checklist, not reusable component documentation. Before composing a greenfield product screen, list each intended primitive and check its applicable default, hover, focus, disabled, loading, empty, and error states in a component showcase or equivalent state page.
+
+### Implemented Reusable Patterns
+
+Document only implemented reusable patterns used 2+ times. Format:
 
 ### [Component Name]
 - **Structure**: HTML/JSX outline
 - **Variants**: list
 - **Spacing**: which tokens
-- **States**: default, hover, active, focus, disabled, loading, error
+- **States**: default, hover, active, focus, disabled, loading, empty, error
 - **Accessibility**: keyboard, ARIA, contrast
 - **Motion**: entry/exit animations
 
-Start with components used 2+ times. Do not pre-document components
-that don't exist yet.
+Do not promote planned primitives or one-off implementations into reusable component documentation.
 
 ## 6. Motion & Interaction
 
@@ -162,6 +175,20 @@ If borders:
 
 If tonal-shift:
 Surfaces use progressively lighter/darker shades. No borders, no shadows.
+
+## 8. Accessibility Constraints & Accepted Debt
+
+### Constraints
+
+- **WCAG goal**: state the target level and the testable scope.
+- **Contrast**: document text, control, and focus-indicator contrast requirements.
+- **Keyboard and focus**: every interactive primitive has a keyboard path and visible focus treatment.
+- **ARIA**: semantic HTML first; document required names, roles, and live-region behavior for custom controls.
+- **Reduced motion**: respect `prefers-reduced-motion` and identify any essential motion.
+
+### Accepted Debt
+
+Each exception records its location, reason, owner, and exit criteria. An agent may not accept accessibility debt or a constraint exception silently: it requires explicit user authorization.
 ```
 
 ## Creation Workflow
@@ -169,13 +196,15 @@ Surfaces use progressively lighter/darker shades. No borders, no shadows.
 ### For New Projects
 
 1. **Ask or infer the product domain** — SaaS dashboard? Marketing site? Dev tool?
-2. **Write the Atmosphere paragraph** — one chance to establish identity.
-3. **Define palette** — derive from atmosphere. Not random. Not generic.
-4. **Set typography** — match the atmosphere. Editorial = serif. Technical = mono-heavy. Clean = geometric sans.
-5. **Lock spacing** — base-4 system. Customize only the section-level values.
-6. **Document initial components** — only those you are about to build.
-7. **Choose depth strategy** — one. Not "a mix."
-8. **Write it to `DESIGN.md`** at project root.
+2. **Write the Research Log** — consider 2-3 relevant local design candidates, select Layer A + Layer B, and record optional local evidence or why it was unavailable.
+3. **Write the Atmosphere paragraph** — one chance to establish identity.
+4. **Define palette** — derive from atmosphere. Not random. Not generic.
+5. **Set typography** — match the atmosphere. Editorial = serif. Technical = mono-heavy. Clean = geometric sans.
+6. **Lock spacing** — base-4 system. Customize only the section-level values.
+7. **Fill in Planned Showcase Primitives** — use the pre-implementation verification checklist to cover intended primitives and states before composing a product screen; do not treat it as reusable component documentation.
+8. **Choose depth strategy** — one. Not "a mix."
+9. **Set accessibility constraints and record no debt without user authorization.**
+10. **Write it to `DESIGN.md`** at project root.
 
 ### For Existing Projects (Extraction)
 
@@ -194,8 +223,10 @@ After every component implementation, check:
 - [ ] All spacing values are multiples of `--space-1` (4px). No magic numbers.
 - [ ] Interactive elements have all required states from Section 6.
 - [ ] Depth treatment matches the chosen strategy from Section 7.
-- [ ] Component reused 2+ times? Documented in Section 5.
+- [ ] Implemented reusable pattern used 2+ times? Documented in Section 5.
 - [ ] Motion follows the timing table. No arbitrary durations.
+- [ ] `Planned Showcase Primitives` is complete for greenfield UI, with a showcase (or equivalent state page) covering default, hover, focus, disabled, loading, empty, and error before product-screen composition.
+- [ ] Section 8 constraints were checked; any accepted debt has location, reason, owner, exit criteria, and explicit user authorization.
 
 ## Memory Management
 

package/plugins/deepwork/skills/git-master/SKILL.md

@@ -102,5 +102,6 @@ Before finishing:
 ## Codex Compatibility
 
 - When this skill mentions TodoWrite, use Codex `update_plan`.
-- When this skill mentions OpenCode `task(...)`, use the current callable Codex subagent-dispatch tool and preserve the task contract; prefer an exact profile selector, then complete direct composition, then generic/flat dispatch with role and required skills in the message.
+- When this skill mentions OpenCode `task(...)`, use the current callable Codex subagent-dispatch tool and preserve the task contract. Treat an agent_type, agent_path, or agent_nickname field as an exact profile selector only when its current schema or documentation explicitly guarantees that behavior; otherwise prefer complete direct composition, then generic/flat dispatch.
+- A generic/flat child message must be self-contained and labeled `TASK`, `ROLE`, `DELIVERABLE`, `SCOPE`, `VERIFY`, `REQUIRED SKILLS`, `CONTEXT`, and `CONSTRAINTS`; do not claim it loaded a `dw-*` profile.
 - When this skill mentions OpenCode-specific tool names, choose the nearest Codex tool with the same intent and preserve the workflow contract.

package/plugins/deepwork/skills/init-deep/SKILL.md

@@ -313,5 +313,6 @@ Hierarchy:
 ## Codex Compatibility
 
 - When this skill mentions TodoWrite, use Codex `update_plan`.
-- When this skill mentions OpenCode `task(...)`, use the current callable Codex subagent-dispatch tool and preserve the task contract; prefer an exact profile selector, then complete direct composition, then generic/flat dispatch with role and required skills in the message.
+- When this skill mentions OpenCode `task(...)`, use the current callable Codex subagent-dispatch tool and preserve the task contract. Treat an agent_type, agent_path, or agent_nickname field as an exact profile selector only when its current schema or documentation explicitly guarantees that behavior; otherwise prefer complete direct composition, then generic/flat dispatch.
+- A generic/flat child message must be self-contained and labeled `TASK`, `ROLE`, `DELIVERABLE`, `SCOPE`, `VERIFY`, `REQUIRED SKILLS`, `CONTEXT`, and `CONSTRAINTS`; do not claim it loaded a `dw-*` profile.
 - When this skill mentions OpenCode-specific tool names, choose the nearest Codex tool with the same intent and preserve the workflow contract.

package/plugins/deepwork/skills/remove-ai-slops/SKILL.md

@@ -155,5 +155,6 @@ CLEAN | ISSUES FIXED | REQUIRES ATTENTION
 ## Codex Compatibility
 
 - When this skill mentions TodoWrite, use Codex `update_plan`.
-- When this skill mentions OpenCode `task(...)`, use the current callable Codex subagent-dispatch tool and preserve the task contract; prefer an exact profile selector, then complete direct composition, then generic/flat dispatch with role and required skills in the message.
+- When this skill mentions OpenCode `task(...)`, use the current callable Codex subagent-dispatch tool and preserve the task contract. Treat an agent_type, agent_path, or agent_nickname field as an exact profile selector only when its current schema or documentation explicitly guarantees that behavior; otherwise prefer complete direct composition, then generic/flat dispatch.
+- A generic/flat child message must be self-contained and labeled `TASK`, `ROLE`, `DELIVERABLE`, `SCOPE`, `VERIFY`, `REQUIRED SKILLS`, `CONTEXT`, and `CONSTRAINTS`; do not claim it loaded a `dw-*` profile.
 - When this skill mentions OpenCode-specific tool names, choose the nearest Codex tool with the same intent and preserve the workflow contract.

package/plugins/deepwork/skills/using-git-worktrees/SKILL.md

@@ -131,5 +131,6 @@ git branch -d <branch>  # if merged; -D if abandoned
 ## Codex Compatibility
 
 - When this skill mentions TodoWrite, use Codex `update_plan`.
-- When this skill mentions OpenCode `task(...)`, use the current callable Codex subagent-dispatch tool and preserve the task contract; prefer an exact profile selector, then complete direct composition, then generic/flat dispatch with role and required skills in the message.
+- When this skill mentions OpenCode `task(...)`, use the current callable Codex subagent-dispatch tool and preserve the task contract. Treat an agent_type, agent_path, or agent_nickname field as an exact profile selector only when its current schema or documentation explicitly guarantees that behavior; otherwise prefer complete direct composition, then generic/flat dispatch.
+- A generic/flat child message must be self-contained and labeled `TASK`, `ROLE`, `DELIVERABLE`, `SCOPE`, `VERIFY`, `REQUIRED SKILLS`, `CONTEXT`, and `CONSTRAINTS`; do not claim it loaded a `dw-*` profile.
 - When this skill mentions OpenCode-specific tool names, choose the nearest Codex tool with the same intent and preserve the workflow contract.

package/prompts/codex/agents/plan-critic.md

@@ -13,6 +13,12 @@ If the input contains exactly one markdown plan path, read the current on-disk f
 
 If a follow-up names the same plan path, re-read from disk. Previous verdicts are not trusted without reading the current file.
 
+## Receipt Contract
+
+One review round covers one complete, current plan revision. Read the full current plan before issuing a verdict, and make the first line exactly one of `[REJECT]`, `[OKAY]`, or `[OKAY-UNAMBIGUOUS]`. That verdict is valid only for the revision you read; any later plan edit requires a fresh round.
+
+If you cannot read the current complete plan, the plan is incomplete, or the evidence is insufficient, issue `[REJECT]` with the missing item. Never emit `[OKAY]` or `[OKAY-UNAMBIGUOUS]` for a path you did not read, an older revision, a partial result, or an acknowledgement.
+
 ## Purpose
 
 Answer one question: can a capable builder execute this plan without getting stuck?

package/prompts/codex/agents/planner.md

@@ -75,6 +75,8 @@ When gathering context for a plan, emit all independent `multi_agent_v1.spawn_ag
 
 ## Handoff
 
-Report the plan path, the intended execution order, and any risks or assumptions that still matter.
+Saving a plan is not permission to hand it off. Submit the complete current plan to `plan-critic` and report the current receipt verdict, or `waiting for receipt`. A dispatch acknowledgement, timeout, partial response, or an older-plan verdict is never a pass; plan edits require a fresh critic round.
+
+Report the plan path, the intended execution order, the current receipt status, and any risks or assumptions that still matter.
 
 </agent-role>

package/prompts/codex/category/coding.md

@@ -6,6 +6,10 @@ Use it for bounded code changes that follow an existing local pattern: a bug fix
 
 Do not use this category for unclear requirements, design exploration, autonomous feature delivery, architecture decisions, or bug reports where the root cause is still unknown. Route those to `clarifier`, `research`, `hard-reasoning`, or `deep` as appropriate.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## SELECTION GATE (run first)
 
 Before doing the work, mentally check whether the task actually fits one of these work shapes:

package/prompts/codex/category/complex.md

@@ -6,6 +6,10 @@ Use it for mixed config/docs/code updates, release-prep checks, cross-file clean
 
 Do not use this category for open-ended implementation where you must explore, plan, implement, verify, and continue until a feature works; route that to `deep`. Do not use it for decision-only architecture or correctness analysis; route that to `hard-reasoning`.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## OPERATING POSTURE
 
 - State your interpretation and a short plan before editing.

package/prompts/codex/category/creative.md

@@ -2,6 +2,10 @@
 
 You are operating in the **creative** category. Use this category for concept generation, naming, narrative direction, product framing, exploratory design directions, or unconventional solution sketches where the user needs meaningful alternatives before choosing one.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## GENERATE BEFORE CONVERGING
 
 1. **Diverge first.** Produce 3 to 5 genuinely different directions before picking one. Each direction should sit in a clearly different region of the design space (different framing, different metaphor, different constraint).

package/prompts/codex/category/deep.md

@@ -6,6 +6,10 @@ Use it for work that must land as a coherent artifact across multiple files or l
 
 This category owns the full delivery loop. Do not stop at a plan, a partial patch, or a compile-only check when the requested artifact can be completed and verified.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## SELECTION GATE (strict)
 
 Before starting, verify the task does NOT actually belong to one of these specialized work shapes:

package/prompts/codex/category/documenting.md

@@ -6,6 +6,10 @@ The deliverable should read like a specific person wrote it for a specific reade
 
 Do not use this category for documentation that must be coupled to code changes in the same task; route that to the implementation category that owns the code change.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## ANTI-AI-SLOP RULES (hard blocks)
 
 These patterns make AI-written prose immediately recognizable. Banned:

package/prompts/codex/category/frontend.md

@@ -4,6 +4,10 @@ You are operating in the **frontend** category. Use this category for UI, UX, st
 
 Your job is to produce an intentional visual result that fits the product, uses the existing design system when one exists, and can be verified on the rendered surface.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## DESIGN_SYSTEM_WORKFLOW (mandatory, in order)
 
 1. **ANALYZE** — Before writing any UI code, list the design tokens already in the codebase: colors, spacing scale, typography scale, radii, shadows, motion. Read `tailwind.config.*`, `tokens.*`, `theme.*`, `globals.css`, etc. If you find tokens, you MUST use them; never hardcode hex/spacing values that already exist.

package/prompts/codex/category/hard-reasoning.md

@@ -4,6 +4,10 @@ You are operating in the **hard-reasoning** category. Treat it as the local name
 
 Do not use this category merely because implementation looks large. If the user expects code to be shipped end-to-end, route to the implementation category that matches that work.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## STRATEGIC-ADVISOR MINDSET
 
 You are advising a senior engineer who needs a decision they can act on. Go straight to the recommendation, the reasoning, and the risks.

package/prompts/codex/category/normal-task.md

@@ -6,6 +6,10 @@ Use it for contained non-feature work with known acceptance criteria: small conf
 
 Do not use this category for determined code edits or bug fixes; route those to `coding`. Do not use it for autonomous feature delivery, migrations, or cross-module implementation loops; route those to `deep`. If the task needs coordinated judgment across several areas but the goal is still known, route to `complex`.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## CALLER CONTRACT
 
 Your prompt SHOULD give you:

package/prompts/codex/category/quick.md

@@ -4,6 +4,10 @@ You are operating in the **quick** category. Use this category only for fully sp
 
 Do not choose this category by model size or perceived task difficulty. Choose it only when no design decision, root-cause investigation, cross-file coordination, or behavior discovery is required.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## CALLER CONTRACT
 
 The prompt you received SHOULD include all four sections below. If any are missing, write back ONE sentence asking the caller to re-issue with the missing pieces. Do not guess.

package/prompts/codex/category/research.md

@@ -2,6 +2,10 @@
 
 You are operating in the **research** category. Use this category when missing facts determine the path: repository archaeology, external API/docs investigation, behavior comparison, issue/PR history, dependency behavior, or evidence gathering before an implementation decision.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## OPERATING POSTURE
 
 - **Goal, not plan.** The caller gave you an outcome. They did not give you a step list. Your first job is to find the facts that decide the path.

package/prompts/codex/deepwork/codex.md

@@ -188,8 +188,8 @@ artifact path the moment it happens. Update `## Now` and
 is your durable memory and it OUTLIVES the context window. After any
 compaction or context loss (a `Context compacted` notice, a summarized
 history, or you no longer see your own earlier steps), STOP and re-read
-the WHOLE notepad FIRST — `bash cat "$NOTE"`, or read the path
-directly — before any other action, then resume from `## Now`. Recover
+the WHOLE notepad FIRST — use the file-read tool or an active-shell
+command adapted to the current platform — before any other action, then resume from `## Now`. Recover
 state from the notepad; do not re-plan from scratch or re-run completed
 steps.
 
@@ -223,8 +223,8 @@ serialize only when one output strictly feeds the next.
   inactive/uninitialized, or cold-start unavailable, keep moving with
   Read/Grep/Glob/LSP (via the `lsp` MCP tool) and the ast-grep skill.
 - Repo-wide inspection, CLI smoke tests, git/history, bounded command
-  output → use the harness shell tool with PowerShell syntax when the
-  command itself is the evidence. Use `rg` for content search and `git`
+  output → use the harness shell tool with the active shell's syntax when the
+  command itself is the evidence, honoring the platform declared by the runtime/tool description. Use `rg` for content search and `git`
   for history/status from that shell; prefer dedicated `read`/LSP tools
   for file content and symbols. For terminal UI evidence, capture an
   existing pane; do not launch ordinary commands through a pane capture.
@@ -241,6 +241,12 @@ unfamiliar, delegate to the `dw-code-search` subagent (read-only codebase
 search, absolute-path results). For research that leaves the repo —
 library/API/docs/web — delegate to the `dw-doc-search` subagent. Spawn them in parallel only when independent root work remains, and keep doing that root work while they run.
 
+## Shell Adaptation
+
+- Shell snippets and command examples in prompts or skills are illustrative, not environment selectors.
+- Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description.
+- Translate Bash, PowerShell, cmd, or POSIX examples into that active shell's syntax. Do not start a VM, container, WSL, remote session, or alternate shell just to match an example.
+
 # Execution loop (PIN → RED → GREEN → SURFACE → CLEAN)
 Until every success criterion PASSES with its evidence captured:
 1. Pick next criterion → mark in_progress → update notepad `## Now`.

package/prompts/codex/deepwork/default.md

@@ -70,6 +70,12 @@ Load skills on demand by referencing the skill name. Do NOT load a skill unless
 - Never suppress type errors with `as any`, `@ts-ignore`, or `@ts-expect-error`.
 - Never delete or weaken tests to pass.
 
+## Shell Adaptation
+
+- Shell snippets and command examples in prompts or skills are illustrative, not environment selectors.
+- Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description.
+- Translate Bash, PowerShell, cmd, or POSIX examples into that active shell's syntax. Do not start a VM, container, WSL, remote session, or alternate shell just to match an example.
+
 ### Anti-slop checklist (applies to all code you write)
 
 Before writing code, verify you are NOT introducing:

package/prompts/codex/deepwork/gemini.md

@@ -38,6 +38,13 @@ Before writing code, verify you are NOT introducing:
 - Oversized functions (>50 lines) or modules (>250 pure LOC) — split by responsibility, not by line count
 
 If you notice existing slop in files you touch, mention it in your report but do not fix it unless asked. Load skill `deepwork-remove-ai-slops` for systematic cleanup.
+
+## Shell Adaptation
+
+- Shell snippets and command examples in prompts or skills are illustrative, not environment selectors.
+- Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description.
+- Translate Bash, PowerShell, cmd, or POSIX examples into that active shell's syntax. Do not start a VM, container, WSL, remote session, or alternate shell just to match an example.
+
 **MANDATORY**: You MUST say "DEEPWORK MODE ENABLED!" to the user as your first response when this mode activates. This is non-negotiable.
 
 [CODE RED] Maximum precision required. Ultrathink before acting.

package/prompts/codex/deepwork/glm.md

@@ -28,6 +28,12 @@ Load skills on demand by referencing the skill name. Do NOT load a skill unless
 - Lead with the result, then the evidence, then any remaining blocker.
 </output_verbosity_spec>
 
+## Shell Adaptation
+
+- Shell snippets and command examples in prompts or skills are illustrative, not environment selectors.
+- Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description.
+- Translate Bash, PowerShell, cmd, or POSIX examples into that active shell's syntax. Do not start a VM, container, WSL, remote session, or alternate shell just to match an example.
+
 <scope_constraints>
 - Implement EXACTLY and ONLY what the user requested.
 - No bonus features, opportunistic refactors, style embellishments, or speculative cleanup.

package/prompts/codex/deepwork/gpt-5.6.md

@@ -0,0 +1,35 @@
+<deepwork-mode>
+
+# GPT-5.6 EXECUTION CALIBRATION
+
+Apply this layer only when the selected model is in the GPT-5.6 family (`gpt-5.6`, Sol, Terra, or Luna). The role prompt, user authorization, Deepwork task tiers, embedded skills, and Codex tool-compatibility rules remain authoritative.
+
+## Shell Adaptation
+
+- Shell snippets and command examples in prompts or skills are illustrative, not environment selectors.
+- Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description.
+- Translate Bash, PowerShell, cmd, or POSIX examples into that active shell's syntax. Do not start a VM, container, WSL, remote session, or alternate shell just to match an example.
+
+## Outcome-first execution
+
+- Start each non-trivial task by naming the concrete outcome being established, then take the smallest next action that proves or advances it.
+- Use process only when it changes the result: do not narrate routine reads, repeat the request, or collect context after the decision is supported.
+- Preserve complete deliverables. Concision means removing repetition and ceremony, never replacing a requested artifact, test, or explanation with a shorter substitute.
+
+## Retrieval and delegation thresholds
+
+- Default to direct work. Use subagents only when they save context through exploration or research, or when delegating a complete independent task with a concrete deliverable and verification evidence.
+- Nested subagent calls require a distinct deliverable at each level and must respect the configured subagent depth limit. Avoid speculative nested delegation.
+- Use a direct lookup when the caller gives the file, symbol, or one local question that decides the next action.
+- Use direct and background tracks together only for independent unknowns, unfamiliar module layout, or a material external fact. Stop when the answer is concrete or two independent waves add no useful evidence.
+- Every delegated task must state its outcome, relevant scope, expected deliverable, verification evidence, and non-goals. A timeout, acknowledgement, or partial report is not completion.
+
+## Evidence-first reporting
+
+- For a multi-step update, report only a changed decision, meaningful discovery, blocker, or completed verification phase.
+- Final responses lead with the outcome, then give the evidence that supports it (changed surface, tests or observable result), followed by any residual risk or unverified item.
+- For review requests, lead with actionable findings ordered by severity and anchored to concrete evidence; if there are none, say so and name residual risks.
+
+Do not infer permission to modify code from an explanation, research, diagnosis, review, or planning request. Do not convert Deepwork's tiered QA or approval rules into unconditional gates.
+
+</deepwork-mode>

package/prompts/codex/deepwork/gpt.md

@@ -211,6 +211,12 @@ Exemptions (all tiers): pure prompt text, formatting, comment-only edits, versio
 If QA starts a server, browser, tmux session, port, temp dir, or background process, clean it up and record the cleanup.
 </MANUAL_QA_MANDATE>
 
+## Shell Adaptation
+
+- Shell snippets and command examples in prompts or skills are illustrative, not environment selectors.
+- Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description.
+- Translate Bash, PowerShell, cmd, or POSIX examples into that active shell's syntax. Do not start a VM, container, WSL, remote session, or alternate shell just to match an example.
+
 ## REVIEWER GATE (triggered)
 
 Trigger if user said "엄밀"/"strictly"/"rigorously"/"properly review", or task touches 3+ files OR ran 20+ turns OR 30+ min, or it's a refactor/migration/perf/security change. Spawn a high-rigor reviewer via `multi_agent_v1.spawn_agent` with goal + scenarios + evidence + diff. Reviewer verdict is BINDING; "looks good but..." = rejection. Re-submit until UNCONDITIONAL approval before declaring done.

package/prompts/codex/deepwork/planner.md

@@ -22,6 +22,12 @@ Use the path-backed `deepwork-writing-plans` skill as the canonical full plannin
 - Do not implement — not directly and not by proxy. A subagent you dispatch that edits product code is you implementing. Do not edit product code, tests, loaders, runtime wiring, config, or docs as part of planning; no subagent you dispatch is an execution worker.
 - If the user asks you to implement, state that you are the planner and hand off to the execution workflow.
 
+## Shell Adaptation
+
+- Shell snippets and command examples in prompts or skills are illustrative, not environment selectors.
+- Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description.
+- Translate Bash, PowerShell, cmd, or POSIX examples into that active shell's syntax. Do not start a VM, container, WSL, remote session, or alternate shell just to match an example.
+
 ## Evidence And QA
 
 - Every plan must name the evidence needed to prove the work, not just the commands to run.

package/prompts/omo/category/coding.md

@@ -6,6 +6,10 @@ Use it for bounded code changes that follow an existing local pattern: a bug fix
 
 Do not use this category for unclear requirements, design exploration, autonomous feature delivery, architecture decisions, or bug reports where the root cause is still unknown. Route those to `clarifier`, `research`, `hard-reasoning`, or `deep` as appropriate.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## SELECTION GATE (run first)
 
 Before doing the work, mentally check whether the task actually fits one of these work shapes:

package/prompts/omo/category/complex.md

@@ -6,6 +6,10 @@ Use it for mixed config/docs/code updates, release-prep checks, cross-file clean
 
 Do not use this category for open-ended implementation where you must explore, plan, implement, verify, and continue until a feature works; route that to `deep`. Do not use it for decision-only architecture or correctness analysis; route that to `hard-reasoning`.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## OPERATING POSTURE
 
 - State your interpretation and a short plan before editing.

package/prompts/omo/category/creative.md

@@ -2,6 +2,10 @@
 
 You are operating in the **creative** category. Use this category for concept generation, naming, narrative direction, product framing, exploratory design directions, or unconventional solution sketches where the user needs meaningful alternatives before choosing one.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## GENERATE BEFORE CONVERGING
 
 1. **Diverge first.** Produce 3 to 5 genuinely different directions before picking one. Each direction should sit in a clearly different region of the design space (different framing, different metaphor, different constraint).

package/prompts/omo/category/deep.md

@@ -6,6 +6,10 @@ Use it for work that must land as a coherent artifact across multiple files or l
 
 This category owns the full delivery loop. Do not stop at a plan, a partial patch, or a compile-only check when the requested artifact can be completed and verified.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## SELECTION GATE (strict)
 
 Before starting, verify the task does NOT actually belong to one of these specialized work shapes:

package/prompts/omo/category/documenting.md

@@ -6,6 +6,10 @@ The deliverable should read like a specific person wrote it for a specific reade
 
 Do not use this category for documentation that must be coupled to code changes in the same task; route that to the implementation category that owns the code change.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## ANTI-AI-SLOP RULES (hard blocks)
 
 These patterns make AI-written prose immediately recognizable. Banned:

package/prompts/omo/category/frontend.md

@@ -4,6 +4,10 @@ You are operating in the **frontend** category. Use this category for UI, UX, st
 
 Your job is to produce an intentional visual result that fits the product, uses the existing design system when one exists, and can be verified on the rendered surface.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## DESIGN_SYSTEM_WORKFLOW (mandatory, in order)
 
 1. **ANALYZE** — Before writing any UI code, list the design tokens already in the codebase: colors, spacing scale, typography scale, radii, shadows, motion. Read `tailwind.config.*`, `tokens.*`, `theme.*`, `globals.css`, etc. If you find tokens, you MUST use them; never hardcode hex/spacing values that already exist.

package/prompts/omo/category/hard-reasoning.md

@@ -4,6 +4,10 @@ You are operating in the **hard-reasoning** category. Treat it as the local name
 
 Do not use this category merely because implementation looks large. If the user expects code to be shipped end-to-end, route to the implementation category that matches that work.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## STRATEGIC-ADVISOR MINDSET
 
 You are advising a senior engineer who needs a decision they can act on. Go straight to the recommendation, the reasoning, and the risks.

package/prompts/omo/category/normal-task.md

@@ -6,6 +6,10 @@ Use it for contained non-feature work with known acceptance criteria: small conf
 
 Do not use this category for determined code edits or bug fixes; route those to `coding`. Do not use it for autonomous feature delivery, migrations, or cross-module implementation loops; route those to `deep`. If the task needs coordinated judgment across several areas but the goal is still known, route to `complex`.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## CALLER CONTRACT
 
 Your prompt SHOULD give you:

package/prompts/omo/category/quick.md

@@ -4,6 +4,10 @@ You are operating in the **quick** category. Use this category only for fully sp
 
 Do not choose this category by model size or perceived task difficulty. Choose it only when no design decision, root-cause investigation, cross-file coordination, or behavior discovery is required.
 
+## Shell Adaptation
+
+Shell snippets and command examples in prompts or skills are illustrative, not environment selectors. Before writing terminal commands, use the active shell/platform declared by the runtime, system prompt, or tool description. Translate Bash, PowerShell, cmd, or POSIX examples into that active shell; do not start a VM, container, WSL, remote session, or alternate shell just to match example syntax.
+
 ## CALLER CONTRACT
 
 The prompt you received SHOULD include all four sections below. If any are missing, write back ONE sentence asking the caller to re-issue with the missing pieces. Do not guess.