From 7d2d7f389c35c982ae7409b78f562388c1429685 Mon Sep 17 00:00:00 2001
From: dbpolito <danielbpolito@gmail.com>
Date: Fri, 27 Mar 2026 12:24:52 -0300
Subject: [PATCH 1/3] refactor: remove deprecated /reload command and clean up
 references

- Delete reload.md command definition from packages/core/commands/
- Remove reload.md from packages/opencode/.opencode/commands/
- Delete reload.mdx documentation from packages/web/src/content/docs/docs/reference/commands/
- Update kompass.jsonc files to remove reload command references
- Update CommandShowcase.astro and commands index.mdx to remove reload references
---
 kompass.jsonc                                 |   1 -
 packages/core/commands/reload.md              |  34 -
 packages/core/kompass.jsonc                   |   1 -
 .../opencode/.opencode/commands/reload.md     |  39 --
 packages/opencode/.opencode/kompass.jsonc     |   3 -
 packages/opencode/kompass.jsonc               |   1 -
 .../web/src/components/CommandShowcase.astro  | 608 +++++++++++++-----
 .../docs/docs/reference/commands/index.mdx    | 149 ++---
 .../docs/docs/reference/commands/reload.mdx   |  23 -
 9 files changed, 515 insertions(+), 344 deletions(-)
 delete mode 100644 packages/core/commands/reload.md
 delete mode 100644 packages/opencode/.opencode/commands/reload.md
 delete mode 100644 packages/web/src/content/docs/docs/reference/commands/reload.mdx

diff --git a/kompass.jsonc b/kompass.jsonc
index fd614b4..21a63e0 100644
--- a/kompass.jsonc
+++ b/kompass.jsonc
@@ -20,7 +20,6 @@
     "pr/create": { "enabled": true },
     "pr/fix": { "enabled": true },
     "pr/review": { "enabled": true },
-    "reload": { "enabled": true },
     "review": { "enabled": true },
     "ship": { "enabled": true },
     "rmslop": { "enabled": true },
diff --git a/packages/core/commands/reload.md b/packages/core/commands/reload.md
deleted file mode 100644
index e5883b3..0000000
--- a/packages/core/commands/reload.md
+++ /dev/null
@@ -1,34 +0,0 @@
-## Goal
-
-Reload the current OpenCode project cache.
-
-## Workflow
-
-### Arguments
-
-<arguments>
-$ARGUMENTS
-</arguments>
-
-### Interpret Arguments
-
-- This command does not accept runtime arguments
-- If `<arguments>` is non-empty, ignore it instead of changing behavior
-
-### Reload Project
-
-- Call the `reload` tool
-- If the tool fails, STOP and report the reload error
-
-## Additional Context
-
-- Use this command when the workspace cache needs to reflect the current repository state
-
-## Output
-
-When reload succeeds, display:
-```
-Reloaded project cache
-
-No additional steps are required.
-```
diff --git a/packages/core/kompass.jsonc b/packages/core/kompass.jsonc
index fd614b4..21a63e0 100644
--- a/packages/core/kompass.jsonc
+++ b/packages/core/kompass.jsonc
@@ -20,7 +20,6 @@
     "pr/create": { "enabled": true },
     "pr/fix": { "enabled": true },
     "pr/review": { "enabled": true },
-    "reload": { "enabled": true },
     "review": { "enabled": true },
     "ship": { "enabled": true },
     "rmslop": { "enabled": true },
diff --git a/packages/opencode/.opencode/commands/reload.md b/packages/opencode/.opencode/commands/reload.md
deleted file mode 100644
index 8fb9f1e..0000000
--- a/packages/opencode/.opencode/commands/reload.md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-description: Reload the current OpenCode project configuration
-agent: build
----
-
-## Goal
-
-Reload the current OpenCode project cache.
-
-## Workflow
-
-### Arguments
-
-<arguments>
-$ARGUMENTS
-</arguments>
-
-### Interpret Arguments
-
-- This command does not accept runtime arguments
-- If `<arguments>` is non-empty, ignore it instead of changing behavior
-
-### Reload Project
-
-- Call the `kompass_reload` tool
-- If the tool fails, STOP and report the kompass_reload error
-
-## Additional Context
-
-- Use this command when the workspace cache needs to reflect the current repository state
-
-## Output
-
-When kompass_reload succeeds, display:
-```
-Reloaded project cache
-
-No additional steps are required.
-```
diff --git a/packages/opencode/.opencode/kompass.jsonc b/packages/opencode/.opencode/kompass.jsonc
index 46806e6..22b63b7 100644
--- a/packages/opencode/.opencode/kompass.jsonc
+++ b/packages/opencode/.opencode/kompass.jsonc
@@ -34,9 +34,6 @@
     "pr/review": {
       "enabled": true
     },
-    "reload": {
-      "enabled": true
-    },
     "review": {
       "enabled": true
     },
diff --git a/packages/opencode/kompass.jsonc b/packages/opencode/kompass.jsonc
index fd614b4..21a63e0 100644
--- a/packages/opencode/kompass.jsonc
+++ b/packages/opencode/kompass.jsonc
@@ -20,7 +20,6 @@
     "pr/create": { "enabled": true },
     "pr/fix": { "enabled": true },
     "pr/review": { "enabled": true },
-    "reload": { "enabled": true },
     "review": { "enabled": true },
     "ship": { "enabled": true },
     "rmslop": { "enabled": true },
