@hanzlaa/rcode 3.2.1 → 3.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (278) hide show
  1. package/CONTRIBUTING.md +9 -9
  2. package/README.md +50 -50
  3. package/cli/context.js +4 -4
  4. package/cli/doctor.js +1 -1
  5. package/cli/generate-command-skills.cjs +203 -0
  6. package/cli/install.js +29 -12
  7. package/cli/lib/memory-bank.cjs +5 -5
  8. package/cli/set-mode.js +2 -2
  9. package/cli/uninstall.js +5 -5
  10. package/dist/rcode.js +27 -16
  11. package/package.json +1 -1
  12. package/rihal/DOCS-AUDIT.md +1 -1
  13. package/rihal/agents/rihal-ahmed.md +1 -1
  14. package/rihal/agents/rihal-codebase-mapper.md +3 -3
  15. package/rihal/agents/rihal-debugger.md +2 -2
  16. package/rihal/agents/rihal-fatima.md +2 -2
  17. package/rihal/agents/rihal-haitham.md +2 -2
  18. package/rihal/agents/rihal-khalid.md +1 -1
  19. package/rihal/agents/rihal-layla.md +1 -1
  20. package/rihal/agents/rihal-nasser.md +1 -1
  21. package/rihal/agents/rihal-noor.md +1 -1
  22. package/rihal/agents/rihal-nyquist-auditor.md +1 -1
  23. package/rihal/agents/rihal-omar.md +1 -1
  24. package/rihal/agents/rihal-phase-researcher.md +3 -3
  25. package/rihal/agents/rihal-planner.md +1 -1
  26. package/rihal/agents/rihal-project-researcher.md +2 -2
  27. package/rihal/agents/rihal-research-synthesizer.md +3 -3
  28. package/rihal/agents/rihal-roadmapper.md +3 -3
  29. package/rihal/agents/rihal-sadiq.md +1 -1
  30. package/rihal/agents/rihal-sprint-checker.md +3 -3
  31. package/rihal/agents/rihal-verifier.md +2 -2
  32. package/rihal/agents/rihal-waleed.md +1 -1
  33. package/rihal/agents/rihal-yousef.md +2 -2
  34. package/rihal/agents/rihal-zahra.md +1 -1
  35. package/rihal/agents/rihal-zayd.md +1 -1
  36. package/rihal/agents/rules/phase-researcher/detailed-guide.md +1 -1
  37. package/rihal/agents/rules/roadmapper/detailed-guide.md +1 -1
  38. package/rihal/agents/rules/sprint-checker/dimensions.md +3 -3
  39. package/rihal/agents/rules/sprint-checker/process.md +2 -2
  40. package/rihal/agents/rules/verifier/gap-output.md +1 -1
  41. package/rihal/agents/rules/verifier/verification-report.md +1 -1
  42. package/rihal/bin/rihal-hooks.cjs +6 -6
  43. package/rihal/bin/rihal-tools.cjs +60 -23
  44. package/rihal/brain/README.md +2 -2
  45. package/rihal/brain/best-practices/no-autonomous-bypass.md +2 -2
  46. package/rihal/brain/best-practices/research-citation-rule.md +1 -1
  47. package/rihal/brain/best-practices/state-sync-rule.md +4 -4
  48. package/rihal/commands/add-phase.md +1 -1
  49. package/rihal/commands/add-tests.md +1 -1
  50. package/rihal/commands/add-todo.md +1 -1
  51. package/rihal/commands/analyze-dependencies.md +1 -1
  52. package/rihal/commands/audit-fix.md +1 -1
  53. package/rihal/commands/audit-milestone.md +1 -1
  54. package/rihal/commands/audit-uat.md +1 -1
  55. package/rihal/commands/audit.md +1 -1
  56. package/rihal/commands/autonomous.md +1 -1
  57. package/rihal/commands/brainstorm.md +1 -1
  58. package/rihal/commands/chain.md +1 -1
  59. package/rihal/commands/check-todos.md +1 -1
  60. package/rihal/commands/checkpoint-preview.md +1 -1
  61. package/rihal/commands/cleanup.md +2 -2
  62. package/rihal/commands/code-review-fix.md +1 -1
  63. package/rihal/commands/code-review.md +1 -1
  64. package/rihal/commands/complete-milestone.md +1 -1
  65. package/rihal/commands/config.md +2 -2
  66. package/rihal/commands/correct-course.md +1 -1
  67. package/rihal/commands/council.md +1 -1
  68. package/rihal/commands/create-epics-and-stories.md +1 -1
  69. package/rihal/commands/create-story.md +2 -2
  70. package/rihal/commands/dashboard.md +1 -1
  71. package/rihal/commands/debug.md +1 -1
  72. package/rihal/commands/decisions.md +1 -1
  73. package/rihal/commands/dev-story.md +1 -1
  74. package/rihal/commands/diff.md +1 -1
  75. package/rihal/commands/discuss-phase.md +1 -1
  76. package/rihal/commands/discuss.md +2 -2
  77. package/rihal/commands/do.md +2 -2
  78. package/rihal/commands/docs-update.md +1 -1
  79. package/rihal/commands/document-project.md +1 -1
  80. package/rihal/commands/enable-hooks.md +1 -1
  81. package/rihal/commands/execute-sprint.md +2 -2
  82. package/rihal/commands/execute.md +1 -1
  83. package/rihal/commands/explore.md +1 -1
  84. package/rihal/commands/export-to-github.md +1 -1
  85. package/rihal/commands/forensics.md +1 -1
  86. package/rihal/commands/from-template.md +1 -1
  87. package/rihal/commands/health.md +1 -1
  88. package/rihal/commands/help.md +1 -1
  89. package/rihal/commands/import.md +1 -1
  90. package/rihal/commands/inbox.md +1 -1
  91. package/rihal/commands/init.md +1 -1
  92. package/rihal/commands/insert-phase.md +1 -1
  93. package/rihal/commands/install.md +1 -1
  94. package/rihal/commands/list-plans.md +1 -1
  95. package/rihal/commands/list-workspaces.md +1 -1
  96. package/rihal/commands/map-codebase.md +1 -1
  97. package/rihal/commands/milestone-summary.md +1 -1
  98. package/rihal/commands/new-milestone.md +1 -1
  99. package/rihal/commands/new-project.md +1 -1
  100. package/rihal/commands/new-workspace.md +1 -1
  101. package/rihal/commands/next.md +1 -1
  102. package/rihal/commands/note.md +1 -1
  103. package/rihal/commands/notify-test.md +1 -1
  104. package/rihal/commands/pause-work.md +1 -1
  105. package/rihal/commands/plan-milestone-gaps.md +3 -3
  106. package/rihal/commands/plan.md +2 -2
  107. package/rihal/commands/plant-seed.md +1 -1
  108. package/rihal/commands/pr-branch.md +2 -2
  109. package/rihal/commands/prfaq.md +1 -1
  110. package/rihal/commands/profile-user.md +1 -1
  111. package/rihal/commands/progress.md +3 -3
  112. package/rihal/commands/quick.md +1 -1
  113. package/rihal/commands/remove-phase.md +1 -1
  114. package/rihal/commands/remove-workspace.md +1 -1
  115. package/rihal/commands/replay.md +1 -1
  116. package/rihal/commands/rerun.md +1 -1
  117. package/rihal/commands/research-phase.md +2 -2
  118. package/rihal/commands/resume-work.md +1 -1
  119. package/rihal/commands/review.md +1 -1
  120. package/rihal/commands/scan.md +1 -1
  121. package/rihal/commands/secure-phase.md +1 -1
  122. package/rihal/commands/session-report.md +1 -1
  123. package/rihal/commands/settings.md +1 -1
  124. package/rihal/commands/ship.md +2 -2
  125. package/rihal/commands/show.md +1 -1
  126. package/rihal/commands/sprint-planning.md +1 -1
  127. package/rihal/commands/sprint-status.md +1 -1
  128. package/rihal/commands/stats.md +1 -1
  129. package/rihal/commands/status.md +1 -1
  130. package/rihal/commands/ui-phase.md +1 -1
  131. package/rihal/commands/ui-review.md +1 -1
  132. package/rihal/commands/undo.md +1 -1
  133. package/rihal/commands/update.md +1 -1
  134. package/rihal/commands/validate-phase.md +1 -1
  135. package/rihal/commands/verify-phase.md +2 -2
  136. package/rihal/commands/verify-work.md +1 -1
  137. package/rihal/commands/why.md +1 -1
  138. package/rihal/commands/workstream.md +1 -1
  139. package/rihal/references/agent-shared-rules.md +1 -1
  140. package/rihal/references/command-redirect-format.md +7 -7
  141. package/rihal/references/context-budget.md +2 -2
  142. package/rihal/references/continuation-format.md +16 -16
  143. package/rihal/references/dispatch-banner.md +1 -1
  144. package/rihal/references/execution-protocol.md +2 -2
  145. package/rihal/references/gates.md +3 -3
  146. package/rihal/references/git-integration.md +1 -1
  147. package/rihal/references/output-format.md +4 -4
  148. package/rihal/references/output-realism.md +1 -1
  149. package/rihal/references/revision-loop.md +1 -1
  150. package/rihal/references/state-schema.md +15 -15
  151. package/rihal/references/ui-brand.md +1 -1
  152. package/rihal/references/verb-dictionary.md +15 -15
  153. package/rihal/references/workstream-flag.md +28 -28
  154. package/rihal/skills/_shared/no-autonomous-bypass.md +2 -2
  155. package/rihal/skills/_shared/research-citation-rule.md +1 -1
  156. package/rihal/skills/_shared/state-sync-rule.md +4 -4
  157. package/rihal/skills/actions/1-analysis/rihal-prfaq/SKILL.md +1 -1
  158. package/rihal/skills/actions/2-plan/rihal-create-epics-and-stories/workflow.md +1 -1
  159. package/rihal/skills/actions/2-plan/rihal-create-milestone/SKILL.md +2 -2
  160. package/rihal/skills/actions/2-plan/rihal-create-milestone/steps/step-06-phase-stubs.md +2 -2
  161. package/rihal/skills/actions/2-plan/rihal-create-milestone/steps/step-07-backlog.md +2 -2
  162. package/rihal/skills/actions/2-plan/rihal-create-milestone/steps/step-09-state-sync.md +2 -2
  163. package/rihal/skills/actions/2-plan/rihal-create-milestone/steps/step-10-complete.md +4 -4
  164. package/rihal/skills/actions/2-plan/rihal-create-milestone/workflow.md +5 -5
  165. package/rihal/skills/actions/2-plan/rihal-create-prd/SKILL.md +1 -1
  166. package/rihal/skills/actions/2-plan/rihal-create-prd/workflow.md +1 -1
  167. package/rihal/skills/actions/2-plan/rihal-create-story/workflow.md +1 -1
  168. package/rihal/skills/actions/4-implementation/rihal-checkpoint-preview/SKILL.md +3 -3
  169. package/rihal/skills/actions/4-implementation/rihal-dev-story/workflow.md +1 -1
  170. package/rihal/skills/actions/4-implementation/rihal-sprint-planning/SKILL.md +1 -1
  171. package/rihal/skills/actions/4-implementation/rihal-sprint-planning/checklist.md +1 -1
  172. package/rihal/skills/actions/4-implementation/rihal-sprint-planning/workflow.md +1 -1
  173. package/rihal/skills/actions/4-implementation/rihal-sprint-status/workflow.md +5 -5
  174. package/rihal/skills/agents/dalil-scout/SKILL.md +7 -7
  175. package/rihal/skills/core/rihal-brainstorming/SKILL.md +1 -1
  176. package/rihal/skills/core/rihal-init/SKILL.md +1 -1
  177. package/rihal/skills/core/rihal-party-mode/SKILL.md +1 -1
  178. package/rihal/templates/milestone.md +1 -1
  179. package/rihal/templates/projects/api-backend/PROJECT.md +1 -1
  180. package/rihal/templates/projects/mobile-app/PROJECT.md +1 -1
  181. package/rihal/templates/projects/saas-b2b/PROJECT.md +1 -1
  182. package/rihal/workflows/add-phase.md +10 -10
  183. package/rihal/workflows/add-tests.md +9 -9
  184. package/rihal/workflows/add-todo.md +5 -5
  185. package/rihal/workflows/analyze-dependencies.md +7 -7
  186. package/rihal/workflows/audit-fix.md +4 -4
  187. package/rihal/workflows/audit-milestone.md +8 -8
  188. package/rihal/workflows/audit-uat.md +2 -2
  189. package/rihal/workflows/audit.md +28 -28
  190. package/rihal/workflows/autonomous.md +128 -44
  191. package/rihal/workflows/brainstorm.md +7 -7
  192. package/rihal/workflows/chain.md +16 -16
  193. package/rihal/workflows/check-implementation-readiness.md +4 -4
  194. package/rihal/workflows/check-todos.md +8 -8
  195. package/rihal/workflows/checkpoint-preview.md +1 -1
  196. package/rihal/workflows/code-review-fix.md +10 -10
  197. package/rihal/workflows/code-review.md +10 -10
  198. package/rihal/workflows/complete-milestone.md +5 -5
  199. package/rihal/workflows/correct-course.md +7 -7
  200. package/rihal/workflows/council.md +15 -15
  201. package/rihal/workflows/create-epics-and-stories.md +9 -9
  202. package/rihal/workflows/create-story.md +11 -11
  203. package/rihal/workflows/dashboard.md +8 -8
  204. package/rihal/workflows/debug.md +6 -6
  205. package/rihal/workflows/decisions.md +5 -5
  206. package/rihal/workflows/dev-story.md +12 -12
  207. package/rihal/workflows/diagnose-issues.md +2 -2
  208. package/rihal/workflows/diff.md +3 -3
  209. package/rihal/workflows/discuss-phase-power.md +7 -7
  210. package/rihal/workflows/discuss-phase.md +14 -14
  211. package/rihal/workflows/discuss.md +9 -9
  212. package/rihal/workflows/do.md +79 -79
  213. package/rihal/workflows/docs-update.md +6 -6
  214. package/rihal/workflows/document-project.md +5 -5
  215. package/rihal/workflows/enable-hooks.md +5 -5
  216. package/rihal/workflows/execute-sprint.md +3 -3
  217. package/rihal/workflows/execute.md +28 -28
  218. package/rihal/workflows/explore.md +5 -5
  219. package/rihal/workflows/export-to-github.md +5 -5
  220. package/rihal/workflows/forensics.md +8 -8
  221. package/rihal/workflows/from-template.md +8 -8
  222. package/rihal/workflows/health.md +11 -11
  223. package/rihal/workflows/help.md +117 -117
  224. package/rihal/workflows/import.md +4 -4
  225. package/rihal/workflows/inbox.md +8 -8
  226. package/rihal/workflows/init.md +23 -23
  227. package/rihal/workflows/insert-phase.md +9 -9
  228. package/rihal/workflows/install.md +3 -3
  229. package/rihal/workflows/karpathy-audit.md +11 -11
  230. package/rihal/workflows/list-plans.md +8 -8
  231. package/rihal/workflows/list-workspaces.md +7 -7
  232. package/rihal/workflows/map-codebase.md +5 -5
  233. package/rihal/workflows/milestone-summary.md +7 -7
  234. package/rihal/workflows/new-milestone.md +11 -11
  235. package/rihal/workflows/new-project-research.md +1 -1
  236. package/rihal/workflows/new-project-roadmap.md +8 -8
  237. package/rihal/workflows/new-project.md +32 -32
  238. package/rihal/workflows/new-workspace.md +7 -7
  239. package/rihal/workflows/next.md +13 -13
  240. package/rihal/workflows/note.md +7 -7
  241. package/rihal/workflows/notify-test.md +6 -6
  242. package/rihal/workflows/pause-work.md +6 -6
  243. package/rihal/workflows/plan-milestone-gaps.md +7 -7
  244. package/rihal/workflows/plan.md +28 -28
  245. package/rihal/workflows/plant-seed.md +3 -3
  246. package/rihal/workflows/pr-branch.md +1 -1
  247. package/rihal/workflows/prfaq.md +1 -1
  248. package/rihal/workflows/profile-user.md +5 -5
  249. package/rihal/workflows/progress.md +6 -6
  250. package/rihal/workflows/quick.md +12 -12
  251. package/rihal/workflows/remove-phase.md +6 -6
  252. package/rihal/workflows/remove-workspace.md +8 -8
  253. package/rihal/workflows/replay.md +8 -8
  254. package/rihal/workflows/rerun.md +5 -5
  255. package/rihal/workflows/research-phase.md +2 -2
  256. package/rihal/workflows/resume-work.md +10 -10
  257. package/rihal/workflows/review-adversarial.md +4 -4
  258. package/rihal/workflows/review-edge-case-hunter.md +5 -5
  259. package/rihal/workflows/review.md +11 -11
  260. package/rihal/workflows/scan.md +9 -9
  261. package/rihal/workflows/secure-phase.md +8 -8
  262. package/rihal/workflows/session-report.md +6 -6
  263. package/rihal/workflows/settings.md +15 -15
  264. package/rihal/workflows/ship.md +11 -11
  265. package/rihal/workflows/show.md +2 -2
  266. package/rihal/workflows/sprint-planning.md +13 -13
  267. package/rihal/workflows/sprint-status.md +10 -10
  268. package/rihal/workflows/stats.md +6 -6
  269. package/rihal/workflows/status.md +15 -7
  270. package/rihal/workflows/ui-phase.md +8 -8
  271. package/rihal/workflows/ui-review.md +5 -5
  272. package/rihal/workflows/undo.md +17 -17
  273. package/rihal/workflows/update.md +12 -12
  274. package/rihal/workflows/validate-phase.md +5 -5
  275. package/rihal/workflows/verify-work.md +18 -18
  276. package/rihal/workflows/why.md +9 -9
  277. package/rihal/workflows/workstream.md +11 -11
  278. package/server/lib/html/client.js +45 -45
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: rihal:validate-phase
2
+ name: rihal-validate-phase
3
3
  description: Audit Nyquist validation gaps for a completed phase. Generate missing tests. Update VALIDATION.md.
