@duypham93/openkit 0.2.3 → 0.2.5

package/assets/install-bundle/opencode/agents/TechLeadAgent.md

@@ -5,7 +5,13 @@ mode: subagent
 
 # Tech Lead Agent - Delivery Planner
 
-You are the Tech Lead for OpenKit full-delivery and migration work. `context/core/workflow.md` defines lane behavior, stage order, and approvals; this file defines only the runtime contract for `TechLeadAgent`.
+You are the Tech Lead for OpenKit full-delivery and migration work. `.opencode/openkit/context/core/workflow.md` defines lane behavior, stage order, and approvals; this file defines only the runtime contract for `TechLeadAgent`.
+
+## Global runtime path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs, templates, and workflow tools.
+- Read canonical OpenKit files from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` when resuming or validating handoff context.
 
 ## Required Inputs
 
@@ -16,10 +22,10 @@ You are the Tech Lead for OpenKit full-delivery and migration work. `context/cor
 
 ## Required Context Reads
 
-- `context/core/workflow.md`
-- `context/core/code-quality.md`
-- `context/core/project-config.md`
-- `docs/templates/implementation-plan-template.md` when present
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/code-quality.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/docs/templates/implementation-plan-template.md` when present
 - the approved architecture, spec, and brief artifacts that define scope and acceptance
 
 ## Role-Local Responsibilities
@@ -33,7 +39,7 @@ You are the Tech Lead for OpenKit full-delivery and migration work. `context/cor
 ## Expected Output Artifact
 
 - implementation plan at `docs/plans/YYYY-MM-DD-<feature>.md`
-- start from `docs/templates/implementation-plan-template.md` when available so `FullstackAgent` receives a stable execution contract
+- start from `.opencode/openkit/docs/templates/implementation-plan-template.md` when available so `FullstackAgent` receives a stable execution contract
 
 ## Approval-Ready Conditions
 

package/assets/install-bundle/opencode/commands/brainstorm.md

@@ -6,6 +6,13 @@ description: "Starts Migration or Full Delivery design exploration with the brai
 
 Use `/brainstorm` when work is already in `Migration` or `Full Delivery` mode and the team needs to refine design direction before implementation planning.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
+
 ## Preconditions
 
 - The current `mode` must be `full` or `migration`
@@ -14,11 +21,11 @@ Use `/brainstorm` when work is already in `Migration` or `Full Delivery` mode an
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/project-config.md`
-- `.opencode/workflow-state.json` when resuming
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/workflow-state.json` when resuming
 - skill `brainstorming`
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
@@ -39,6 +46,6 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 
 ## Validation guidance
 
-- Use `node .opencode/workflow-state.js show` or `node .opencode/workflow-state.js validate` when resumable state needs confirmation
+- Use `node .opencode/openkit/workflow-state.js show` or `node .opencode/openkit/workflow-state.js validate` when resumable state needs confirmation
 - Brainstorming output is design and workflow evidence, not app build/lint/test evidence
 - If the repository has no app-native validation commands for the eventual implementation, record that constraint honestly in downstream artifacts

package/assets/install-bundle/opencode/commands/delivery.md

@@ -6,6 +6,13 @@ description: "Starts the Full Delivery lane for feature work and higher-risk cha
 
 Use `/delivery` when work needs the full lane from the start or when quick or migration work has already escalated.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
+
 ## Preconditions
 
 - The request satisfies one or more full-lane triggers in `context/core/workflow.md`
@@ -13,13 +20,13 @@ Use `/delivery` when work needs the full lane from the start or when quick or mi
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/lane-selection.md`
-- `context/core/approval-gates.md`
-- `context/core/project-config.md`
-- `.opencode/workflow-state.json` when resuming
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/lane-selection.md`
+- `.opencode/openkit/context/core/approval-gates.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/workflow-state.json` when resuming
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
 
@@ -40,6 +47,6 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 
 ## Validation guidance
 