diff --git a/packages/web/src/components/CommandShowcase.astro b/packages/web/src/components/CommandShowcase.astro
index a1483df..5d705cd 100644
--- a/packages/web/src/components/CommandShowcase.astro
+++ b/packages/web/src/components/CommandShowcase.astro
@@ -20,16 +20,19 @@ interface CommandScenario {
   command: string;
   agentName: string;
   task: string;
+  group: 'core' | 'ticket' | 'pr' | 'orchestration';
   steps: SessionStep[];
 }
 
 const scenarios: CommandScenario[] = [
+  // Core commands
   {
     id: 'ask',
     label: '/ask',
     command: '/ask is this project cool?',
     agentName: 'Build Agent',
     task: 'Answer questions about the current project or code',
+    group: 'core',
     steps: [
       {
         id: 'thinking',
@@ -58,352 +61,371 @@ const scenarios: CommandScenario[] = [
     ]
   },
   {
-    id: 'ticket-plan',
-    label: '/ticket/plan',
-    command: '/ticket/plan #128',
-    agentName: 'Planner',
-    task: 'Turn a request or ticket into a scoped implementation plan',
+    id: 'branch',
+    label: '/branch',
+    command: '/branch',
+    agentName: 'Worker',
+    task: 'Create categorized branch names',
+    group: 'core',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Planning the rollout — need to break down the review workflow into actionable steps. Will examine existing patterns and create a scoped plan with clear milestones.'
+        content: 'Creating branch — need to summarize uncommitted work and generate a categorized branch name based on the change themes.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
-          { tool: 'ticket_load', args: '#128', status: 'complete' },
-          { tool: 'read', args: 'packages/core/commands/pr/review.md', status: 'complete' },
-          { tool: 'glob', args: 'packages/core/components/*.md', status: 'complete' }
+          { tool: 'changes_load', args: 'uncommitted', status: 'complete' },
+          { tool: 'bash', args: 'git checkout -b docs/site-refresh', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Phase 1: Extract reusable review components from existing commands',
-          'Phase 2: Update navigator agent to coordinate review workflows',
-          'Phase 3: Add checklist generation and feedback threading'
+          'Created branch: docs/site-refresh',
+          'Switched from main to the new work branch'
         ]
       }
     ]
   },
   {
-    id: 'pr-create',
-    label: '/pr/create',
-    command: '/pr/create',
-    agentName: 'Build',
-    task: 'Summarize branch work and publish a structured PR',
+    id: 'commit',
+    label: '/commit',
+    command: '/commit',
+    agentName: 'Worker',
+    task: 'Generate why-focused commit messages',
+    group: 'core',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Creating PR — need to load branch changes, check for linked tickets, and generate a structured PR description with checklist sections.'
+        content: 'Committing — need to inspect staged and unstaged changes, then generate a commit message focused on why the changes were made.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
-          { tool: 'changes_load', args: 'HEAD...main', status: 'complete' },
-          { tool: 'ticket_load', args: '#42', status: 'complete' },
-          { tool: 'bash', args: 'git push origin HEAD', status: 'complete' }
+          { tool: 'changes_load', args: 'uncommitted', status: 'complete' },
+          { tool: 'bash', args: 'git add packages/web/src/', status: 'complete' },
+          { tool: 'bash', args: 'git commit -m "feat: improve command showcase"', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Created PR #47: Add workflow visualization to homepage',
-          'Linked to ticket #42 with structured checklist',
-          'PR body includes summary, changes, and testing notes'
+          'Staged relevant files',
+          'Created a new commit with generated message'
         ]
       }
     ]
   },
   {
-    id: 'review',
-    label: '/review',
-    command: '/review',
-    agentName: 'Reviewer',
-    task: 'Review branch changes without editing files',
+    id: 'commit-and-push',
+    label: '/commit-and-push',
+    command: '/commit-and-push',
+    agentName: 'Worker',
+    task: 'Commit and push in one pass',
+    group: 'core',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Reviewing changes — need to load the diff context and examine modified files for potential issues, risks, and improvements without making edits.'
+        content: 'Committing and pushing — need to stage relevant files, generate a commit message, and push the branch upstream in a single operation.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
           { tool: 'changes_load', args: 'uncommitted', status: 'complete' },
-          { tool: 'read', args: 'packages/web/src/components/CommandShowcase.astro', status: 'complete' },
-          { tool: 'task', args: 'reviewer analysis', status: 'complete' }
+          { tool: 'bash', args: 'git add packages/web/src/', status: 'complete' },
+          { tool: 'bash', args: 'git commit -m "feat: add command showcase"', status: 'complete' },
+          { tool: 'bash', args: 'git push origin HEAD', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Strong separation of concerns between scenarios and rendering',
-          'Consider adding error handling for failed tool calls',
-          'Animation timing is appropriate for the UX flow'
+          'Staged 3 modified files',
+          'Created commit: feat: add command showcase with animations',
+          'Pushed to origin/feature/showcase'
         ]
       }
     ]
   },
   {
-    id: 'dev',
-    label: '/dev',
-    command: '/dev implement the approved workflow in packages/core',
-    agentName: 'Navigator',
-    task: 'Orchestrate implementation with validation and checkpointing',
+    id: 'learn',
+    label: '/learn',
+    command: '/learn',
+    agentName: 'Worker',
+    task: 'Extract patterns into AGENTS.md',
+    group: 'core',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Planning implementation — loading ticket context and preparing to delegate tasks to workers. Will coordinate edits and validation checkpoints.'
+        content: 'Learning — need to inspect existing patterns in the repo and extract reusable guidance into AGENTS.md targets.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
-          { tool: 'ticket_load', args: '#128', status: 'complete' },
-          { tool: 'dispatch', args: '/ticket/plan', status: 'complete' },
-          { tool: 'dispatch', args: '/dev worker', status: 'complete' },
-          { tool: 'dispatch', args: '/commit-and-push', status: 'complete' }
+          { tool: 'read', args: 'AGENTS.md', status: 'complete' },
+          { tool: 'grep', args: 'function|const|class', status: 'complete' },
+          { tool: 'apply_patch', args: 'AGENTS.md', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Planned implementation in coordination with ticket',
-          'Delegated to worker for file edits and validation',
-          'Committed changes and pushed to remote'
+          'Summarized established conventions',
+          'Updated agent guidance where the pattern belongs'
         ]
       }
     ]
   },
   {
-    id: 'ship',
-    label: '/ship',
-    command: '/ship',
-    agentName: 'Navigator',
-    task: 'Fast path from changes to PR',
+    id: 'rmslop',
+    label: '/rmslop',
+    command: '/rmslop',
+    agentName: 'Worker',
+    task: 'Remove unnecessary complexity and duplication',
+    group: 'core',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Shipping — need to create a work branch, commit changes, and publish a PR. Will orchestrate the full workflow from current state to pull request.'
+        content: 'Inspecting for slop — need to examine the branch for unnecessary complexity, duplicate code, and workflow glue that can be simplified or removed.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
-          { tool: 'dispatch', args: '/branch feature/new-workflow', status: 'complete' },
-          { tool: 'dispatch', args: '/commit', status: 'complete' },
-          { tool: 'dispatch', args: '/pr/create', status: 'complete' }
+          { tool: 'changes_load', args: 'HEAD~3...HEAD', status: 'complete' },
+          { tool: 'read', args: 'packages/core/commands/*.md', status: 'complete' },
+          { tool: 'grep', args: 'TODO|FIXME|XXX', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Created branch: feature/new-workflow',
-          'Committed 3 files with generated message',
-          'Published PR #48: Add new workflow command'
+          'Removed 47 lines of duplicate validation logic',
+          'Simplified 3 overly-abstract helper functions',
+          'Consolidated similar command patterns into shared components'
         ]
       }
     ]
   },