4
4
  argument-hint: "<phase-number>"
5
5
  allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent
@@ -1,6 +1,6 @@
1
1
  ---
2
- name: rihal:verify-phase
3
- description: "Goal-backward audit — does the codebase actually deliver what the phase promised? Produces VERIFICATION.md with pass/fail. Required before /rihal:ship. Run after /rihal:execute completes."
2
+ name: rihal-verify-phase
3
+ description: "Goal-backward audit — does the codebase actually deliver what the phase promised? Produces VERIFICATION.md with pass/fail. Required before /rihal-ship. Run after /rihal-execute completes."
4
4
  argument-hint: "<phase-number>"
5
5
  allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent
6
6
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: rihal:verify-work
2
+ name: rihal-verify-work
3
3
  description: Conversational acceptance testing — verify sprint stories against acceptance criteria
4
4
  argument-hint: "[--phase <NN>]"
5
5
  allowed-tools: Read, Bash, Grep, Glob, AskUserQuestion
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: rihal:why
2
+ name: rihal-why
3
3
  description: Explain the reasoning behind a decision, classification, or panel selection
4
4
  argument-hint: <topic-or-question>
5
5
  allowed-tools:
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: rihal:workstream
2
+ name: rihal-workstream
3
3
  description: Manage parallel workstreams (milestone tracks). Create, switch, list, or complete workstreams in state.json.