-- Use `node .opencode/workflow-state.js show` or `node .opencode/workflow-state.js validate` when resumable full-mode state needs confirmation
+- Use `node .opencode/openkit/workflow-state.js show` or `node .opencode/openkit/workflow-state.js validate` when resumable full-mode state needs confirmation
 - Keep implementation and QA validation honest to the repository's actual tooling
 - Do not overstate automation when the repository still lacks app-native build, lint, or test commands

package/assets/install-bundle/opencode/commands/execute-plan.md

@@ -6,6 +6,13 @@ description: "Executes an approved Full Delivery or Migration implementation pla
 
 Use `/execute-plan` when an approved Full Delivery or Migration implementation plan is ready to be carried out.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
+
 ## Preconditions
 
 - The current `mode` must be `full` or `migration`
@@ -14,13 +21,13 @@ Use `/execute-plan` when an approved Full Delivery or Migration implementation p
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/project-config.md`
-- `context/core/session-resume.md`
-- `context/core/workflow-state-schema.md`
-- `.opencode/workflow-state.json`
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/context/core/session-resume.md`
+- `.opencode/openkit/context/core/workflow-state-schema.md`
+- `.opencode/openkit/workflow-state.json`
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
 
@@ -39,6 +46,6 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 
 ## Validation guidance
 
-- Run `node .opencode/workflow-state.js validate` when you need to confirm workflow-state integrity before execution
+- Run `node .opencode/openkit/workflow-state.js validate` when you need to confirm workflow-state integrity before execution
 - Use repo-native app build, lint, or test commands only if they actually exist and are documented
 - If the repository still lacks app-native validation tooling, report manual checks or other real evidence instead of inventing automation

package/assets/install-bundle/opencode/commands/migrate.md

@@ -6,6 +6,13 @@ description: "Starts the Migration lane for upgrades, framework migrations, and
 
 Use `/migrate` when work is primarily a project migration or upgrade effort such as framework version jumps, dependency replacement, legacy API removal, or compatibility remediation.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs, templates, and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
+
 Core migration principle:
 
 - preserve behavior first, decouple blockers where necessary, and migrate incrementally instead of rewriting the product
@@ -20,15 +27,15 @@ Core migration principle:
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/lane-selection.md`
-- `context/core/approval-gates.md`
-- `context/core/project-config.md`
-- `docs/templates/migration-baseline-checklist.md`
-- `docs/templates/migration-verify-checklist.md`
-- `.opencode/workflow-state.json` when resuming
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/lane-selection.md`
+- `.opencode/openkit/context/core/approval-gates.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/docs/templates/migration-baseline-checklist.md`
+- `.opencode/openkit/docs/templates/migration-verify-checklist.md`
+- `.opencode/openkit/workflow-state.json` when resuming
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
 

package/assets/install-bundle/opencode/commands/quick-task.md

@@ -6,6 +6,13 @@ description: "Starts the Quick Task lane for narrow, low-risk work."
 
 Use `/quick-task` when the user wants to enter the quick lane directly for bounded small-to-medium work that stays within the quick-lane limits, remains lower risk, and uses a short verification path.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/` or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
+
 ## Preconditions
 
 - The request must satisfy quick-lane criteria in `context/core/workflow.md`
@@ -13,12 +20,12 @@ Use `/quick-task` when the user wants to enter the quick lane directly for bound
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/lane-selection.md`
-- `context/core/project-config.md`
-- `.opencode/workflow-state.json` when resuming
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/lane-selection.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/workflow-state.json` when resuming
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
 
@@ -42,4 +49,4 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 
 - Keep quick-task validation short and real, following `context/core/project-config.md`
 - If no app-native test or lint command exists, document the manual or artifact-based verification path clearly
-- Use `node .opencode/workflow-state.js validate` only for workflow-state checks, not as a substitute for application testing
+- Use `node .opencode/openkit/workflow-state.js validate` only for workflow-state checks, not as a substitute for application testing

package/assets/install-bundle/opencode/commands/task.md

@@ -6,6 +6,14 @@ description: "Default entry command. Lets the Master Orchestrator classify work
 
 Use `/task` when the user wants the default entrypoint and expects the Master Orchestrator to choose the lane.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/workflow-state.json`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- For workflow-state CLI operations in global mode, use `node .opencode/openkit/workflow-state.js <command>`.