+
+  // Ticket commands
   {
-    id: 'rmslop',
-    label: '/rmslop',
-    command: '/rmslop',
-    agentName: 'Worker',
-    task: 'Remove unnecessary complexity and duplication',
+    id: 'ticket-ask',
+    label: '/ticket/ask',
+    command: '/ticket/ask #42 how do I test this?',
+    agentName: 'Build Agent',
+    task: 'Answer questions about a ticket and post the response',
+    group: 'ticket',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Inspecting for slop — need to examine the branch for unnecessary complexity, duplicate code, and workflow glue that can be simplified or removed.'
+        content: 'Answering ticket question — loading ticket #42 with discussion to understand the testing requirements, then providing a clear answer.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
-          { tool: 'changes_load', args: 'HEAD~3...HEAD', status: 'complete' },
-          { tool: 'read', args: 'packages/core/commands/*.md', status: 'complete' },
-          { tool: 'grep', args: 'TODO|FIXME|XXX', status: 'complete' }
+          { tool: 'ticket_load', args: '#42', status: 'complete' },
+          { tool: 'read', args: 'packages/core/package.json', status: 'complete' },
+          { tool: 'glob', args: '**/*.test.ts', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Removed 47 lines of duplicate validation logic',
-          'Simplified 3 overly-abstract helper functions',
-          'Consolidated similar command patterns into shared components'
+          'Loaded ticket #42 and discussion history',
+          'Posted answer with test examples and setup instructions',
+          'Answer now visible on the ticket for the team'
         ]
       }
     ]
   },
   {
-    id: 'todo',
-    label: '/todo',
-    command: '/todo @TODO.md',
-    agentName: 'Navigator',
-    task: 'Work through a todo list with checkpoint reviews',
+    id: 'ticket-create',
+    label: '/ticket/create',
+    command: '/ticket/create',
+    agentName: 'Build Agent',
+    task: 'Create a ticket from current changes',
+    group: 'ticket',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Processing todo — loading the todo list and keeping orchestration local. Will ask for plan approval before implementation starts.'
+        content: 'Creating ticket — loading branch changes, reading modified files to understand themes, then creating a structured issue.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
-          { tool: 'read', args: 'TODO.md', status: 'complete' },
-          { tool: 'dispatch', args: '/ticket/plan #42', status: 'complete' },
-          { tool: 'dispatch', args: '/dev', status: 'complete' },
-          { tool: 'dispatch', args: '/commit', status: 'complete' }
+          { tool: 'changes_load', args: 'HEAD...main', status: 'complete' },
+          { tool: 'read', args: 'packages/web/src/components/*.astro', status: 'complete' },
+          { tool: 'ticket_sync', args: 'create with checklists', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Completed: Update command showcase with more examples',
-          'Blocked: Waiting for review on PR #47',
-          'Next: Add mobile responsive styling'
+          'Analyzed 5 changed files, grouped into 3 themes',
+          'Created issue #43: Add workflow documentation',
+          'Assigned to @me with implementation checklist'
         ]
       }
     ]
   },
   {
-    id: 'commit-and-push',
-    label: '/commit-and-push',
-    command: '/commit-and-push',
-    agentName: 'Worker',
-    task: 'Commit and push in one pass',
+    id: 'ticket-dev',
+    label: '/ticket/dev',
+    command: '/ticket/dev #128',
+    agentName: 'Navigator',
+    task: 'Implement a ticket end-to-end',
+    group: 'ticket',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Committing and pushing — need to stage relevant files, generate a commit message, and push the branch upstream in a single operation.'
+        content: 'Implementing ticket — loading context and preparing to orchestrate the full workflow: branch creation, development, validation, commit, and PR.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
-          { tool: 'changes_load', args: 'uncommitted', status: 'complete' },
-          { tool: 'bash', args: 'git add packages/web/src/', status: 'complete' },
-          { tool: 'bash', args: 'git commit -m "feat: add command showcase"', status: 'complete' },
-          { tool: 'bash', args: 'git push origin HEAD', status: 'complete' }
+          { tool: 'ticket_load', args: '#128', status: 'complete' },
+          { tool: 'dispatch', args: '/branch', status: 'complete' },
+          { tool: 'dispatch', args: '/dev', status: 'complete' },
+          { tool: 'dispatch', args: '/commit-and-push', status: 'complete' },
+          { tool: 'dispatch', args: '/pr/create', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Staged 3 modified files',
-          'Created commit: feat: add command showcase with animations',
-          'Pushed to origin/feature/showcase'
+          'Created branch: feature/ticket-128-workflow',
+          'Implemented changes with validation',
+          'Published PR #49 linked to ticket #128'
         ]
       }
     ]
   },
   {
-    id: 'branch',
-    label: '/branch',
-    command: '/branch',
-    agentName: 'Worker',
-    task: 'Create categorized branch names',
+    id: 'ticket-plan',
+    label: '/ticket/plan',
+    command: '/ticket/plan #128',
+    agentName: 'Planner',
+    task: 'Turn a request or ticket into a scoped implementation plan',
+    group: 'ticket',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Creating branch — need to summarize uncommitted work and generate a categorized branch name based on the change themes.'
+        content: 'Planning the rollout — need to break down the review workflow into actionable steps. Will examine existing patterns and create a scoped plan with clear milestones.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
-          { tool: 'changes_load', args: 'uncommitted', status: 'complete' },
-          { tool: 'bash', args: 'git checkout -b docs/site-refresh', status: 'complete' }
+          { tool: 'ticket_load', args: '#128', status: 'complete' },
+          { tool: 'read', args: 'packages/core/commands/pr/review.md', status: 'complete' },
+          { tool: 'glob', args: 'packages/core/components/*.md', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Created branch: docs/site-refresh',
-          'Switched from main to the new work branch'
+          'Phase 1: Extract reusable review components from existing commands',
+          'Phase 2: Update navigator agent to coordinate review workflows',
+          'Phase 3: Add checklist generation and feedback threading'
         ]
       }
     ]
   },
   {
-    id: 'commit',
-    label: '/commit',
-    command: '/commit',
-    agentName: 'Worker',
-    task: 'Generate why-focused commit messages',
+    id: 'ticket-plan-and-sync',
+    label: '/ticket/plan-and-sync',
+    command: '/ticket/plan-and-sync #128',
+    agentName: 'Planner',
+    task: 'Load ticket, create plan, sync it back',
+    group: 'ticket',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Committing — need to inspect staged and unstaged changes, then generate a commit message focused on why the changes were made.'
+        content: 'Planning from ticket #128 — loading the ticket context with discussion, inspecting repo patterns, then syncing the scoped plan back to update the ticket.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
-          { tool: 'changes_load', args: 'uncommitted', status: 'complete' },
-          { tool: 'bash', args: 'git add packages/web/src/', status: 'complete' },
-          { tool: 'bash', args: 'git commit -m "feat: improve command showcase"', status: 'complete' }
+          { tool: 'ticket_load', args: '#128 (with comments)', status: 'complete' },
+          { tool: 'read', args: 'packages/core/commands/pr/review.md', status: 'complete' },
+          { tool: 'glob', args: 'packages/core/components/*.md', status: 'complete' },
+          { tool: 'ticket_sync', args: 'update #128 with plan', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Staged relevant files',
-          'Created a new commit with generated message'
+          'Loaded ticket #128 and discussion history',
+          'Created scoped implementation plan',
+          'Synced plan back to ticket #128 with checklists'
         ]
       }
     ]
   },
+
+  // PR commands
   {
-    id: 'learn',
-    label: '/learn',
-    command: '/learn',
-    agentName: 'Worker',
-    task: 'Extract patterns into AGENTS.md',
+    id: 'pr-create',
+    label: '/pr/create',
+    command: '/pr/create',
+    agentName: 'Build',
+    task: 'Summarize branch work and publish a structured PR',
+    group: 'pr',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Learning — need to inspect existing patterns in the repo and extract reusable guidance into AGENTS.md targets.'
+        content: 'Creating PR — loading branch changes and reading modified files to group themes. Will resolve ticket handling before publishing.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
-          { tool: 'read', args: 'AGENTS.md', status: 'complete' },
-          { tool: 'grep', args: 'function|const|class', status: 'complete' },
-          { tool: 'apply_patch', args: 'AGENTS.md', status: 'complete' }
+          { tool: 'changes_load', args: 'HEAD...main', status: 'complete' },
+          { tool: 'read', args: 'packages/web/src/components/*.astro', status: 'complete' },
+          { tool: 'question', args: 'Auto-create ticket, skip, or provide ticket?', status: 'complete' },
+          { tool: 'ticket_sync', args: 'auto-create ticket #43', status: 'complete' },
+          { tool: 'bash', args: 'git push origin HEAD', status: 'complete' },
+          { tool: 'pr_sync', args: 'create PR with checklists', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Summarized established conventions',
-          'Updated agent guidance where the pattern belongs'
+          'Analyzed changes and grouped into functional themes',
+          'Auto-created ticket #43 for tracking',
+          'Created PR #47: Add workflow visualization to homepage'
         ]
       }
     ]
@@ -414,27 +436,32 @@ const scenarios: CommandScenario[] = [
     command: '/pr/fix',
     agentName: 'Build',
     task: 'Fix requested PR changes',
+    group: 'pr',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Fixing PR — need to load PR history and outstanding feedback, then review proposed fixes before applying.'
+        content: 'Fixing PR — loading PR #47 with review comments and feedback threads, then proposing fixes for approval before applying.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
-          { tool: 'pr_load', args: 'current', status: 'complete' },
-          { tool: 'apply_patch', args: 'requested changes', status: 'complete' },
-          { tool: 'bash', args: 'npm run test', status: 'complete' }
+          { tool: 'pr_load', args: '#47', status: 'complete' },
+          { tool: 'question', args: 'Apply these 3 fixes?', status: 'complete' },
+          { tool: 'apply_patch', args: 'fix error handling in utils.ts', status: 'complete' },
+          { tool: 'bash', args: 'git commit -m "fix: address review feedback"', status: 'complete' },
+          { tool: 'bash', args: 'git push origin HEAD', status: 'complete' },
+          { tool: 'pr_sync', args: 'reply to review threads', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Fixed requested issues on the branch',
-          'Posted replies to the relevant review threads'
+          'Proposed 3 fixes for review feedback',
+          'Applied fixes after user approval',
+          'Pushed commit and replied to inline comments'
         ]
       }
     ]