4
4
  argument-hint: "<subcommand> [--name <name>]"
5
5
  allowed-tools:
@@ -54,7 +54,7 @@
54
54
 
55
55
  **Honest scope declaration.** When investigating, declare what you searched, what you skipped, and what you couldn't see. Empty blind-spot lists are usually a tell that the agent didn't honestly account for what it skipped.
56
56
 
57
- **Refuse out-of-lane work explicitly.** State which peer agent owns it and how to hand off. *"That's an architecture call — Waleed's lane. `/rihal:discuss waleed`."* Never silently take work that belongs to a peer.
57
+ **Refuse out-of-lane work explicitly.** State which peer agent owns it and how to hand off. *"That's an architecture call — Waleed's lane. `/rihal-discuss waleed`."* Never silently take work that belongs to a peer.
58
58
 
59
59
  ---
60
60
 
@@ -4,14 +4,14 @@ Shared reference for all agents and workflows when they suggest the user run a d
4
4
 
5
5
  ## The rule
6
6
 
7
- **When suggesting a `/rihal:*` command, print it on a single line for copy-paste.**
7
+ **When suggesting a `/rihal-*` command, print it on a single line for copy-paste.**
8
8
 
9
9
  The user's terminal-style interface benefits from one-line commands they can select and paste without touching line-wrap issues. Never split a suggested command across multiple lines, never bullet it, never break arguments onto separate rows.