+- Use the target repository only for product/application code, local build tooling, and project-specific docs.
+
 ## Preconditions
 
 - A user request exists with enough information to summarize the initial goal, scope, and risk
@@ -13,12 +21,12 @@ Use `/task` when the user wants the default entrypoint and expects the Master Or
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/lane-selection.md`
-- `context/core/project-config.md`
-- `.opencode/workflow-state.json` when resuming
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/lane-selection.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/workflow-state.json` when resuming
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
 
@@ -41,6 +49,6 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 
 ## Validation guidance
 
-- Use `node .opencode/workflow-state.js status` or `node .opencode/workflow-state.js show` to inspect resumable state before rerouting when needed
-- Use `node .opencode/workflow-state.js validate` if the saved state looks stale or manually edited
+- Use `node .opencode/openkit/workflow-state.js status` or `node .opencode/openkit/workflow-state.js show` to inspect resumable state before rerouting when needed
+- Use `node .opencode/openkit/workflow-state.js validate` to validate stale or manually edited state when needed
 - Do not imply repo-native app build, lint, or test commands exist when this repository has not defined them

package/assets/install-bundle/opencode/commands/write-plan.md

@@ -6,6 +6,13 @@ description: "Triggers the writing-plans skill to create bite-sized tasks from s
 
 Use `/write-plan` to create an implementation plan for work currently in `Full Delivery` or `Migration` mode.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs, templates, and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
+
 ## Preconditions
 
 - The current `mode` must be `full` or `migration`