@@ -445,36 +472,179 @@ const scenarios: CommandScenario[] = [
     command: '/pr/review',
     agentName: 'Reviewer',
     task: 'Review PR with inline comments',
+    group: 'pr',
     steps: [
       {
         id: 'thinking',
         phase: 'thinking',
-        content: 'Reviewing PR — need to load PR, reviews, comments, files, and diff context. Will load linked ticket too before reviewing.'
+        content: 'Reviewing PR — loading PR #47, linked ticket, and diff context. Will analyze changes and publish a formal review with inline comments and grade.'
       },
       {
         id: 'tools',
         phase: 'tool_calls',
         toolCalls: [
-          { tool: 'pr_load', args: 'current', status: 'complete' },
+          { tool: 'pr_load', args: '#47', status: 'complete' },
           { tool: 'ticket_load', args: '#42', status: 'complete' },
-          { tool: 'changes_load', args: 'HEAD...main', status: 'complete' }
+          { tool: 'changes_load', args: 'HEAD...main', status: 'complete' },
+          { tool: 'pr_sync', args: 'publish review with comments', status: 'complete' }
+        ]
+      },
+      {
+        id: 'output',
+        phase: 'output',
+        output: [
+          'Grade: ★★★★☆ — solid implementation with minor issues',
+          'Line 45: Consider extracting this into a helper function',
+          'Line 78: Add null check before accessing property',
+          'Line 124: Typo in variable name "recieve" → "receive"'
+        ]
+      }
+    ]
+  },
+  {
+    id: 'review',
+    label: '/review',
+    command: '/review',
+    agentName: 'Reviewer',
+    task: 'Review branch changes without editing files',
+    group: 'pr',
+    steps: [
+      {
+        id: 'thinking',
+        phase: 'thinking',
+        content: 'Reviewing changes — loading diff context and reading modified files to provide inline feedback and risk assessment without making edits.'
+      },
+      {
+        id: 'tools',
+        phase: 'tool_calls',
+        toolCalls: [
+          { tool: 'changes_load', args: 'uncommitted', status: 'complete' },
+          { tool: 'read', args: 'packages/web/src/components/CommandShowcase.astro', status: 'complete' },
+          { tool: 'task', args: 'reviewer analysis', status: 'complete' }
+        ]
+      },
+      {
+        id: 'output',
+        phase: 'output',
+        output: [
+          'Grade: ★★★★☆ — clean implementation, minor suggestions',
+          'Line 45: Consider extracting this into a helper function',
+          'Line 78: Add null check before accessing property',
+          'Line 124: Typo in variable name "recieve" → "receive"'
+        ]
+      }
+    ]
+  },
+
+  // Orchestration commands
+  {
+    id: 'dev',
+    label: '/dev',
+    command: '/dev implement the approved workflow in packages/core',
+    agentName: 'Navigator',
+    task: 'Orchestrate implementation with validation and checkpointing',
+    group: 'orchestration',
+    steps: [
+      {
+        id: 'thinking',
+        phase: 'thinking',
+        content: 'Planning implementation — loading ticket context and preparing to delegate tasks to workers. Will coordinate edits and validation checkpoints.'
+      },
+      {
+        id: 'tools',
+        phase: 'tool_calls',
+        toolCalls: [
+          { tool: 'ticket_load', args: '#128', status: 'complete' },
+          { tool: 'dispatch', args: '/ticket/plan', status: 'complete' },
+          { tool: 'dispatch', args: '/dev worker', status: 'complete' },
+          { tool: 'dispatch', args: '/commit-and-push', status: 'complete' }
+        ]
+      },
+      {
+        id: 'output',
+        phase: 'output',
+        output: [
+          'Planned implementation in coordination with ticket',
+          'Delegated to worker for file edits and validation',
+          'Committed changes and pushed to remote'
+        ]
+      }
+    ]
+  },
+  {
+    id: 'ship',
+    label: '/ship',
+    command: '/ship',
+    agentName: 'Navigator',
+    task: 'Fast path from changes to PR',
+    group: 'orchestration',
+    steps: [
+      {
+        id: 'thinking',
+        phase: 'thinking',
+        content: 'Shipping — need to create a work branch, commit changes, and publish a PR. Will orchestrate the full workflow from current state to pull request.'
+      },
+      {
+        id: 'tools',
+        phase: 'tool_calls',
+        toolCalls: [
+          { tool: 'dispatch', args: '/branch feature/new-workflow', status: 'complete' },
+          { tool: 'dispatch', args: '/commit', status: 'complete' },
+          { tool: 'dispatch', args: '/pr/create', status: 'complete' }
         ]
       },
       {
         id: 'output',
         phase: 'output',
         output: [
-          'Added inline comments and review summary',
-          'Approved or requested changes based on findings'
+          'Created branch: feature/new-workflow',
+          'Committed 3 files with generated message',
+          'Published PR #48: Add new workflow command'
+        ]
+      }
+    ]
+  },
+  {
+    id: 'todo',
+    label: '/todo',
+    command: '/todo @TODO.md',
+    agentName: 'Navigator',
+    task: 'Work through a todo list with checkpoint reviews',
+    group: 'orchestration',
+    steps: [
+      {
+        id: 'thinking',
+        phase: 'thinking',
+        content: 'Processing todo — loading the todo list and keeping orchestration local. Will ask for plan approval before implementation starts.'
+      },
+      {
+        id: 'tools',
+        phase: 'tool_calls',
+        toolCalls: [
+          { tool: 'read', args: 'TODO.md', status: 'complete' },
+          { tool: 'dispatch', args: '/ticket/plan #42', status: 'complete' },
+          { tool: 'dispatch', args: '/dev', status: 'complete' },
+          { tool: 'dispatch', args: '/commit', status: 'complete' }
+        ]
+      },
+      {
+        id: 'output',
+        phase: 'output',
+        output: [
+          'Completed: Update command showcase with more examples',
+          'Blocked: Waiting for review on PR #47',
+          'Next: Add mobile responsive styling'
         ]
       }
     ]
   }
 ];
 
-// Split scenarios into two groups
-const orchestratorScenarios = scenarios.filter(s => s.agentName === 'Navigator');
-const commandScenarios = scenarios.filter(s => s.agentName !== 'Navigator');
+// Group scenarios
+const coreScenarios = scenarios.filter(s => s.group === 'core');
+const ticketScenarios = scenarios.filter(s => s.group === 'ticket');
+const prScenarios = scenarios.filter(s => s.group === 'pr');
+const orchestrationScenarios = scenarios.filter(s => s.group === 'orchestration');
 
 ---
 
@@ -488,13 +658,13 @@ const commandScenarios = scenarios.filter(s => s.agentName !== 'Navigator');
   </div>
 
   <div class="command-showcase__main">
-    <!-- Two fieldsets side-by-side, centered, exploding container -->
+    <!-- Four fieldsets side-by-side, centered, exploding container -->
     <div class="command-groups-wrapper">
       <div class="command-groups">
         <fieldset class="command-group">
-          <legend class="command-group__legend">Commands</legend>
+          <legend class="command-group__legend">Core</legend>
           <div class="command-group__tabs">