10
10
 
11
11
  ## Good format
12
12
 
13
13
  ```
14
- Run: /rihal:council I'm in Pakistan, USD 1000 budget, want to dropship Gaming + Creator accessories to UAE. Should I build a Next.js custom app or use Shopify?
14
+ Run: /rihal-council I'm in Pakistan, USD 1000 budget, want to dropship Gaming + Creator accessories to UAE. Should I build a Next.js custom app or use Shopify?
15
15
  ```
16
16
 
17
17
  One line. User selects the whole line, pastes, presses enter.
@@ -19,7 +19,7 @@ One line. User selects the whole line, pastes, presses enter.
19
19
  ## Bad format — do NOT do this
20
20
 
21
21
  ```
22
- Run /rihal:council with the new question:
22
+ Run /rihal-council with the new question:
23
23
  "I'm in Pakistan, USD 1000 budget, want to dropship Gaming + Creator accessories to UAE. Should I build a Next.js custom app or use Shopify?"
24
24
  ```
25
25
 
@@ -29,7 +29,7 @@ Two lines, with quotes, with a lead-in sentence. The user has to reconstruct the
29
29
 
30
30
  Agents and workflows redirect when:
31
31
  - An agent receives a question outside its domain (Sadiq gets a technical question → Waleed)
32
- - A workflow gets an input type it doesn't handle (`/rihal:plan` gets a decision question → `/rihal:council`)
32
+ - A workflow gets an input type it doesn't handle (`/rihal-plan` gets a decision question → `/rihal-council`)
33
33
  - The user's intent would be better served by a different command
34
34
 
35
35
  ## Template
@@ -39,7 +39,7 @@ Agents and workflows redirect when:
39
39
 