@@ -15,13 +22,13 @@ Use `/write-plan` to create an implementation plan for work currently in `Full D
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/project-config.md`
-- `.opencode/workflow-state.json`
-- `docs/templates/implementation-plan-template.md`
-- `docs/templates/migration-report-template.md` when migration work benefits from one running artifact
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/workflow-state.json`
+- `.opencode/openkit/docs/templates/implementation-plan-template.md`
+- `.opencode/openkit/docs/templates/migration-report-template.md` when migration work benefits from one running artifact
 - skill `writing-plans`
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
@@ -47,4 +54,4 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 - The plan should name the strongest real validation path available in the repository
 - In migration mode, use `migration_report` when handoffs would benefit from a single running narrative instead of scattered notes
 - If no repo-native app build, lint, or test command exists, say that explicitly in the plan instead of guessing a stack command
-- Use `node .opencode/workflow-state.js validate` only to confirm workflow state, not to stand in for implementation verification
+- Use `node .opencode/openkit/workflow-state.js validate` only to confirm workflow state, not to stand in for implementation verification

package/commands/brainstorm.md

@@ -6,6 +6,13 @@ description: "Starts Migration or Full Delivery design exploration with the brai
 
 Use `/brainstorm` when work is already in `Migration` or `Full Delivery` mode and the team needs to refine design direction before implementation planning.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
+
 ## Preconditions
 
 - The current `mode` must be `full` or `migration`
@@ -14,11 +21,11 @@ Use `/brainstorm` when work is already in `Migration` or `Full Delivery` mode an
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/project-config.md`
-- `.opencode/workflow-state.json` when resuming
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/workflow-state.json` when resuming
 - skill `brainstorming`
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
@@ -39,6 +46,6 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 
 ## Validation guidance
 
-- Use `node .opencode/workflow-state.js show` or `node .opencode/workflow-state.js validate` when resumable state needs confirmation
+- Use `node .opencode/openkit/workflow-state.js show` or `node .opencode/openkit/workflow-state.js validate` when resumable state needs confirmation
 - Brainstorming output is design and workflow evidence, not app build/lint/test evidence
 - If the repository has no app-native validation commands for the eventual implementation, record that constraint honestly in downstream artifacts

package/commands/delivery.md

@@ -6,6 +6,13 @@ description: "Starts the Full Delivery lane for feature work and higher-risk cha
 
 Use `/delivery` when work needs the full lane from the start or when quick or migration work has already escalated.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
+
 ## Preconditions
 
 - The request satisfies one or more full-lane triggers in `context/core/workflow.md`
@@ -13,13 +20,13 @@ Use `/delivery` when work needs the full lane from the start or when quick or mi
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/lane-selection.md`
-- `context/core/approval-gates.md`
-- `context/core/project-config.md`
-- `.opencode/workflow-state.json` when resuming
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/lane-selection.md`
+- `.opencode/openkit/context/core/approval-gates.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/workflow-state.json` when resuming
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
 
@@ -40,6 +47,6 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 
 ## Validation guidance
 
-- Use `node .opencode/workflow-state.js show` or `node .opencode/workflow-state.js validate` when resumable full-mode state needs confirmation
+- Use `node .opencode/openkit/workflow-state.js show` or `node .opencode/openkit/workflow-state.js validate` when resumable full-mode state needs confirmation
 - Keep implementation and QA validation honest to the repository's actual tooling
 - Do not overstate automation when the repository still lacks app-native build, lint, or test commands

package/commands/execute-plan.md

@@ -6,6 +6,13 @@ description: "Executes an approved Full Delivery or Migration implementation pla
 
 Use `/execute-plan` when an approved Full Delivery or Migration implementation plan is ready to be carried out.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
+
 ## Preconditions
 
 - The current `mode` must be `full` or `migration`
@@ -14,13 +21,13 @@ Use `/execute-plan` when an approved Full Delivery or Migration implementation p
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/project-config.md`
-- `context/core/session-resume.md`
-- `context/core/workflow-state-schema.md`
-- `.opencode/workflow-state.json`
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/context/core/session-resume.md`
+- `.opencode/openkit/context/core/workflow-state-schema.md`
+- `.opencode/openkit/workflow-state.json`
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
 
@@ -39,6 +46,6 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 
 ## Validation guidance
 
-- Run `node .opencode/workflow-state.js validate` when you need to confirm workflow-state integrity before execution
+- Run `node .opencode/openkit/workflow-state.js validate` when you need to confirm workflow-state integrity before execution
 - Use repo-native app build, lint, or test commands only if they actually exist and are documented
 - If the repository still lacks app-native validation tooling, report manual checks or other real evidence instead of inventing automation

package/commands/migrate.md

@@ -6,6 +6,13 @@ description: "Starts the Migration lane for upgrades, framework migrations, and
 
 Use `/migrate` when work is primarily a project migration or upgrade effort such as framework version jumps, dependency replacement, legacy API removal, or compatibility remediation.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs, templates, and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
+
 Core migration principle:
 
 - preserve behavior first, decouple blockers where necessary, and migrate incrementally instead of rewriting the product
@@ -20,15 +27,15 @@ Core migration principle:
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/lane-selection.md`
-- `context/core/approval-gates.md`
-- `context/core/project-config.md`
-- `docs/templates/migration-baseline-checklist.md`
-- `docs/templates/migration-verify-checklist.md`
-- `.opencode/workflow-state.json` when resuming
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/lane-selection.md`
+- `.opencode/openkit/context/core/approval-gates.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/docs/templates/migration-baseline-checklist.md`
+- `.opencode/openkit/docs/templates/migration-verify-checklist.md`
+- `.opencode/openkit/workflow-state.json` when resuming
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
 

package/commands/quick-task.md

@@ -6,6 +6,13 @@ description: "Starts the Quick Task lane for narrow, low-risk work."
 
 Use `/quick-task` when the user wants to enter the quick lane directly for bounded small-to-medium work that stays within the quick-lane limits, remains lower risk, and uses a short verification path.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/` or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
+
 ## Preconditions
 
 - The request must satisfy quick-lane criteria in `context/core/workflow.md`
@@ -13,12 +20,12 @@ Use `/quick-task` when the user wants to enter the quick lane directly for bound
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/lane-selection.md`
-- `context/core/project-config.md`
-- `.opencode/workflow-state.json` when resuming
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/lane-selection.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/workflow-state.json` when resuming
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
 
