@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.
- package/CONTRIBUTING.md +9 -9
- package/README.md +50 -50
- package/cli/context.js +4 -4
- package/cli/doctor.js +1 -1
- package/cli/generate-command-skills.cjs +203 -0
- package/cli/install.js +29 -12
- package/cli/lib/memory-bank.cjs +5 -5
- package/cli/set-mode.js +2 -2
- package/cli/uninstall.js +5 -5
- package/dist/rcode.js +27 -16
- package/package.json +1 -1
- package/rihal/DOCS-AUDIT.md +1 -1
- package/rihal/agents/rihal-ahmed.md +1 -1
- package/rihal/agents/rihal-codebase-mapper.md +3 -3
- package/rihal/agents/rihal-debugger.md +2 -2
- package/rihal/agents/rihal-fatima.md +2 -2
- package/rihal/agents/rihal-haitham.md +2 -2
- package/rihal/agents/rihal-khalid.md +1 -1
- package/rihal/agents/rihal-layla.md +1 -1
- package/rihal/agents/rihal-nasser.md +1 -1
- package/rihal/agents/rihal-noor.md +1 -1
- package/rihal/agents/rihal-nyquist-auditor.md +1 -1
- package/rihal/agents/rihal-omar.md +1 -1
- package/rihal/agents/rihal-phase-researcher.md +3 -3
- package/rihal/agents/rihal-planner.md +1 -1
- package/rihal/agents/rihal-project-researcher.md +2 -2
- package/rihal/agents/rihal-research-synthesizer.md +3 -3
- package/rihal/agents/rihal-roadmapper.md +3 -3
- package/rihal/agents/rihal-sadiq.md +1 -1
- package/rihal/agents/rihal-sprint-checker.md +3 -3
- package/rihal/agents/rihal-verifier.md +2 -2
- package/rihal/agents/rihal-waleed.md +1 -1
- package/rihal/agents/rihal-yousef.md +2 -2
- package/rihal/agents/rihal-zahra.md +1 -1
- package/rihal/agents/rihal-zayd.md +1 -1
- package/rihal/agents/rules/phase-researcher/detailed-guide.md +1 -1
- package/rihal/agents/rules/roadmapper/detailed-guide.md +1 -1
- package/rihal/agents/rules/sprint-checker/dimensions.md +3 -3
- package/rihal/agents/rules/sprint-checker/process.md +2 -2
- package/rihal/agents/rules/verifier/gap-output.md +1 -1
- package/rihal/agents/rules/verifier/verification-report.md +1 -1
- package/rihal/bin/rihal-hooks.cjs +6 -6
- package/rihal/bin/rihal-tools.cjs +60 -23
- package/rihal/brain/README.md +2 -2
- package/rihal/brain/best-practices/no-autonomous-bypass.md +2 -2
- package/rihal/brain/best-practices/research-citation-rule.md +1 -1
- package/rihal/brain/best-practices/state-sync-rule.md +4 -4
- package/rihal/commands/add-phase.md +1 -1
- package/rihal/commands/add-tests.md +1 -1
- package/rihal/commands/add-todo.md +1 -1
- package/rihal/commands/analyze-dependencies.md +1 -1
- package/rihal/commands/audit-fix.md +1 -1
- package/rihal/commands/audit-milestone.md +1 -1
- package/rihal/commands/audit-uat.md +1 -1
- package/rihal/commands/audit.md +1 -1
- package/rihal/commands/autonomous.md +1 -1
- package/rihal/commands/brainstorm.md +1 -1
- package/rihal/commands/chain.md +1 -1
- package/rihal/commands/check-todos.md +1 -1
- package/rihal/commands/checkpoint-preview.md +1 -1
- package/rihal/commands/cleanup.md +2 -2
- package/rihal/commands/code-review-fix.md +1 -1
- package/rihal/commands/code-review.md +1 -1
- package/rihal/commands/complete-milestone.md +1 -1
- package/rihal/commands/config.md +2 -2
- package/rihal/commands/correct-course.md +1 -1
- package/rihal/commands/council.md +1 -1
- package/rihal/commands/create-epics-and-stories.md +1 -1
- package/rihal/commands/create-story.md +2 -2
- package/rihal/commands/dashboard.md +1 -1
- package/rihal/commands/debug.md +1 -1
- package/rihal/commands/decisions.md +1 -1
- package/rihal/commands/dev-story.md +1 -1
- package/rihal/commands/diff.md +1 -1
- package/rihal/commands/discuss-phase.md +1 -1
- package/rihal/commands/discuss.md +2 -2
- package/rihal/commands/do.md +2 -2
- package/rihal/commands/docs-update.md +1 -1
- package/rihal/commands/document-project.md +1 -1
- package/rihal/commands/enable-hooks.md +1 -1
- package/rihal/commands/execute-sprint.md +2 -2
- package/rihal/commands/execute.md +1 -1
- package/rihal/commands/explore.md +1 -1
- package/rihal/commands/export-to-github.md +1 -1
- package/rihal/commands/forensics.md +1 -1
- package/rihal/commands/from-template.md +1 -1
- package/rihal/commands/health.md +1 -1
- package/rihal/commands/help.md +1 -1
- package/rihal/commands/import.md +1 -1
- package/rihal/commands/inbox.md +1 -1
- package/rihal/commands/init.md +1 -1
- package/rihal/commands/insert-phase.md +1 -1
- package/rihal/commands/install.md +1 -1
- package/rihal/commands/list-plans.md +1 -1
- package/rihal/commands/list-workspaces.md +1 -1
- package/rihal/commands/map-codebase.md +1 -1
- package/rihal/commands/milestone-summary.md +1 -1
- package/rihal/commands/new-milestone.md +1 -1
- package/rihal/commands/new-project.md +1 -1
- package/rihal/commands/new-workspace.md +1 -1
- package/rihal/commands/next.md +1 -1
- package/rihal/commands/note.md +1 -1
- package/rihal/commands/notify-test.md +1 -1
- package/rihal/commands/pause-work.md +1 -1
- package/rihal/commands/plan-milestone-gaps.md +3 -3
- package/rihal/commands/plan.md +2 -2
- package/rihal/commands/plant-seed.md +1 -1
- package/rihal/commands/pr-branch.md +2 -2
- package/rihal/commands/prfaq.md +1 -1
- package/rihal/commands/profile-user.md +1 -1
- package/rihal/commands/progress.md +3 -3
- package/rihal/commands/quick.md +1 -1
- package/rihal/commands/remove-phase.md +1 -1
- package/rihal/commands/remove-workspace.md +1 -1
- package/rihal/commands/replay.md +1 -1
- package/rihal/commands/rerun.md +1 -1
- package/rihal/commands/research-phase.md +2 -2
- package/rihal/commands/resume-work.md +1 -1
- package/rihal/commands/review.md +1 -1
- package/rihal/commands/scan.md +1 -1
- package/rihal/commands/secure-phase.md +1 -1
- package/rihal/commands/session-report.md +1 -1
- package/rihal/commands/settings.md +1 -1
- package/rihal/commands/ship.md +2 -2
- package/rihal/commands/show.md +1 -1
- package/rihal/commands/sprint-planning.md +1 -1
- package/rihal/commands/sprint-status.md +1 -1
- package/rihal/commands/stats.md +1 -1
- package/rihal/commands/status.md +1 -1
- package/rihal/commands/ui-phase.md +1 -1
- package/rihal/commands/ui-review.md +1 -1
- package/rihal/commands/undo.md +1 -1
- package/rihal/commands/update.md +1 -1
- package/rihal/commands/validate-phase.md +1 -1
- package/rihal/commands/verify-phase.md +2 -2
- package/rihal/commands/verify-work.md +1 -1
- package/rihal/commands/why.md +1 -1
- package/rihal/commands/workstream.md +1 -1
- package/rihal/references/agent-shared-rules.md +1 -1
- package/rihal/references/command-redirect-format.md +7 -7
- package/rihal/references/context-budget.md +2 -2
- package/rihal/references/continuation-format.md +16 -16
- package/rihal/references/dispatch-banner.md +1 -1
- package/rihal/references/execution-protocol.md +2 -2
- package/rihal/references/gates.md +3 -3
- package/rihal/references/git-integration.md +1 -1
- package/rihal/references/output-format.md +4 -4
- package/rihal/references/output-realism.md +1 -1
- package/rihal/references/revision-loop.md +1 -1
- package/rihal/references/state-schema.md +15 -15
- package/rihal/references/ui-brand.md +1 -1
- package/rihal/references/verb-dictionary.md +15 -15
- package/rihal/references/workstream-flag.md +28 -28
- package/rihal/skills/_shared/no-autonomous-bypass.md +2 -2
- package/rihal/skills/_shared/research-citation-rule.md +1 -1
- package/rihal/skills/_shared/state-sync-rule.md +4 -4
- package/rihal/skills/actions/1-analysis/rihal-prfaq/SKILL.md +1 -1
- package/rihal/skills/actions/2-plan/rihal-create-epics-and-stories/workflow.md +1 -1
- package/rihal/skills/actions/2-plan/rihal-create-milestone/SKILL.md +2 -2
- package/rihal/skills/actions/2-plan/rihal-create-milestone/steps/step-06-phase-stubs.md +2 -2
- package/rihal/skills/actions/2-plan/rihal-create-milestone/steps/step-07-backlog.md +2 -2
- package/rihal/skills/actions/2-plan/rihal-create-milestone/steps/step-09-state-sync.md +2 -2
- package/rihal/skills/actions/2-plan/rihal-create-milestone/steps/step-10-complete.md +4 -4
- package/rihal/skills/actions/2-plan/rihal-create-milestone/workflow.md +5 -5
- package/rihal/skills/actions/2-plan/rihal-create-prd/SKILL.md +1 -1
- package/rihal/skills/actions/2-plan/rihal-create-prd/workflow.md +1 -1
- package/rihal/skills/actions/2-plan/rihal-create-story/workflow.md +1 -1
- package/rihal/skills/actions/4-implementation/rihal-checkpoint-preview/SKILL.md +3 -3
- package/rihal/skills/actions/4-implementation/rihal-dev-story/workflow.md +1 -1
- package/rihal/skills/actions/4-implementation/rihal-sprint-planning/SKILL.md +1 -1
- package/rihal/skills/actions/4-implementation/rihal-sprint-planning/checklist.md +1 -1
- package/rihal/skills/actions/4-implementation/rihal-sprint-planning/workflow.md +1 -1
- package/rihal/skills/actions/4-implementation/rihal-sprint-status/workflow.md +5 -5
- package/rihal/skills/agents/dalil-scout/SKILL.md +7 -7
- package/rihal/skills/core/rihal-brainstorming/SKILL.md +1 -1
- package/rihal/skills/core/rihal-init/SKILL.md +1 -1
- package/rihal/skills/core/rihal-party-mode/SKILL.md +1 -1
- package/rihal/templates/milestone.md +1 -1
- package/rihal/templates/projects/api-backend/PROJECT.md +1 -1
- package/rihal/templates/projects/mobile-app/PROJECT.md +1 -1
- package/rihal/templates/projects/saas-b2b/PROJECT.md +1 -1
- package/rihal/workflows/add-phase.md +10 -10
- package/rihal/workflows/add-tests.md +9 -9
- package/rihal/workflows/add-todo.md +5 -5
- package/rihal/workflows/analyze-dependencies.md +7 -7
- package/rihal/workflows/audit-fix.md +4 -4
- package/rihal/workflows/audit-milestone.md +8 -8
- package/rihal/workflows/audit-uat.md +2 -2
- package/rihal/workflows/audit.md +28 -28
- package/rihal/workflows/autonomous.md +128 -44
- package/rihal/workflows/brainstorm.md +7 -7
- package/rihal/workflows/chain.md +16 -16
- package/rihal/workflows/check-implementation-readiness.md +4 -4
- package/rihal/workflows/check-todos.md +8 -8
- package/rihal/workflows/checkpoint-preview.md +1 -1
- package/rihal/workflows/code-review-fix.md +10 -10
- package/rihal/workflows/code-review.md +10 -10
- package/rihal/workflows/complete-milestone.md +5 -5
- package/rihal/workflows/correct-course.md +7 -7
- package/rihal/workflows/council.md +15 -15
- package/rihal/workflows/create-epics-and-stories.md +9 -9
- package/rihal/workflows/create-story.md +11 -11
- package/rihal/workflows/dashboard.md +8 -8
- package/rihal/workflows/debug.md +6 -6
- package/rihal/workflows/decisions.md +5 -5
- package/rihal/workflows/dev-story.md +12 -12
- package/rihal/workflows/diagnose-issues.md +2 -2
- package/rihal/workflows/diff.md +3 -3
- package/rihal/workflows/discuss-phase-power.md +7 -7
- package/rihal/workflows/discuss-phase.md +14 -14
- package/rihal/workflows/discuss.md +9 -9
- package/rihal/workflows/do.md +79 -79
- package/rihal/workflows/docs-update.md +6 -6
- package/rihal/workflows/document-project.md +5 -5
- package/rihal/workflows/enable-hooks.md +5 -5
- package/rihal/workflows/execute-sprint.md +3 -3
- package/rihal/workflows/execute.md +28 -28
- package/rihal/workflows/explore.md +5 -5
- package/rihal/workflows/export-to-github.md +5 -5
- package/rihal/workflows/forensics.md +8 -8
- package/rihal/workflows/from-template.md +8 -8
- package/rihal/workflows/health.md +11 -11
- package/rihal/workflows/help.md +117 -117
- package/rihal/workflows/import.md +4 -4
- package/rihal/workflows/inbox.md +8 -8
- package/rihal/workflows/init.md +23 -23
- package/rihal/workflows/insert-phase.md +9 -9
- package/rihal/workflows/install.md +3 -3
- package/rihal/workflows/karpathy-audit.md +11 -11
- package/rihal/workflows/list-plans.md +8 -8
- package/rihal/workflows/list-workspaces.md +7 -7
- package/rihal/workflows/map-codebase.md +5 -5
- package/rihal/workflows/milestone-summary.md +7 -7
- package/rihal/workflows/new-milestone.md +11 -11
- package/rihal/workflows/new-project-research.md +1 -1
- package/rihal/workflows/new-project-roadmap.md +8 -8
- package/rihal/workflows/new-project.md +32 -32
- package/rihal/workflows/new-workspace.md +7 -7
- package/rihal/workflows/next.md +13 -13
- package/rihal/workflows/note.md +7 -7
- package/rihal/workflows/notify-test.md +6 -6
- package/rihal/workflows/pause-work.md +6 -6
- package/rihal/workflows/plan-milestone-gaps.md +7 -7
- package/rihal/workflows/plan.md +28 -28
- package/rihal/workflows/plant-seed.md +3 -3
- package/rihal/workflows/pr-branch.md +1 -1
- package/rihal/workflows/prfaq.md +1 -1
- package/rihal/workflows/profile-user.md +5 -5
- package/rihal/workflows/progress.md +6 -6
- package/rihal/workflows/quick.md +12 -12
- package/rihal/workflows/remove-phase.md +6 -6
- package/rihal/workflows/remove-workspace.md +8 -8
- package/rihal/workflows/replay.md +8 -8
- package/rihal/workflows/rerun.md +5 -5
- package/rihal/workflows/research-phase.md +2 -2
- package/rihal/workflows/resume-work.md +10 -10
- package/rihal/workflows/review-adversarial.md +4 -4
- package/rihal/workflows/review-edge-case-hunter.md +5 -5
- package/rihal/workflows/review.md +11 -11
- package/rihal/workflows/scan.md +9 -9
- package/rihal/workflows/secure-phase.md +8 -8
- package/rihal/workflows/session-report.md +6 -6
- package/rihal/workflows/settings.md +15 -15
- package/rihal/workflows/ship.md +11 -11
- package/rihal/workflows/show.md +2 -2
- package/rihal/workflows/sprint-planning.md +13 -13
- package/rihal/workflows/sprint-status.md +10 -10
- package/rihal/workflows/stats.md +6 -6
- package/rihal/workflows/status.md +15 -7
- package/rihal/workflows/ui-phase.md +8 -8
- package/rihal/workflows/ui-review.md +5 -5
- package/rihal/workflows/undo.md +17 -17
- package/rihal/workflows/update.md +12 -12
- package/rihal/workflows/validate-phase.md +5 -5
- package/rihal/workflows/verify-work.md +18 -18
- package/rihal/workflows/why.md +9 -9
- package/rihal/workflows/workstream.md +11 -11
- package/server/lib/html/client.js +45 -45
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: rihal
|
|
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
|
|
3
|
-
description: "Goal-backward audit — does the codebase actually deliver what the phase promised? Produces VERIFICATION.md with pass/fail. Required before /rihal
|
|
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
|
---
|
package/rihal/commands/why.md
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
59
|
-
/rihal
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
102
|
-
- `/rihal
|
|
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
|
|
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
|
|
131
|
-
- `/rihal
|
|
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
|
|
148
|
+
**To plan directly:** `/rihal-plan-phase 3`
|
|
149
149
|
|
|
150
|
-
**To discuss context first:** `/rihal
|
|
150
|
+
**To discuss context first:** `/rihal-discuss-phase 3`
|
|
151
151
|
|
|
152
|
-
**To research unknowns:** `/rihal
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
257
|
-
- `/rihal
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
80
|
-
| phase | `phase`, `phases` (singular intent — "add a phase") | `/rihal
|
|
81
|
-
| story | `story`, `stories`, `user story`, `kahani` | `/rihal
|
|
82
|
-
| epic | `epic`, `epics`, `epics and stories` | `/rihal
|
|
83
|
-
| sprint | `sprint`, `iteration` | `/rihal
|
|
84
|
-
| PRD | `PRD`, `requirements doc`, `product requirements` | `/rihal
|
|
85
|
-
| roadmap | `roadmap`, `plan` (top-level) | `/rihal
|
|
86
|
-
| council | `council`, `majlis`, `panel`, `mashwara`, `salah` | `/rihal
|
|
87
|
-
| plan (verb form — "plan phase N") | `plan` | `/rihal
|
|
88
|
-
| story (impl) | `dev story`, `implement story`, `build story` | `/rihal
|
|
89
|
-
| brainstorm | `brainstorm`, `ideas`, `sochain`, `sochna` | `/rihal
|
|
90
|
-
| review (code) | `code review`, `karpathy`, `check my diff` | `/rihal
|
|
91
|
-
| debug | `debug`, `fix`, `bug`, `error`, `crash`, `kharab`, `theek` | `/rihal
|
|
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
|
|
110
|
-
/rihal
|
|
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:**
|