40
40
  Copy-paste this instead:
41
41
 
42
- /rihal:<command> <exact arguments from user's original input>
42
+ /rihal-<command> <exact arguments from user's original input>
43
43
  ```
44
44
 
45
45
  The third line — the full command — is a single physical line, regardless of length. No wrapping. No quotes around the arguments unless the command itself requires them.
@@ -55,8 +55,8 @@ If multiple commands could fit, list each on its own line as a complete single-l
55
55
  ```
56
56
  Could be either — pick one:
57
57
 
58
- /rihal:discuss waleed <your question>
59
- /rihal:council <your question>
58
+ /rihal-discuss waleed <your question>
59
+ /rihal-council <your question>
60
60
  ```
61
61
 
62
62
  Not with lead-in prose for each option.
@@ -59,7 +59,7 @@ Estimation rule: **1 token ≈ 4 characters**. Use this to predict token cost of
59
59
  - 🚨 **Emergency mode**
60
60
  - 🛑 Read ONLY what's strictly required to unblock next action
61
61
  - 🛑 No exploratory reads, no documentation
62
- - 🛑 Suggest `/rihal:pause-work` if task requires more context
62
+ - 🛑 Suggest `/rihal-pause-work` if task requires more context
63
63
  - 🛑 Warn user: **"Context critical ({percent}%). Resume work to continue."**
64
64
 
65
65
  **Behavior:** Survival — preserve tokens for final output only.
@@ -76,7 +76,7 @@ def check_budget(current_tokens, config):
76
76
  used_pct = (current_tokens / budget) * 100
77
77
 
78
78
  if used_pct >= 80:
79
- return 'POOR', "Context critical. Suggest /rihal:pause-work"
79
+ return 'POOR', "Context critical. Suggest /rihal-pause-work"
80
80
  elif used_pct >= 60:
81
81
  return 'DEGRADING', "Context at {used_pct}%. Read frontmatter only."
82
82
  elif used_pct >= 30:
@@ -44,7 +44,7 @@ Standard format for presenting next steps after completing a command or workflow
44
44
 
45
45
  **02-03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry
46
46
 
47
- `/rihal:execute-phase 2`
47
+ `/rihal-execute-phase 2`
48
48
 
49
49
  <sub>`/clear` first → fresh context window</sub>
50
50
 
@@ -52,7 +52,7 @@ Standard format for presenting next steps after completing a command or workflow
52
52
 
53
53
  **Also available:**
54
54
  - Review plan before executing
55
- - `/rihal:list-phase-assumptions 2` — check assumptions
55
+ - `/rihal-list-phase-assumptions 2` — check assumptions
56
56
 
57
57
  ---
58
58
  ```
@@ -69,7 +69,7 @@ Add note that this is the last plan and what comes after:
69
69
  **02-03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry
70
70
  <sub>Final plan in Phase 2</sub>
71
71
 
72
- `/rihal:execute-phase 2`
72
+ `/rihal-execute-phase 2`
73
73
 
74
74
  <sub>`/clear` first → fresh context window</sub>
75
75
 
@@ -91,15 +91,15 @@ Add note that this is the last plan and what comes after:
91
91
 
92
92
  **Phase 2: Authentication** — JWT login flow with refresh tokens
93
93
 
94
- `/rihal:plan-phase 2`
94
+ `/rihal-plan-phase 2`
95
95
 
96
96
  <sub>`/clear` first → fresh context window</sub>
97
97
 
98
98
  ---
99
99
 
100
100
  **Also available:**
101
- - `/rihal:discuss-phase 2` — gather context first
102
- - `/rihal:research-phase 2` — investigate unknowns
101
+ - `/rihal-discuss-phase 2` — gather context first
102
+ - `/rihal-research-phase 2` — investigate unknowns
103
103
  - Review roadmap
104
104
 
105
105
  ---
@@ -120,15 +120,15 @@ Show completion status before next action:
120
120
 
121
121
  **Phase 3: Core Features** — User dashboard, settings, and data export
122
122
 
123
- `/rihal:plan-phase 3`
123
+ `/rihal-plan-phase 3`
124
124
 
125
125
  <sub>`/clear` first → fresh context window</sub>
126
126
 
127
127
  ---
128
128
 
129
129
  **Also available:**
130
- - `/rihal:discuss-phase 3` — gather context first
131
- - `/rihal:research-phase 3` — investigate unknowns
130
+ - `/rihal-discuss-phase 3` — gather context first
131
+ - `/rihal-research-phase 3` — investigate unknowns
132
132
  - Review what Phase 2 built
133
133
 
134
134
  ---
@@ -145,11 +145,11 @@ When there's no clear primary action:
145
145
 
146
146
  **Phase 3: Core Features** — User dashboard, settings, and data export
147
147
 
148
- **To plan directly:** `/rihal:plan-phase 3`
148
+ **To plan directly:** `/rihal-plan-phase 3`
149
149
 
150
- **To discuss context first:** `/rihal:discuss-phase 3`
150
+ **To discuss context first:** `/rihal-discuss-phase 3`
151
151
 
152
- **To research unknowns:** `/rihal:research-phase 3`
152
+ **To research unknowns:** `/rihal-research-phase 3`
153
153
 
154
154
  <sub>`/clear` first → fresh context window</sub>
155
155
 
@@ -169,7 +169,7 @@ All 4 phases shipped
169
169
 
170
170
  **Start v1.1** — questioning → research → requirements → roadmap
171
171
 
172
- `/rihal:new-milestone`
172
+ `/rihal-new-milestone`
173
173
 
174
174
  <sub>`/clear` first → fresh context window</sub>
175
175
 