@@ -42,4 +49,4 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 
 - Keep quick-task validation short and real, following `context/core/project-config.md`
 - If no app-native test or lint command exists, document the manual or artifact-based verification path clearly
-- Use `node .opencode/workflow-state.js validate` only for workflow-state checks, not as a substitute for application testing
+- Use `node .opencode/openkit/workflow-state.js validate` only for workflow-state checks, not as a substitute for application testing

package/commands/task.md

@@ -6,6 +6,14 @@ description: "Default entry command. Lets the Master Orchestrator classify work
 
 Use `/task` when the user wants the default entrypoint and expects the Master Orchestrator to choose the lane.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/workflow-state.json`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- For workflow-state CLI operations in global mode, use `node .opencode/openkit/workflow-state.js <command>`.
+- Use the target repository only for product/application code, local build tooling, and project-specific docs.
+
 ## Preconditions
 
 - A user request exists with enough information to summarize the initial goal, scope, and risk
@@ -13,12 +21,12 @@ Use `/task` when the user wants the default entrypoint and expects the Master Or
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/lane-selection.md`
-- `context/core/project-config.md`
-- `.opencode/workflow-state.json` when resuming
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/lane-selection.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/workflow-state.json` when resuming
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
 
@@ -41,6 +49,6 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 
 ## Validation guidance
 
-- Use `node .opencode/workflow-state.js status` or `node .opencode/workflow-state.js show` to inspect resumable state before rerouting when needed
-- Use `node .opencode/workflow-state.js validate` if the saved state looks stale or manually edited
+- Use `node .opencode/openkit/workflow-state.js status` or `node .opencode/openkit/workflow-state.js show` to inspect resumable state before rerouting when needed
+- Use `node .opencode/openkit/workflow-state.js validate` to validate stale or manually edited state when needed
 - Do not imply repo-native app build, lint, or test commands exist when this repository has not defined them

package/commands/write-plan.md

@@ -6,6 +6,13 @@ description: "Triggers the writing-plans skill to create bite-sized tasks from s
 
 Use `/write-plan` to create an implementation plan for work currently in `Full Delivery` or `Migration` mode.
 
+## Global OpenKit path rule
+
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs, templates, and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
+
 ## Preconditions
 
 - The current `mode` must be `full` or `migration`
@@ -15,13 +22,13 @@ Use `/write-plan` to create an implementation plan for work currently in `Full D
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/project-config.md`
-- `.opencode/workflow-state.json`
-- `docs/templates/implementation-plan-template.md`
-- `docs/templates/migration-report-template.md` when migration work benefits from one running artifact
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/workflow-state.json`
+- `.opencode/openkit/docs/templates/implementation-plan-template.md`
+- `.opencode/openkit/docs/templates/migration-report-template.md` when migration work benefits from one running artifact
 - skill `writing-plans`
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
@@ -47,4 +54,4 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 - The plan should name the strongest real validation path available in the repository
 - In migration mode, use `migration_report` when handoffs would benefit from a single running narrative instead of scattered notes
 - If no repo-native app build, lint, or test command exists, say that explicitly in the plan instead of guessing a stack command
-- Use `node .opencode/workflow-state.js validate` only to confirm workflow state, not to stand in for implementation verification
+- Use `node .opencode/openkit/workflow-state.js validate` only to confirm workflow state, not to stand in for implementation verification

package/docs/operator/README.md

@@ -21,6 +21,15 @@ Use it to find the right live docs quickly. Do not treat it as a canonical repla
 - Use `/task` unless you already know the work must start in `Quick Task`, `Migration`, or `Full Delivery`
 - Use `context/navigation.md` when you need to locate deeper workflow or standards references
 
+## Minimal First Session
+
+- `npm install -g @duypham93/openkit`
+- `openkit run`
+- Wait for OpenCode to open with `master-orchestrator`
+- Press `Ctrl+P`
+- Run `/task <what you want to do>`
+- Fall back to `/quick-task`, `/migrate`, or `/delivery` only when the lane is obvious
+
 ## Operator Routes
 
 - Workflow contract: `context/core/workflow.md`