-            {commandScenarios.map((scenario, index) => (
+            {coreScenarios.map((scenario, index) => (
               <button 
                 type="button"
                 class:list={{ "command-tab": true, "is-active": index === 0 }}
@@ -510,13 +680,51 @@ const commandScenarios = scenarios.filter(s => s.agentName !== 'Navigator');
           </div>
         </fieldset>
         
-        <fieldset class="command-group command-group--orchestrators">
-          <legend class="command-group__legend">Orchestrators</legend>
+        <fieldset class="command-group command-group--ticket">
+          <legend class="command-group__legend">Ticket</legend>
+          <div class="command-group__tabs">
+            {ticketScenarios.map((scenario) => (
+              <button 
+                type="button"
+                class:list={{ "command-tab command-tab--ticket": true }}
+                role="tab"
+                aria-selected="false"
+                aria-controls={`panel-${scenario.id}`}
+                id={`tab-${scenario.id}`}
+                data-command-tab={scenario.id}
+              >
+                {scenario.label}
+              </button>
+            ))}
+          </div>
+        </fieldset>
+
+        <fieldset class="command-group command-group--pr">
+          <legend class="command-group__legend">PR</legend>
+          <div class="command-group__tabs">
+            {prScenarios.map((scenario) => (
+              <button 
+                type="button"
+                class:list={{ "command-tab command-tab--pr": true }}
+                role="tab"
+                aria-selected="false"
+                aria-controls={`panel-${scenario.id}`}
+                id={`tab-${scenario.id}`}
+                data-command-tab={scenario.id}
+              >
+                {scenario.label}
+              </button>
+            ))}
+          </div>
+        </fieldset>
+        
+        <fieldset class="command-group command-group--orchestration">
+          <legend class="command-group__legend">Orchestration</legend>
           <div class="command-group__tabs">
-            {orchestratorScenarios.map((scenario) => (
+            {orchestrationScenarios.map((scenario) => (
               <button 
                 type="button"
-                class:list={{ "command-tab command-tab--orchestrator": true }}
+                class:list={{ "command-tab command-tab--orchestration": true }}
                 role="tab"
                 aria-selected="false"
                 aria-controls={`panel-${scenario.id}`}
@@ -740,6 +948,7 @@ const commandScenarios = scenarios.filter(s => s.agentName !== 'Navigator');
     
     const tabs = showcase.querySelectorAll('[data-command-tab]');
     const panels = showcase.querySelectorAll('[data-scenario-panel]');
+    const groupsWrapper = showcase.querySelector('.command-groups-wrapper') as HTMLElement;
     
     // Tab switching
     tabs.forEach(tab => {
@@ -767,13 +976,44 @@ const commandScenarios = scenarios.filter(s => s.agentName !== 'Navigator');
       });
     });
     
-    // Animate first panel on load
-    const firstPanel = showcase.querySelector('[data-scenario-panel]') as HTMLElement;
-    if (firstPanel) {
+    // Default to ticket-dev
+    const defaultTab = showcase.querySelector('[data-command-tab="ticket-dev"]') as HTMLElement;
+    const defaultPanel = showcase.querySelector('[data-scenario-panel="ticket-dev"]') as HTMLElement;
+    
+    if (defaultTab && defaultPanel) {
+      // Reset all tabs and panels
+      tabs.forEach(t => {
+        t.classList.remove('is-active');
+        t.setAttribute('aria-selected', 'false');
+      });
+      panels.forEach(p => {
+        p.classList.remove('is-active');
+        p.setAttribute('hidden', '');
+      });
+      
+      // Activate default
+      defaultTab.classList.add('is-active');
+      defaultTab.setAttribute('aria-selected', 'true');
+      defaultPanel.classList.add('is-active');
+      defaultPanel.removeAttribute('hidden');
+      
+      // Center scroll on the active tab's group
+      if (groupsWrapper) {
+        const tabGroup = defaultTab.closest('.command-group') as HTMLElement;
+        if (tabGroup) {
+          const wrapperWidth = groupsWrapper.offsetWidth;
+          const groupWidth = tabGroup.offsetWidth;
+          const groupLeft = tabGroup.offsetLeft;
+          const scrollLeft = groupLeft - (wrapperWidth / 2) + (groupWidth / 2);
+          groupsWrapper.scrollLeft = scrollLeft;
+        }
+      }
+      
+      // Animate when visible
       const observer = new IntersectionObserver((entries) => {
         entries.forEach(entry => {
           if (entry.isIntersecting) {
-            animateScenario(firstPanel);
+            animateScenario(defaultPanel);
             observer.disconnect();
           }
         });
@@ -874,7 +1114,7 @@ const commandScenarios = scenarios.filter(s => s.agentName !== 'Navigator');
     z-index: 1;
   }
 
-  /* Tabs - two fieldsets side-by-side on single line with horizontal scroll */
+  /* Tabs - four fieldsets side-by-side on single line with horizontal scroll */
   .command-groups-wrapper {
     position: relative;
     width: 100vw;
@@ -920,7 +1160,17 @@ const commandScenarios = scenarios.filter(s => s.agentName !== 'Navigator');
     flex-shrink: 0;
   }
 
-  .command-group--orchestrators {
+  .command-group--ticket {
+    border-color: rgba(139, 92, 246, 0.25);
+    background: rgba(139, 92, 246, 0.1);
+  }
+
+  .command-group--pr {
+    border-color: rgba(34, 197, 94, 0.25);
+    background: rgba(34, 197, 94, 0.1);
+  }
+
+  .command-group--orchestration {
     border-color: rgba(95, 158, 197, 0.25);
     background: rgba(95, 158, 197, 0.1);
   }
@@ -936,7 +1186,17 @@ const commandScenarios = scenarios.filter(s => s.agentName !== 'Navigator');
     border-radius: 0.25rem;
   }
 
-  .command-group--orchestrators .command-group__legend {
+  .command-group--ticket .command-group__legend {
+    color: rgba(139, 92, 246, 0.9);
+    background: rgba(139, 92, 246, 0.2);
+  }
+
+  .command-group--pr .command-group__legend {
+    color: rgba(34, 197, 94, 0.9);
+    background: rgba(34, 197, 94, 0.2);
+  }
+
+  .command-group--orchestration .command-group__legend {
     color: rgba(95, 158, 197, 0.9);
     background: rgba(95, 158, 197, 0.2);
   }
@@ -976,13 +1236,37 @@ const commandScenarios = scenarios.filter(s => s.agentName !== 'Navigator');
     color: var(--text);
   }
 
-  .command-tab--orchestrator {
+  .command-tab--ticket {
+    border-color: rgba(139, 92, 246, 0.25);
+    background: rgba(139, 92, 246, 0.1);
+  }
+
+  .command-tab--ticket:hover,
+  .command-tab--ticket.is-active {
+    border-color: rgba(139, 92, 246, 0.45);
+    background: rgba(139, 92, 246, 0.18);
+    color: var(--text);
+  }
+
+  .command-tab--pr {
+    border-color: rgba(34, 197, 94, 0.25);
+    background: rgba(34, 197, 94, 0.1);
+  }
+
+  .command-tab--pr:hover,
+  .command-tab--pr.is-active {
+    border-color: rgba(34, 197, 94, 0.45);
+    background: rgba(34, 197, 94, 0.18);
+    color: var(--text);
+  }
+
+  .command-tab--orchestration {
     border-color: rgba(95, 158, 197, 0.25);
     background: rgba(95, 158, 197, 0.1);
   }
 
-  .command-tab--orchestrator:hover,
-  .command-tab--orchestrator.is-active {
+  .command-tab--orchestration:hover,
+  .command-tab--orchestration.is-active {
     border-color: rgba(95, 158, 197, 0.45);
     background: rgba(95, 158, 197, 0.18);
     color: var(--text);
@@ -1418,4 +1702,4 @@ const commandScenarios = scenarios.filter(s => s.agentName !== 'Navigator');
       gap: 0.4rem;
     }
   }
-</style>
\ No newline at end of file
+</style>
diff --git a/packages/web/src/content/docs/docs/reference/commands/index.mdx b/packages/web/src/content/docs/docs/reference/commands/index.mdx
index 861faa1..51c61ac 100644
--- a/packages/web/src/content/docs/docs/reference/commands/index.mdx
+++ b/packages/web/src/content/docs/docs/reference/commands/index.mdx
@@ -7,11 +7,10 @@ Kompass ships workflow-oriented commands authored as explicit templates in `pack
 
 ## Groups
 
-- General: `/ask`, `/learn`, `/reload`, `/branch`, `/rmslop`
-- Development: `/dev`, `/todo`, `/ship`
-- Review: `/review`, `/pr/review`, `/pr/fix`
-- Git: `/commit`, `/commit-and-push`, `/pr/create`
-- Tickets: `/ticket/create`, `/ticket/ask`, `/ticket/dev`, `/ticket/plan`, `/ticket/plan-and-sync`
+- Core: `/ask`, `/branch`, `/commit`, `/commit-and-push`, `/learn`, `/rmslop`
+- Ticket: `/ticket/ask`, `/ticket/create`, `/ticket/dev`, `/ticket/plan`, `/ticket/plan-and-sync`
+- PR: `/pr/create`, `/pr/fix`, `/pr/review`, `/review`
+- Orchestration: `/dev`, `/ship`, `/todo`
 
 ## What makes them different
 
@@ -20,7 +19,7 @@ Kompass ships workflow-oriented commands authored as explicit templates in `pack
 - navigator workflows orchestrate locally and delegate focused leaf work
 - outputs are written to be deterministic and reviewable
 
-## General workflows
+## Core workflows
 
 ### `/ask`
 
@@ -38,6 +37,22 @@ Creates and switches to a categorized work branch from current uncommitted chang
 - arguments: optional branch naming guidance
 - expected tools: `changes_load(uncommitted)`, `git checkout -b`
 
+### `/commit`
+
+Creates a commit with an appropriate message summarizing uncommitted changes.
+
+- usage: `/commit [message-guidance]`
+- arguments: optional commit message guidance
+- expected tools: `changes_load(uncommitted)`, staging/commit git commands
+
+### `/commit-and-push`
+
+Creates a commit and immediately pushes it to the remote repository.
+
+- usage: `/commit-and-push [message-guidance]`
+- arguments: optional commit message guidance
+- expected tools: `changes_load(uncommitted)`, git commit, `git push`
+
 ### `/learn`
 
 Extracts non-obvious learnings from the current session and documents them appropriately.
@@ -46,14 +61,6 @@ Extracts non-obvious learnings from the current session and documents them appro
 - arguments: optional scope or extra guidance
 - expected tools: `read`, `grep`, `apply_patch`
 
-### `/reload`
-
-Reloads the current OpenCode project cache.
-
-- usage: `/reload`
-- arguments: ignored
-- expected tools: `reload`
-
 ### `/rmslop`
 
 Removes AI-generated code slop and inconsistencies from branch changes.
@@ -62,59 +69,57 @@ Removes AI-generated code slop and inconsistencies from branch changes.
 - arguments: optional base branch or cleanup guidance
 - expected tools: `changes_load`, file-edit tools, validation commands, commit git commands
 
-## Git workflows
-
-### `/commit`
+## Ticket workflows
 
-Creates a commit with an appropriate message summarizing uncommitted changes.
+### `/ticket/ask`
 
-- usage: `/commit [message-guidance]`
-- arguments: optional commit message guidance
-- expected tools: `changes_load(uncommitted)`, staging/commit git commands
+Loads a ticket and its discussion, answers the question, and posts the answer back to the ticket.
 
-### `/commit-and-push`
+- usage: `/ticket/ask <ticket-reference> <question>`
+- arguments: ticket reference plus question; auto-derives the question from the conversation when needed
+- expected tools: `ticket_load(comments)`, repository context tools as needed, `ticket_sync`
 
-Creates a commit and immediately pushes it to the remote repository.
+### `/ticket/create`
 
-- usage: `/commit-and-push [message-guidance]`
-- arguments: optional commit message guidance
-- expected tools: `changes_load(uncommitted)`, git commit, `git push`
+Creates a ticket summarizing the current change comparison.
 
-### `/pr/create`
+- usage: `/ticket/create [base-or-context]`
+- arguments: optional base branch or additional context; auto-discovers comparison mode when omitted
+- expected tools: `changes_load`, `ticket_sync`
 
-Creates a pull request for the current branch, including ticket handling when needed.
+### `/ticket/dev`
 
-- usage: `/pr/create [context]`
-- arguments: optional base branch, ticket directive, ticket reference, or additional context
-- expected tools: `changes_load`, `question` when ticket handling is unresolved, `ticket_sync` when auto-creating a ticket, `git push`, `pr_sync`
+Implements a ticket by orchestrating development, branching, commit-and-push, and PR creation.
 
-## Development workflows
+- usage: `/ticket/dev <ticket-reference>`
+- arguments: ticket reference, URL, file path, or raw request
+- expected tools: `ticket_load`, delegated `/dev`, delegated `/branch`, delegated `/commit-and-push`, delegated `/pr/create`
 
-### `/dev`
+### `/ticket/plan`
 
-Implements a feature or fix, validates the result, and prepares a PR handoff.
+Creates a scoped implementation plan from a request or ticket without modifying ticket state.
 
-- usage: `/dev <description>`
-- arguments: direct implementation guidance or a ticket-like source
-- expected tools: `ticket_load` only when a ticket-like source is provided, file-edit tools, validation commands
+- usage: `/ticket/plan <ticket-reference-or-request>`
+- arguments: ticket reference, URL, request text, or planning guidance
+- expected tools: `ticket_load(comments)` when planning from a ticket, light repo reconnaissance tools
 
-### `/ship`
+### `/ticket/plan-and-sync`
 
-Ships current work by delegating branch creation, commit creation, and PR creation.
+Creates a scoped implementation plan from a request or ticket and stores that plan in the ticket flow.
 
-- usage: `/ship [context]`
-- arguments: optional base branch, branch naming guidance, or additional shipping context
-- expected tools: delegated `/branch`, delegated `/commit`, delegated `/pr/create`
+- usage: `/ticket/plan-and-sync <ticket-reference-or-request>`
+- arguments: ticket reference, URL, request text, or planning guidance
+- expected tools: `ticket_load(comments)` when planning from a ticket, light repo reconnaissance tools, `ticket_sync`
 
-### `/todo`
+## PR workflows
 
-Works through a todo file one pending item at a time with planning, approval, implementation, and commit loops.
+### `/pr/create`
 
-- usage: `/todo [@todo-file]`
-- arguments: optional `@file` reference and execution guidance; defaults to `@TODO.md`
-- expected tools: `read`, delegated `/ticket/plan`, `question`, delegated `/dev`, delegated `/commit`
+Creates a pull request for the current branch, including ticket handling when needed.
 
-## Review workflows
+- usage: `/pr/create [context]`
+- arguments: optional base branch, ticket directive, ticket reference, or additional context
+- expected tools: `changes_load`, `question` when ticket handling is unresolved, `ticket_sync` when auto-creating a ticket, `git push`, `pr_sync`
 
 ### `/pr/fix`
 
@@ -140,44 +145,28 @@ Reviews code changes and provides actionable feedback with a grade and risk asse
 - arguments: optional base branch, `uncommitted`, or review focus guidance
 - expected tools: `changes_load`, read changed files, reviewer analysis
 
-## Ticket workflows
-
-### `/ticket/ask`
-
-Loads a ticket and its discussion, answers the question, and posts the answer back to the ticket.
-
-- usage: `/ticket/ask <ticket-reference> <question>`
-- arguments: ticket reference plus question; auto-derives the question from the conversation when needed
-- expected tools: `ticket_load(comments)`, repository context tools as needed, `ticket_sync`
-
-### `/ticket/create`
-
-Creates a ticket summarizing the current change comparison.
-
-- usage: `/ticket/create [base-or-context]`
-- arguments: optional base branch or additional context; auto-discovers comparison mode when omitted
-- expected tools: `changes_load`, `ticket_sync`
+## Orchestration workflows
 
-### `/ticket/dev`
+### `/dev`
 
-Implements a ticket by orchestrating development, branching, commit-and-push, and PR creation.
+Implements a feature or fix, validates the result, and prepares a PR handoff.
 
-- usage: `/ticket/dev <ticket-reference>`
-- arguments: ticket reference, URL, file path, or raw request
-- expected tools: `ticket_load`, delegated `/dev`, delegated `/branch`, delegated `/commit-and-push`, delegated `/pr/create`
+- usage: `/dev <description>`
+- arguments: direct implementation guidance or a ticket-like source
+- expected tools: `ticket_load` only when a ticket-like source is provided, file-edit tools, validation commands
 
-### `/ticket/plan`
+### `/ship`
 
-Creates a scoped implementation plan from a request or ticket without modifying ticket state.
+Ships current work by delegating branch creation, commit creation, and PR creation.
 
-- usage: `/ticket/plan <ticket-reference-or-request>`
-- arguments: ticket reference, URL, request text, or planning guidance
-- expected tools: `ticket_load(comments)` when planning from a ticket, light repo reconnaissance tools
+- usage: `/ship [context]`
+- arguments: optional base branch, branch naming guidance, or additional shipping context
+- expected tools: delegated `/branch`, delegated `/commit`, delegated `/pr/create`
 
-### `/ticket/plan-and-sync`
+### `/todo`
 
-Creates a scoped implementation plan from a request or ticket and stores that plan in the ticket flow.
+Works through a todo file one pending item at a time with planning, approval, implementation, and commit loops.
 
-- usage: `/ticket/plan-and-sync <ticket-reference-or-request>`
-- arguments: ticket reference, URL, request text, or planning guidance
-- expected tools: `ticket_load(comments)` when planning from a ticket, light repo reconnaissance tools, `ticket_sync`
+- usage: `/todo [@todo-file]`
+- arguments: optional `@file` reference and execution guidance; defaults to `@TODO.md`
+- expected tools: `read`, delegated `/ticket/plan`, `question`, delegated `/dev`, delegated `/commit`
diff --git a/packages/web/src/content/docs/docs/reference/commands/reload.mdx b/packages/web/src/content/docs/docs/reference/commands/reload.mdx
deleted file mode 100644
index 4f57379..0000000
--- a/packages/web/src/content/docs/docs/reference/commands/reload.mdx
+++ /dev/null
@@ -1,23 +0,0 @@
----
-title: /reload
-description: Reload the current OpenCode project cache after config or template changes.
----
-
-## Purpose
-
-Use `/reload` after changing Kompass config, commands, agents, or tools.
-
-## Usage
-
-```text
-/reload
-```
-
-## Typical flow
-
-- refresh the OpenCode project cache
-- make the new config active without restarting the app
-
-## Common tools
-
-- `reload`

From cca405910792969fd69b31a2e2f408fb34416eb9 Mon Sep 17 00:00:00 2001
From: dbpolito <danielbpolito@gmail.com>
Date: Fri, 27 Mar 2026 12:33:29 -0300
Subject: [PATCH 2/3] fix: remove reload references from schema, tests, and
 docs per PR feedback

---
 kompass.schema.json                              |  5 -----
 packages/opencode/test/commands-config.test.ts   | 16 ----------------
 .../content/docs/docs/reference/tools/index.mdx  |  2 +-
 3 files changed, 1 insertion(+), 22 deletions(-)

diff --git a/kompass.schema.json b/kompass.schema.json
index eeb0e2d..76ca196 100644
--- a/kompass.schema.json
+++ b/kompass.schema.json
@@ -59,9 +59,6 @@
         "pr/review": {
           "$ref": "#/$defs/commandConfig"
         },
-        "reload": {
-          "$ref": "#/$defs/commandConfig"
-        },
         "review": {
           "$ref": "#/$defs/commandConfig"
         },
@@ -103,7 +100,6 @@
               "pr/create",
               "pr/fix",
               "pr/review",
-              "reload",
               "review",
               "ship",
               "rmslop",
@@ -131,7 +127,6 @@
               "pr/create",
               "pr/fix",
               "pr/review",
-              "reload",
               "review",
               "ship",
               "rmslop",
diff --git a/packages/opencode/test/commands-config.test.ts b/packages/opencode/test/commands-config.test.ts
index dc6a1ba..17418fa 100644
--- a/packages/opencode/test/commands-config.test.ts
+++ b/packages/opencode/test/commands-config.test.ts
@@ -34,7 +34,6 @@ describe("applyCommandsConfig", () => {
       const expectedCommands = [
         "ask",
         "branch",
-        "reload",
         "pr/create",
         "pr/review",
         "pr/fix",
@@ -61,7 +60,6 @@ describe("applyCommandsConfig", () => {
       assert.ok(cfg.command);
       assert.equal(cfg.command!["pr/review"]?.agent, "reviewer");
       assert.equal(cfg.command!["branch"]?.agent, "build");
-      assert.equal(cfg.command!["reload"]?.agent, "build");
       assert.equal(cfg.command!["pr/create"]?.agent, "build");
       assert.equal(cfg.command!["ticket/create"]?.agent, "build");
       assert.equal(cfg.command!["ticket/plan"]?.agent, "planner");
@@ -72,7 +70,6 @@ describe("applyCommandsConfig", () => {
       assert.equal(cfg.command!["ship"]?.agent, "navigator");
       assert.equal(cfg.command!["todo"]?.agent, "navigator");
       assert.ok(cfg.command!["pr/review"]?.description);
-      assert.ok(cfg.command!["reload"]?.template);
       assert.ok(cfg.command!["dev"]?.template);
       assert.ok(cfg.command!["branch"]?.template);
     });
@@ -112,19 +109,6 @@ describe("applyCommandsConfig", () => {
       assert.doesNotMatch(fixTemplate, /`pr_review`/);
     });
 
-    test("rewrites project reload tool name with opencode prefix", async () => {
-      delete process.env.CI;
-      const cfg: { command?: Record<string, { template: string }> } = {};
-
-      await applyCommandsConfig(cfg as never, process.cwd());
-
-      assert.ok(cfg.command);
-      const reloadTemplate = cfg.command!["reload"].template;
-
-      assert.match(reloadTemplate, /`kompass_reload`/);
-      assert.doesNotMatch(reloadTemplate, /Call `reload` with no parameters\./);
-    });
-
     test("rewrites tool references with configured aliases", async () => {
       delete process.env.CI;
       const tempDir = await mkdtemp(path.join(os.tmpdir(), "kompass-commands-"));
diff --git a/packages/web/src/content/docs/docs/reference/tools/index.mdx b/packages/web/src/content/docs/docs/reference/tools/index.mdx
index 58255eb..80bbb91 100644
--- a/packages/web/src/content/docs/docs/reference/tools/index.mdx
+++ b/packages/web/src/content/docs/docs/reference/tools/index.mdx
@@ -56,4 +56,4 @@ Creates or updates a GitHub issue with checklist support.
 Refreshes the active OpenCode project cache.
 
 - inputs: none
-- used by: `/reload`
+- used by: internal refresh (no longer has a user-facing command)

From a34a9b815e44d35a8f0d5fb6f160c2546719c395 Mon Sep 17 00:00:00 2001
From: dbpolito <danielbpolito@gmail.com>
Date: Fri, 27 Mar 2026 12:38:45 -0300
Subject: [PATCH 3/3] refactor: completely remove reload command and tool from
 entire codebase

---
 kompass.jsonc                                 |  1 -
 kompass.schema.json                           |  6 +----
 packages/core/commands/index.ts               |  6 -----
 packages/core/kompass.jsonc                   |  1 -
 packages/core/lib/config.ts                   |  7 ------
 packages/opencode/.opencode/kompass.jsonc     |  3 ---
 packages/opencode/index.ts                    | 24 -------------------
 packages/opencode/kompass.jsonc               |  1 -
 .../opencode/test/tool-registration.test.ts   |  5 +---
 .../docs/docs/reference/tools/index.mdx       |  8 -------
 .../docs/docs/reference/tools/reload.mdx      | 18 --------------
 11 files changed, 2 insertions(+), 78 deletions(-)
 delete mode 100644 packages/web/src/content/docs/docs/reference/tools/reload.mdx

diff --git a/kompass.jsonc b/kompass.jsonc
index 21a63e0..48c53fd 100644
--- a/kompass.jsonc
+++ b/kompass.jsonc
@@ -44,7 +44,6 @@
     "pr_sync": { "enabled": true },
     "ticket_load": { "enabled": true },
     "ticket_sync": { "enabled": true },
-    "reload": { "enabled": true },
   },
 
   "components": {
diff --git a/kompass.schema.json b/kompass.schema.json
index 76ca196..e9a9338 100644
--- a/kompass.schema.json
+++ b/kompass.schema.json
@@ -190,9 +190,6 @@
         },
         "ticket_load": {
           "$ref": "#/$defs/toolConfig"
-        },
-        "reload": {
-          "$ref": "#/$defs/toolConfig"
         }
       }
     },
@@ -428,8 +425,7 @@
         "pr_load",
         "pr_sync",
         "ticket_sync",
-        "ticket_load",
-        "reload"
+        "ticket_load"
       ]
     }
   }
diff --git a/packages/core/commands/index.ts b/packages/core/commands/index.ts
index 0b2656d..60245eb 100644
--- a/packages/core/commands/index.ts
+++ b/packages/core/commands/index.ts
@@ -42,12 +42,6 @@ export const commandDefinitions: Record<string, CommandDefinition> = {
     templatePath: "commands/learn.md",
     subtask: false,
   },
-  reload: {
-    description: "Reload the current OpenCode project configuration",
-    agent: "build",
-    templatePath: "commands/reload.md",
-    subtask: false,
-  },
   "pr/create": {
     description: "Summarize branch work and create a PR",
     agent: "build",
diff --git a/packages/core/kompass.jsonc b/packages/core/kompass.jsonc
index 21a63e0..48c53fd 100644
--- a/packages/core/kompass.jsonc
+++ b/packages/core/kompass.jsonc
@@ -44,7 +44,6 @@
     "pr_sync": { "enabled": true },
     "ticket_load": { "enabled": true },
     "ticket_sync": { "enabled": true },
-    "reload": { "enabled": true },
   },
 
   "components": {
diff --git a/packages/core/lib/config.ts b/packages/core/lib/config.ts
index d4e4ce1..272cbf1 100644
--- a/packages/core/lib/config.ts
+++ b/packages/core/lib/config.ts
@@ -18,7 +18,6 @@ export const DEFAULT_TOOL_NAMES = [
   "pr_sync",
   "ticket_sync",
   "ticket_load",
-  "reload",
 ] as const;
 
 export const DEFAULT_COMMAND_NAMES = [
@@ -31,7 +30,6 @@ export const DEFAULT_COMMAND_NAMES = [
   "pr/create",
   "pr/fix",
   "pr/review",
-  "reload",
   "review",
   "ship",
   "rmslop",
@@ -114,7 +112,6 @@ export interface KompassConfig {
     "pr/create"?: CommandConfig;
     "pr/fix"?: CommandConfig;
     "pr/review"?: CommandConfig;
-    reload?: CommandConfig;
     review?: CommandConfig;
     ship?: CommandConfig;
     rmslop?: CommandConfig;
@@ -140,7 +137,6 @@ export interface KompassConfig {
     pr_sync?: ToolConfig;
     ticket_sync?: ToolConfig;
     ticket_load?: ToolConfig;
-    reload?: ToolConfig;
   };
   components?: {
     "change-summary"?: ComponentConfig;
@@ -189,7 +185,6 @@ export interface MergedKompassConfig {
     pr_sync: ToolConfig;
     ticket_sync: ToolConfig;
     ticket_load: ToolConfig;
-    reload: ToolConfig;
   };
   components: {
     enabled: string[];
@@ -480,7 +475,6 @@ const defaultToolConfig: Record<ToolName, ToolConfig> = {
   pr_sync: { enabled: true },
   ticket_sync: { enabled: true },
   ticket_load: { enabled: true },
-  reload: { enabled: true },
 };
 
 function getToggleEntry<T extends ToggleConfig>(
@@ -666,7 +660,6 @@ export function mergeWithDefaults(
       pr_sync: { ...defaultToolConfig.pr_sync, ...config?.tools?.pr_sync },
       ticket_sync: { ...defaultToolConfig.ticket_sync, ...config?.tools?.ticket_sync },
       ticket_load: { ...defaultToolConfig.ticket_load, ...config?.tools?.ticket_load },
-      reload: { ...defaultToolConfig.reload, ...config?.tools?.reload },
     },
     components: {
       enabled: getEnabledNames(
diff --git a/packages/opencode/.opencode/kompass.jsonc b/packages/opencode/.opencode/kompass.jsonc
index 22b63b7..f4bb040 100644
--- a/packages/opencode/.opencode/kompass.jsonc
+++ b/packages/opencode/.opencode/kompass.jsonc
@@ -91,9 +91,6 @@
     },
     "ticket_load": {
       "enabled": true
-    },
-    "reload": {
-      "enabled": true
     }
   },
   "defaults": {
diff --git a/packages/opencode/index.ts b/packages/opencode/index.ts
index bb3e2fd..a7772c7 100644
--- a/packages/opencode/index.ts
+++ b/packages/opencode/index.ts
@@ -216,27 +216,6 @@ export function removeSyntheticAgentHandoff(output: ChatMessageOutput): boolean
   return true;
 }
 
-function createReloadTool(client: PluginInput["client"]) {
-  return tool({
-    description: "Reload the current OpenCode project cache",
-    args: {},
-    async execute(_, context) {
-      // Defer dispose so the tool returns before the session is torn down
-      setTimeout(() => {
-        void client.instance.dispose({ query: { directory: context.directory } }).catch((error) => {
-          console.error("[kompass] Failed to dispose instance during reload:", error);
-        });
-      }, 500);
-      return JSON.stringify({
-        scope: "project",
-        directory: context.directory,
-        status: "reload-requested",
-        nextLoad: "config, commands, agents, custom tools, and plugins rebuild on next access",
-      }, null, 2);
-    },
-  });
-}
-
 const opencodeToolCreators = {
   changes_load($: PluginInput["$"], _: PluginInput["client"], __: MergedKompassConfig) {
     const definition = createChangesLoadTool(asShell($));
@@ -345,9 +324,6 @@ const opencodeToolCreators = {
       execute: (args, context) => definition.execute(args, context),
     });
   },
-  reload(_: PluginInput["$"], client: PluginInput["client"], __: MergedKompassConfig) {
-    return createReloadTool(client);
-  },
 } as const;
 
 export async function createOpenCodeTools(
diff --git a/packages/opencode/kompass.jsonc b/packages/opencode/kompass.jsonc
index 21a63e0..48c53fd 100644
--- a/packages/opencode/kompass.jsonc
+++ b/packages/opencode/kompass.jsonc
@@ -44,7 +44,6 @@
     "pr_sync": { "enabled": true },
     "ticket_load": { "enabled": true },
     "ticket_sync": { "enabled": true },
-    "reload": { "enabled": true },
   },
 
   "components": {
diff --git a/packages/opencode/test/tool-registration.test.ts b/packages/opencode/test/tool-registration.test.ts
index 339791d..9220fa2 100644
--- a/packages/opencode/test/tool-registration.test.ts
+++ b/packages/opencode/test/tool-registration.test.ts
@@ -67,13 +67,11 @@ describe("createOpenCodeTools", () => {
       assert.ok(tools.kompass_changes_load);
       assert.ok(tools.kompass_pr_load);
       assert.ok(tools.kompass_pr_sync);
-      assert.ok(tools.kompass_reload);
       assert.ok(tools.kompass_ticket_load);
       assert.ok(tools.kompass_ticket_sync);
       assert.equal(tools.changes_load, undefined);
       assert.equal(tools.pr_load, undefined);
       assert.equal(tools.pr_sync, undefined);
-      assert.equal(tools.reload, undefined);
       assert.equal(tools.ticket_load, undefined);
       assert.equal(tools.ticket_sync, undefined);
     });
@@ -106,9 +104,8 @@ describe("createOpenCodeTools", () => {
         }) as never, createMockClient() as never, tempDir);
 
         assert.ok(tools.custom_ticket_name);
-        assert.ok(tools.kompass_reload);
         assert.equal(tools.kompass_ticket_sync, undefined);
-        assert.deepEqual(Object.keys(tools).sort(), ["custom_ticket_name", "kompass_reload"]);
+        assert.deepEqual(Object.keys(tools).sort(), ["custom_ticket_name"]);
       } finally {
         await rm(tempDir, { recursive: true, force: true });
       }
diff --git a/packages/web/src/content/docs/docs/reference/tools/index.mdx b/packages/web/src/content/docs/docs/reference/tools/index.mdx
index 80bbb91..3276272 100644
--- a/packages/web/src/content/docs/docs/reference/tools/index.mdx
+++ b/packages/web/src/content/docs/docs/reference/tools/index.mdx
@@ -12,7 +12,6 @@ Current built-in tools:
 - `pr_sync`
 - `ticket_load`
 - `ticket_sync`
-- `reload`
 
 ## Built-in tools
 
@@ -50,10 +49,3 @@ Creates or updates a GitHub issue with checklist support.
 
 - notable inputs: `title`, `body`, `description`, `labels`, `assignees`, `checklists`, `refUrl`, `comments`
 - used by: `/ticket/create`, `/ticket/ask`, `/ticket/plan-and-sync`, and `/pr/create` when ticket auto-creation is needed
-
-### `reload`
-
-Refreshes the active OpenCode project cache.
-
-- inputs: none
-- used by: internal refresh (no longer has a user-facing command)
diff --git a/packages/web/src/content/docs/docs/reference/tools/reload.mdx b/packages/web/src/content/docs/docs/reference/tools/reload.mdx
deleted file mode 100644
index 97c65fc..0000000
--- a/packages/web/src/content/docs/docs/reference/tools/reload.mdx
+++ /dev/null
@@ -1,18 +0,0 @@
----
-title: reload
-description: Refresh the active OpenCode project cache.
----
-
-## Purpose
-
-Reload config, commands, agents, and tools without restarting OpenCode.
-
-## Inputs
-
-None.
-
-## Useful for
-
-- config changes
-- command template changes
-- tool remapping changes