@@ -214,7 +214,7 @@ Extract: `**02-03: Refresh Token Rotation** — Add /api/auth/refresh with slidi
214
214
  ## To Continue
215
215
 
216
216
  Run `/clear`, then paste:
217
- /rihal:execute-phase 2
217
+ /rihal-execute-phase 2
218
218
  ```
219
219
 
220
220
  User has no idea what 02-03 is about.
@@ -222,7 +222,7 @@ User has no idea what 02-03 is about.
222
222
  ### Don't: Missing /clear explanation
223
223
 
224
224
  ```
225
- `/rihal:plan-phase 3`
225
+ `/rihal-plan-phase 3`
226
226
 
227
227
  Run /clear first.
228
228
  ```
@@ -242,7 +242,7 @@ Sounds like an afterthought. Use "Also available:" instead.
242
242
 
243
243
  ```
244
244
  ```
245
- /rihal:plan-phase 3
245
+ /rihal-plan-phase 3
246
246
  ```
247
247
  ```
248
248
 
@@ -130,7 +130,7 @@ Then print a fresh DISPATCH banner.
130
130
 
131
131
  ## Concurrency: parallel dispatches
132
132
 
133
- If a workflow spawns multiple agents in parallel (e.g. `/rihal:council` summons 4 specialists), print ONE combined banner:
133
+ If a workflow spawns multiple agents in parallel (e.g. `/rihal-council` summons 4 specialists), print ONE combined banner:
134
134
 
135
135
  ```
136
136
  ╭─────────────────────────────────────────────────────────╮
@@ -79,14 +79,14 @@ Type: {human-verify | decision}
79
79
  {For human-verify:}
80
80
  Please verify: {what to check}
81
81
  URL/path: {where to look}
82
- Resume with: /rihal:execute {plan} --continue
82
+ Resume with: /rihal-execute {plan} --continue
83
83
 
84
84
  {For decision:}
85
85
  Problem: {what the plan assumed that isn't true}
86
86
  Option A: {approach} — {trade-off}
87
87
  Option B: {approach} — {trade-off}
88
88
  Recommendation: {which one and why}
89
- Resume with: /rihal:execute {plan} --continue --option=A
89
+ Resume with: /rihal-execute {plan} --continue --option=A
90
90
  ---
91
91
  ```
92
92
 
@@ -18,7 +18,7 @@ Defines 4 gate types used in rihal workflows to control execution flow, validate
18
18
  **Example:** Phase execution gate
19
19
  ```
20
20
  Gate: Check phase.md exists and has required sections
21
- Block: "Phase {N} has no SPRINT.md. Create with /rihal:help"
21
+ Block: "Phase {N} has no SPRINT.md. Create with /rihal-help"
22
22
  Warn: "Phase overdue by {days}. Review roadmap?"
23
23
  ```
24
24
 
@@ -77,14 +77,14 @@ Ask: "Pattern A is faster but less flexible. Pattern B is extensible but slower.
77
77
  - Exit cleanly without recovery attempt
78
78
  - Suggest manual recovery path
79
79
 
80
- **Recovery:** Manual repair via `/rihal:health` or `/rihal:forensics`
80
+ **Recovery:** Manual repair via `/rihal-health` or `/rihal-forensics`
81
81
 
82
82
  **Example:** Corrupted state gate
83
83
  ```
84
84
  Gate: Validate state.json integrity
85
85
  Fail: "state.json corrupted (invalid JSON at line 42).
86
86
  Aborting to prevent further damage.
87
- Recovery: /rihal:health --repair"
87
+ Recovery: /rihal-health --repair"
88
88
  ```
89
89
 
90
90
  ---
@@ -132,7 +132,7 @@ git commit -m "feat(...): description"
132
132
  ### Worktree-Isolation Strategy
133
133
  ```bash
134
134
  # Workflow commands
135
- /rihal:do --worktree phase/2-auth
135
+ /rihal-do --worktree phase/2-auth
136
136
  # Internally:
137
137
  git worktree add .claude/worktrees/phase-2-auth phase/2-auth
138
138
  cd .claude/worktrees/phase-2-auth
@@ -29,7 +29,7 @@ Use for major workflow transitions.
29
29
 
30
30
  ---
31
31
 
32
- ## Routing Output (for /rihal:do, /rihal:next, /rihal:progress)
32
+ ## Routing Output (for /rihal-do, /rihal-next, /rihal-progress)
33
33
 
34
34
  Use this when a router command dispatches to another command:
35
35
 
@@ -42,7 +42,7 @@ Input: {user's question or intent}
42
42
  Scope: {one-line summary of detected scope}
43
43
  {optional: Blocker: {any blockers detected}}
44
44
 
45
- Routing to: /rihal:{target-command}
45
+ Routing to: /rihal-{target-command}
46
46
  Reason: {one-line why this command fits}
47
47
 
48
48
  Handing off to the workflow now.
@@ -253,8 +253,8 @@ Always at end of major completions.
253
253
  ───────────────────────────────────────────────────────────────
254
254
 
255
255
  **Also available:**
256
- - `/rihal:alternative-1` — description
257
- - `/rihal:alternative-2` — description
256
+ - `/rihal-alternative-1` — description
257
+ - `/rihal-alternative-2` — description
258
258
 
259
259
  ───────────────────────────────────────────────────────────────
260
260
  ```
@@ -43,7 +43,7 @@ Keep the whole response under ~300 words. Tone: colleague-honest, not apologetic
43
43
  - **rihal-planner:** If `## Scope` from orchestrator implies > 8 tasks of real work, return a PLANS.md with *multiple* SPRINT.md files (waves) instead of one overloaded plan.
44
44
  - **rihal-executor:** If a SPRINT.md would require > 1500 lines of new/changed code to execute, stop at Step 2 (load plan) and return a "plan too large — suggest wave split" checkpoint instead of executing.
45
45
  - **rihal-roadmapper:** Phase size cap: one phase = one coherent batch that a solo developer + AI can reasonably ship in 1-3 focused sessions.
46
- - **/rihal:autonomous** and **/rihal:do --auto:** Even in auto mode, pause at the first batch boundary that exceeds output budget. "Don't stop until done" authorizes local commits, not output-budget violations.
46
+ - **/rihal-autonomous** and **/rihal-do --auto:** Even in auto mode, pause at the first batch boundary that exceeds output budget. "Don't stop until done" authorizes local commits, not output-budget violations.
47
47
 
48
48
  ## The Core Philosophy
49
49
 
@@ -1,6 +1,6 @@
1
1
  # Plan Revision Loop
2
2
 
3
- When `workflow.plan_checker` is enabled (`/rihal:settings`), `/rihal:plan`
3
+ When `workflow.plan_checker` is enabled (`/rihal-settings`), `/rihal-plan`
4
4
  runs the rihal-plan-checker after the planner. Findings drive a bounded
5
5
  revision loop:
6
6
 
@@ -34,7 +34,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
34
34
  ### `version`
35
35
  **Type:** string
36
36
  **Example:** `"1"`
37
- **Written by:** `/rihal:install` (initialization)
37
+ **Written by:** `/rihal-install` (initialization)
38
38
  **Purpose:** Schema version for compatibility checks. Change if fields added/removed.
39
39
 
40
40
  ---
@@ -42,7 +42,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
42
42
  ### `project`
43
43
  **Type:** string
44
44
  **Example:** `"Rihal v2"`
45
- **Written by:** `/rihal:install` (reads from config.yaml)
45
+ **Written by:** `/rihal-install` (reads from config.yaml)
46
46
  **Purpose:** Project name for context and reports.
47
47
 
48
48
  ---
@@ -50,7 +50,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
50
50
  ### `created`
51
51
  **Type:** ISO date string
52
52
  **Example:** `"2026-04-01T10:30:00Z"`
53
- **Written by:** `/rihal:install` (first session)
53
+ **Written by:** `/rihal-install` (first session)
54
54
  **Purpose:** Timestamp of project creation, never changes.
55
55
 
56
56
  ---
@@ -66,7 +66,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
66
66
  ### `current_phase`
67
67
  **Type:** string or null
68
68
  **Example:** `"Phase 2: Authentication"` or `null`
69
- **Written by:** `/rihal:do`, `/rihal:next`, `/rihal:resume-work`
69
+ **Written by:** `/rihal-do`, `/rihal-next`, `/rihal-resume-work`
70
70
  **Purpose:** Name of active phase, null if no phase active.
71
71
 
72
72
  ---
@@ -74,7 +74,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
74
74
  ### `current_plan`
75
75
  **Type:** number
76
76
  **Example:** `2`
77
- **Written by:** `/rihal:do --execute` (incremented after each phase completion)
77
+ **Written by:** `/rihal-do --execute` (incremented after each phase completion)
78
78
  **Purpose:** Counter for plan versions. Increments 1→2→3 as phases complete.
79
79
 
80
80
  ---
@@ -120,7 +120,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
120
120
  }
121
121
  ]
122
122
  ```
123
- **Written by:** `/rihal:do --execute`, `/rihal:next`, sprint/story state tools
123
+ **Written by:** `/rihal-do --execute`, `/rihal-next`, sprint/story state tools
124
124
  **Purpose:** Tracks phases with nested sprints and stories.
125
125
 
126
126
  **Sprint fields:**
@@ -176,7 +176,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
176
176
  }
177
177
  ]
178
178
  ```
179
- **Written by:** `/rihal:execute` (after each plan completes)
179
+ **Written by:** `/rihal-execute` (after each plan completes)
180
180
  **Purpose:** Log of each plan execution. The `plan` field is the plan ID string (e.g., "01.02"), not a number.
181
181
 
182
182
  ---
@@ -194,7 +194,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
194
194
  }
195
195
  ]
196
196
  ```
197
- **Written by:** `/rihal:council`, `/rihal:discuss`
197
+ **Written by:** `/rihal-council`, `/rihal-discuss`
198
198
  **Purpose:** Records architectural/strategic decisions for history.
199
199
 
200
200
  ---
@@ -213,7 +213,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
213
213
  }
214
214
  ]
215
215
  ```
216
- **Written by:** `/rihal:do`, `/rihal:health`
216
+ **Written by:** `/rihal-do`, `/rihal-health`
217
217
  **Purpose:** Tracks blockers, when identified, which phase, and resolution time.
218
218
 
219
219
  ---
@@ -231,7 +231,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
231
231
  }
232
232
  ]
233
233
  ```
234
- **Written by:** `/rihal:council`
234
+ **Written by:** `/rihal-council`
235
235
  **Purpose:** History of council deliberations, panelists, output artifacts.
236
236
 
237
237
  ---
@@ -249,7 +249,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
249
249
  }
250
250
  ]
251
251
  ```
252
- **Written by:** `/rihal:chain`
252
+ **Written by:** `/rihal-chain`
253
253
  **Purpose:** History of multi-agent chains, participants, work artifacts.
254
254
 
255
255
  ---
@@ -258,7 +258,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
258
258
  **Type:** ISO date string
259
259
  **Example:** `"2026-04-12T15:45:30Z"`
260
260
  **Written by:** Every subcommand that runs (updates at session end)
261
- **Purpose:** Enables `/rihal:resume-work` to find context from last session.
261
+ **Purpose:** Enables `/rihal-resume-work` to find context from last session.
262
262
 
263
263
  ---
264
264
 
@@ -283,7 +283,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
283
283
  }
284
284
  ]
285
285
  ```
286
- **Written by:** `/rihal:workstream --create`, `/rihal:do --execute`
286
+ **Written by:** `/rihal-workstream --create`, `/rihal-do --execute`
287
287
  **Purpose:** Tracks parallel workstreams, which phases belong to each.
288
288
 
289
289
  ---
@@ -291,7 +291,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
291
291
  ### `active_workstream`
292
292
  **Type:** string or null
293
293
  **Example:** `"Frontend"` or `null`
294
- **Written by:** `/rihal:workstream --activate`, `/rihal:do`
294
+ **Written by:** `/rihal-workstream --activate`, `/rihal-do`
295
295
  **Purpose:** Currently active workstream; null if no workstream focus.
296
296
 
297
297
  ---
@@ -299,7 +299,7 @@ Documents every top-level field in `state.json`, used by rihal workflows for ses
299
299
  ### `model_profile`
300
300
  **Type:** string
301
301
  **Example:** `"balanced"` (options: `quality`, `balanced`, `budget`, `inherit`)
302
- **Written by:** `/rihal:set-profile`
302
+ **Written by:** `/rihal-set-profile`
303
303
  **Purpose:** Model selection for council agents. Affects token spend and quality.
304
304
 
305
305
  ---
@@ -1,6 +1,6 @@
1
1
  # UI/Brand Questions
2
2
 
3
- When exploring the UI design phase (/rihal:ui-phase), ask structured questions across these eight dimensions: **color palette**, **typography**, **voice/tone**, **accessibility**, **component inventory**, **responsive behavior**, **interaction patterns**, and **visual hierarchy**. These questions build the design contract.
3
+ When exploring the UI design phase (/rihal-ui-phase), ask structured questions across these eight dimensions: **color palette**, **typography**, **voice/tone**, **accessibility**, **component inventory**, **responsive behavior**, **interaction patterns**, and **visual hierarchy**. These questions build the design contract.
4
4
 
5
5
  ---
6
6
 
@@ -76,19 +76,19 @@ These are matched alongside §Create / §Add / §Plan verbs to determine the dis
76
76
 
77
77
  | Scope noun | Aliases (English + Urdu) | Maps to (workflow) |
78
78
  |---|---|---|
79
- | milestone | `milestone`, `milestones`, `release`, `version`, `cycle` | `/rihal:new-milestone` |
80
- | phase | `phase`, `phases` (singular intent — "add a phase") | `/rihal:add-phase` |
81
- | story | `story`, `stories`, `user story`, `kahani` | `/rihal:create-story` |
82
- | epic | `epic`, `epics`, `epics and stories` | `/rihal:create-epics-and-stories` |
83
- | sprint | `sprint`, `iteration` | `/rihal:sprint-planning` |
84
- | PRD | `PRD`, `requirements doc`, `product requirements` | `/rihal:create-prd` |
85
- | roadmap | `roadmap`, `plan` (top-level) | `/rihal:create-milestone` |
86
- | council | `council`, `majlis`, `panel`, `mashwara`, `salah` | `/rihal:council` |
87
- | plan (verb form — "plan phase N") | `plan` | `/rihal:plan` |
88
- | story (impl) | `dev story`, `implement story`, `build story` | `/rihal:dev-story` |
89
- | brainstorm | `brainstorm`, `ideas`, `sochain`, `sochna` | `/rihal:brainstorm` |
90
- | review (code) | `code review`, `karpathy`, `check my diff` | `/rihal:code-review [--karpathy]` |
91
- | debug | `debug`, `fix`, `bug`, `error`, `crash`, `kharab`, `theek` | `/rihal:debug` |
79
+ | milestone | `milestone`, `milestones`, `release`, `version`, `cycle` | `/rihal-new-milestone` |
80
+ | phase | `phase`, `phases` (singular intent — "add a phase") | `/rihal-add-phase` |
81
+ | story | `story`, `stories`, `user story`, `kahani` | `/rihal-create-story` |
82
+ | epic | `epic`, `epics`, `epics and stories` | `/rihal-create-epics-and-stories` |
83
+ | sprint | `sprint`, `iteration` | `/rihal-sprint-planning` |
84
+ | PRD | `PRD`, `requirements doc`, `product requirements` | `/rihal-create-prd` |
85
+ | roadmap | `roadmap`, `plan` (top-level) | `/rihal-create-milestone` |
86
+ | council | `council`, `majlis`, `panel`, `mashwara`, `salah` | `/rihal-council` |
87
+ | plan (verb form — "plan phase N") | `plan` | `/rihal-plan` |
88
+ | story (impl) | `dev story`, `implement story`, `build story` | `/rihal-dev-story` |
89
+ | brainstorm | `brainstorm`, `ideas`, `sochain`, `sochna` | `/rihal-brainstorm` |
90
+ | review (code) | `code review`, `karpathy`, `check my diff` | `/rihal-code-review [--karpathy]` |
91
+ | debug | `debug`, `fix`, `bug`, `error`, `crash`, `kharab`, `theek` | `/rihal-debug` |
92
92
 
93
93
  ---
94
94
 
@@ -106,8 +106,8 @@ table above, dispatch directly to the mapped workflow without an
106
106
  ambiguity prompt.
107
107
 
108
108
  Example: "milestone bnao" → §Create matches "bnao", scope matches
109
- "milestone" → /rihal:new-milestone (with state-aware redirect to
110
- /rihal:add-phase if a milestone is already active).
109
+ "milestone" → /rihal-new-milestone (with state-aware redirect to
110
+ /rihal-add-phase if a milestone is already active).
111
111
  ```
112
112
 
113
113
  **From an agent file (e.g. `rihal-codebase-mapper.md`) when interpreting the orchestrator prompt:**