@hanzlaa/rcode 3.4.3 → 3.4.5

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 (213) hide show
  1. package/AGENTS.md +1 -1
  2. package/CONTRIBUTING.md +63 -1
  3. package/README.md +9 -4
  4. package/cli/generate-command-skills.cjs +5 -5
  5. package/cli/index.js +0 -0
  6. package/cli/install.js +128 -3
  7. package/cli/lib/manifest.cjs +1 -1
  8. package/cli/uninstall.js +8 -0
  9. package/dist/rcode.js +19 -1
  10. package/package.json +16 -17
  11. package/rihal/agents/rihal-ahmed.md +2 -1
  12. package/rihal/agents/rihal-code-fixer.md +46 -0
  13. package/rihal/agents/rihal-code-reviewer.md +46 -1
  14. package/rihal/agents/rihal-deviation-analyzer.md +1 -0
  15. package/rihal/agents/rihal-docs-auditor.md +106 -1
  16. package/rihal/agents/rihal-edge-case-hunter.md +47 -1
  17. package/rihal/agents/rihal-executor.md +1 -1
  18. package/rihal/agents/rihal-khalid.md +40 -1
  19. package/rihal/agents/rihal-layla.md +2 -1
  20. package/rihal/agents/rihal-nasser.md +2 -1
  21. package/rihal/agents/rihal-noor.md +3 -2
  22. package/rihal/agents/rihal-nyquist-auditor.md +1 -1
  23. package/rihal/agents/rihal-phase-researcher.md +46 -1
  24. package/rihal/agents/rihal-planner.md +1 -1
  25. package/rihal/agents/rihal-profiler.md +45 -2
  26. package/rihal/agents/rihal-project-researcher.md +47 -0
  27. package/rihal/agents/rihal-remediation-planner.md +45 -0
  28. package/rihal/agents/rihal-roadmapper.md +46 -0
  29. package/rihal/agents/rihal-security-adversary.md +46 -1
  30. package/rihal/agents/rihal-security-auditor.md +45 -1
  31. package/rihal/agents/rihal-ui-auditor.md +44 -1
  32. package/rihal/agents/rihal-ux-designer.md +41 -1
  33. package/rihal/agents/rihal-zahra.md +2 -1
  34. package/rihal/agents/rihal-zayd.md +2 -1
  35. package/rihal/bin/lib/config.cjs +13 -1
  36. package/rihal/bin/lib/council-panel.cjs +185 -23
  37. package/rihal/bin/lib/roadmap.cjs +27 -2
  38. package/rihal/bin/rihal-tools.cjs +1837 -99
  39. package/rihal/commands/audit.md +2 -2
  40. package/rihal/commands/capture.md +12 -0
  41. package/rihal/commands/diagnose-issues.md +18 -0
  42. package/rihal/commands/discuss-phase-power.md +18 -0
  43. package/rihal/commands/feature-drift.md +18 -0
  44. package/rihal/commands/karpathy-audit.md +18 -0
  45. package/rihal/commands/lens-audit.md +70 -0
  46. package/rihal/commands/new-project-research.md +18 -0
  47. package/rihal/commands/new-project-roadmap.md +18 -0
  48. package/rihal/commands/phase.md +11 -0
  49. package/rihal/references/continuation-format.md +3 -3
  50. package/rihal/references/output-format.md +79 -0
  51. package/rihal/references/revision-loop.md +1 -1
  52. package/rihal/references/verb-dictionary.md +85 -28
  53. package/rihal/skills/actions/1-analysis/rihal-prfaq/SKILL.md +1 -1
  54. package/rihal/skills/actions/2-plan/rihal-create-epics-and-stories/SKILL.md +12 -2
  55. package/rihal/skills/actions/2-plan/rihal-create-epics-and-stories/steps/step-04-final-validation.md +12 -0
  56. package/rihal/skills/actions/2-plan/rihal-create-prd/SKILL.md +12 -2
  57. package/rihal/skills/actions/2-plan/rihal-create-story/SKILL.md +12 -2
  58. package/rihal/skills/actions/4-implementation/rihal-browser-verify/SKILL.md +1 -1
  59. package/rihal/skills/actions/4-implementation/rihal-checkpoint-preview/SKILL.md +1 -1
  60. package/rihal/skills/actions/4-implementation/rihal-ci/SKILL.md +1 -1
  61. package/rihal/skills/actions/4-implementation/rihal-code-review/SKILL.md +16 -4
  62. package/rihal/skills/actions/4-implementation/rihal-debug/SKILL.md +14 -1
  63. package/rihal/skills/actions/4-implementation/rihal-git-flow/SKILL.md +1 -1
  64. package/rihal/skills/actions/4-implementation/rihal-harden/SKILL.md +1 -1
  65. package/rihal/skills/actions/4-implementation/rihal-incremental/SKILL.md +1 -1
  66. package/rihal/skills/actions/4-implementation/rihal-migrate/SKILL.md +1 -1
  67. package/rihal/skills/actions/4-implementation/rihal-perf/SKILL.md +1 -1
  68. package/rihal/skills/actions/4-implementation/rihal-prove-it/SKILL.md +1 -1
  69. package/rihal/skills/actions/4-implementation/rihal-scaffold-project/steps/step-01-target.md +6 -0
  70. package/rihal/skills/actions/4-implementation/rihal-source-truth/SKILL.md +1 -1
  71. package/rihal/skills/actions/4-implementation/rihal-sprint-planning/SKILL.md +14 -3
  72. package/rihal/skills/actions/4-implementation/rihal-trim/SKILL.md +1 -1
  73. package/rihal/skills/agents/ahmed-hassani-director/SKILL.md +15 -1
  74. package/rihal/skills/agents/dalil-scout/SKILL.md +14 -2
  75. package/rihal/skills/agents/fatima-qa/SKILL.md +16 -1
  76. package/rihal/skills/agents/haitham-frontend/SKILL.md +13 -1
  77. package/rihal/skills/agents/hanzla-engineer/SKILL.md +13 -1
  78. package/rihal/skills/agents/hussain-pm/SKILL.md +16 -1
  79. package/rihal/skills/agents/hussain-sm/SKILL.md +14 -1
  80. package/rihal/skills/agents/layla-designer/SKILL.md +13 -1
  81. package/rihal/skills/agents/majlis-council/SKILL.md +16 -1
  82. package/rihal/skills/agents/mariam-marketing/SKILL.md +14 -1
  83. package/rihal/skills/agents/nasser-eng-manager/SKILL.md +16 -1
  84. package/rihal/skills/agents/noor-writer/SKILL.md +15 -1
  85. package/rihal/skills/agents/raees-orchestrator/SKILL.md +15 -1
  86. package/rihal/skills/agents/rihal-cross-platform-auditor/SKILL.md +162 -0
  87. package/rihal/skills/agents/rihal-dep-auditor/SKILL.md +151 -0
  88. package/rihal/skills/agents/rihal-deviation-analyzer/SKILL.md +78 -0
  89. package/rihal/skills/agents/rihal-i18n-auditor/SKILL.md +152 -0
  90. package/rihal/skills/agents/rihal-observability-auditor/SKILL.md +156 -0
  91. package/rihal/skills/agents/sadiq-analyst/SKILL.md +12 -2
  92. package/rihal/skills/agents/waleed-architect/SKILL.md +12 -2
  93. package/rihal/skills/agents/yousef-backend/SKILL.md +12 -2
  94. package/rihal/skills/agents/zahra-branding/SKILL.md +15 -1
  95. package/rihal/skills/agents/zayd-ml/SKILL.md +13 -1
  96. package/rihal/skills/core/rihal-advanced-elicitation/SKILL.md +2 -2
  97. package/rihal/skills/core/rihal-auth-audit/SKILL.md +1 -1
  98. package/rihal/skills/core/rihal-brainstorming/SKILL.md +13 -2
  99. package/rihal/skills/core/rihal-client-gate/SKILL.md +1 -1
  100. package/rihal/skills/core/rihal-clone-website/SKILL.md +11 -1
  101. package/rihal/skills/core/rihal-deploy-unify/SKILL.md +1 -1
  102. package/rihal/skills/core/rihal-distillator/SKILL.md +2 -2
  103. package/rihal/skills/core/rihal-editorial-review-prose/SKILL.md +1 -1
  104. package/rihal/skills/core/rihal-editorial-review-structure/SKILL.md +2 -2
  105. package/rihal/skills/core/rihal-help/SKILL.md +18 -1
  106. package/rihal/skills/core/rihal-incident-record/SKILL.md +1 -1
  107. package/rihal/skills/core/rihal-index-docs/SKILL.md +1 -1
  108. package/rihal/skills/core/rihal-memory-audit/SKILL.md +18 -1
  109. package/rihal/skills/core/rihal-memory-init/SKILL.md +13 -1
  110. package/rihal/skills/core/rihal-memory-update/SKILL.md +13 -1
  111. package/rihal/skills/core/rihal-mvp-graduate/SKILL.md +1 -1
  112. package/rihal/skills/core/rihal-ocr-consistency/SKILL.md +1 -1
  113. package/rihal/skills/core/rihal-rebrand/SKILL.md +1 -1
  114. package/rihal/skills/core/rihal-review-adversarial-general/SKILL.md +1 -1
  115. package/rihal/skills/core/rihal-review-edge-case-hunter/SKILL.md +17 -1
  116. package/rihal/skills/core/rihal-shard-doc/SKILL.md +1 -1
  117. package/rihal/skills/core/rihal-theme-system/SKILL.md +1 -1
  118. package/rihal/team.yaml +0 -7
  119. package/rihal/templates/RESEARCH.md +84 -0
  120. package/rihal/templates/VALIDATION.md +45 -0
  121. package/rihal/templates/memory/INDEX.md +1 -0
  122. package/rihal/templates/memory/project/design-system.md +128 -0
  123. package/rihal/templates/summary.md +33 -3
  124. package/rihal/workflows/add-tests.md +1 -1
  125. package/rihal/workflows/add-todo.md +6 -0
  126. package/rihal/workflows/analyze-dependencies.md +6 -0
  127. package/rihal/workflows/audit-fix.md +12 -0
  128. package/rihal/workflows/audit-milestone.md +2 -2
  129. package/rihal/workflows/audit.md +23 -14
  130. package/rihal/workflows/autonomous-smart-discuss.md +247 -0
  131. package/rihal/workflows/autonomous.md +54 -267
  132. package/rihal/workflows/capture.md +60 -0
  133. package/rihal/workflows/chain.md +1 -1
  134. package/rihal/workflows/code-review-fix.md +6 -3
  135. package/rihal/workflows/code-review.md +34 -10
  136. package/rihal/workflows/complete-milestone.md +17 -8
  137. package/rihal/workflows/correct-course.md +6 -0
  138. package/rihal/workflows/council.md +37 -23
  139. package/rihal/workflows/create-architecture.md +31 -0
  140. package/rihal/workflows/create-epics-and-stories.md +7 -1
  141. package/rihal/workflows/create-prd.md +25 -0
  142. package/rihal/workflows/dashboard.md +1 -1
  143. package/rihal/workflows/debug.md +8 -0
  144. package/rihal/workflows/decisions.md +1 -1
  145. package/rihal/workflows/diff.md +6 -0
  146. package/rihal/workflows/discuss-phase-discuss-areas.md +271 -0
  147. package/rihal/workflows/discuss-phase.md +27 -266
  148. package/rihal/workflows/do.md +51 -12
  149. package/rihal/workflows/docs-update.md +3 -0
  150. package/rihal/workflows/document-project.md +7 -1
  151. package/rihal/workflows/edit-prd.md +31 -0
  152. package/rihal/workflows/enable-hooks.md +1 -1
  153. package/rihal/workflows/execute-regression-gates.md +131 -0
  154. package/rihal/workflows/execute-sprint.md +31 -2
  155. package/rihal/workflows/execute-verify-phase-goal.md +136 -0
  156. package/rihal/workflows/execute-waves.md +404 -0
  157. package/rihal/workflows/execute.md +101 -642
  158. package/rihal/workflows/feature-drift.md +243 -0
  159. package/rihal/workflows/forensics.md +10 -2
  160. package/rihal/workflows/health.md +65 -16
  161. package/rihal/workflows/help.md +36 -9
  162. package/rihal/workflows/import.md +17 -3
  163. package/rihal/workflows/init.md +20 -10
  164. package/rihal/workflows/install.md +2 -10
  165. package/rihal/workflows/lens-audit.md +689 -0
  166. package/rihal/workflows/map-codebase.md +7 -1
  167. package/rihal/workflows/memory-audit.md +67 -5
  168. package/rihal/workflows/memory-distill.md +10 -0
  169. package/rihal/workflows/memory-init.md +4 -0
  170. package/rihal/workflows/memory-update.md +4 -0
  171. package/rihal/workflows/new-milestone.md +7 -1
  172. package/rihal/workflows/new-project-create-roadmap.md +176 -0
  173. package/rihal/workflows/new-project-define-requirements.md +160 -0
  174. package/rihal/workflows/new-project-research-decision.md +247 -0
  175. package/rihal/workflows/new-project.md +3 -557
  176. package/rihal/workflows/note.md +1 -1
  177. package/rihal/workflows/phase.md +54 -0
  178. package/rihal/workflows/plan-milestone-gaps.md +1 -1
  179. package/rihal/workflows/plan-prd-express.md +108 -0
  180. package/rihal/workflows/plan-research-validation.md +313 -0
  181. package/rihal/workflows/plan-spawn-planner.md +204 -0
  182. package/rihal/workflows/plan.md +91 -532
  183. package/rihal/workflows/plant-seed.md +1 -1
  184. package/rihal/workflows/pr-branch.md +1 -1
  185. package/rihal/workflows/profile-user.md +1 -1
  186. package/rihal/workflows/quick.md +3 -3
  187. package/rihal/workflows/remove-phase.md +6 -1
  188. package/rihal/workflows/remove-workspace.md +6 -0
  189. package/rihal/workflows/rerun.md +1 -1
  190. package/rihal/workflows/research-phase.md +4 -2
  191. package/rihal/workflows/resume-work.md +8 -3
  192. package/rihal/workflows/retrospective.md +31 -0
  193. package/rihal/workflows/review-adversarial.md +12 -0
  194. package/rihal/workflows/review.md +6 -0
  195. package/rihal/workflows/scaffold-project.md +31 -0
  196. package/rihal/workflows/scan.md +10 -0
  197. package/rihal/workflows/secure-phase.md +15 -2
  198. package/rihal/workflows/session-report.md +32 -7
  199. package/rihal/workflows/ship.md +7 -2
  200. package/rihal/workflows/show.md +6 -0
  201. package/rihal/workflows/sprint-status.md +4 -4
  202. package/rihal/workflows/status.md +2 -2
  203. package/rihal/workflows/ui-phase.md +1 -1
  204. package/rihal/workflows/undo.md +2 -3
  205. package/rihal/workflows/update.md +2 -2
  206. package/rihal/workflows/validate-phase.md +1 -1
  207. package/rihal/workflows/validate-prd.md +31 -0
  208. package/rihal/workflows/verify-phase.md +38 -5
  209. package/rihal/workflows/verify-work.md +25 -11
  210. package/rihal/workflows/workstream.md +20 -8
  211. package/server/lib/html/client.js +13 -63
  212. package/server/lib/html/shell.js +0 -1
  213. package/server/lib/scanner.js +33 -2
@@ -0,0 +1,156 @@
1
+ ---
2
+ name: rihal-observability-auditor
3
+ description: >
4
+ Observability and silent-failure auditor. Detects unguarded rihal-tools
5
+ shell calls, Task() results that are never checked, bare 2>/dev/null
6
+ without fallback echo, INIT calls without .ok checks, and unstructured
7
+ console.log in production code. Audit-only — never adds instrumentation.
8
+ Activates when the user says "observability audit", "silent failures",
9
+ "unguarded calls", "missing error handling", "tool call guard", or similar.
10
+ triggers:
11
+ # English
12
+ - "observability audit"
13
+ - "silent failures"
14
+ - "unguarded calls"
15
+ - "missing error handling"
16
+ - "tool call guard"
17
+ - "swallowed errors"
18
+ - "unchecked results"
19
+ - "2>/dev/null check"
20
+ - "INIT ok check"
21
+ - "Task result not checked"
22
+ # Urdu / mixed
23
+ - "observability check karo"
24
+ - "silent failures dhundo"
25
+ - "unguarded calls dhundo"
26
+ not-for:
27
+ - adding observability instrumentation (use OpenTelemetry directly)
28
+ - performance monitoring (use rihal-perf)
29
+ - log aggregation setup (use rihal-khalid)
30
+ allowed-tools: Read, Bash, Write
31
+ ---
32
+
33
+ ## Overview
34
+
35
+ Observability specialist for the rihal workflow system. Identifies the "dark
36
+ corners" where failures are swallowed silently — the most dangerous class of
37
+ bugs in orchestrated multi-agent workflows.
38
+
39
+ Draws on patterns from:
40
+ - **OpenTelemetry** (CNCF, opentelemetry.io) — traces/metrics/logs standards
41
+ - **Pino** (★13k github.com/pinojs/pino) — structured JSON logging, level guards
42
+ - **Winston** (★22k github.com/winstonjs/winston) — multi-transport logging patterns
43
+ - **node:assert** — assertion-based guard patterns
44
+ - **Bash errexit/pipefail** (`set -euo pipefail`) — shell error propagation
45
+
46
+ ## Workflow
47
+
48
+ ### Step 1 — Unguarded rihal-tools calls in workflows
49
+
50
+ ```bash
51
+ # rihal-tools calls without 2>/dev/null or error handling
52
+ grep -rn "rihal-tools\.cjs\b\|node.*rihal-tools" \
53
+ rihal/workflows/*.md .rihal/workflows/*.md 2>/dev/null | \
54
+ grep -v "2>/dev/null\||| echo\||| true\|^#\|example"
55
+
56
+ # Shell calls using $() without error guards
57
+ grep -rn "\$(\(node\|bash\|sh\)\b" \
58
+ rihal/workflows/*.md .rihal/workflows/*.md 2>/dev/null | \
59
+ grep -v "2>/dev/null\||| echo\|try\b"
60
+ ```
61
+
62
+ ### Step 2 — Task() results not captured or checked
63
+
64
+ ```bash
65
+ # Task() calls where result is not stored or checked
66
+ grep -rn "Task(" \
67
+ rihal/workflows/*.md .rihal/workflows/*.md 2>/dev/null | \
68
+ while read -r line; do
69
+ file="${line%%:*}"
70
+ lineno=$(echo "$line" | cut -d: -f2)
71
+ # Check within 6 lines after Task() for result capture
72
+ result=$(sed -n "$lineno,$((lineno+6))p" "$file" 2>/dev/null)
73
+ if ! echo "$result" | grep -qE "result|output|ok|error|fail|FINDINGS|RESULT"; then
74
+ echo "$file:$lineno — Task() result not captured [warn]"
75
+ fi
76
+ done
77
+ ```
78
+
79
+ ### Step 3 — Bare 2>/dev/null without fallback
80
+
81
+ ```bash
82
+ # 2>/dev/null at end of line with no || fallback
83
+ grep -rn "2>/dev/null$" \
84
+ rihal/workflows/*.md .rihal/workflows/*.md 2>/dev/null | \
85
+ grep -v "|| echo\||| true\||| exit\||| :\b"
86
+ ```
87
+
88
+ ### Step 4 — INIT calls without .ok guard
89
+
90
+ ```bash
91
+ # INIT= assignments followed by no .ok check in next 15 lines
92
+ grep -rn "INIT=\$(" \
93
+ rihal/workflows/*.md .rihal/workflows/*.md 2>/dev/null | \
94
+ while read -r line; do
95
+ file="${line%%:*}"
96
+ lineno=$(echo "$line" | cut -d: -f2)
97
+ window=$(sed -n "$lineno,$((lineno+15))p" "$file" 2>/dev/null)
98
+ if ! echo "$window" | grep -qE "\.ok|ok.*false|INIT.*ok"; then
99
+ echo "$file:$lineno — INIT= assigned but no .ok check in next 15 lines [warn]"
100
+ fi
101
+ done
102
+ ```
103
+
104
+ ### Step 5 — console.log in production Node code
105
+
106
+ ```bash
107
+ # console.log/error/warn/debug in non-test production code
108
+ for f in $(find rihal/bin/ .rihal/bin/ -name "*.cjs" -o -name "*.js" 2>/dev/null); do
109
+ [[ "$f" == *.test.* ]] || [[ "$f" == *.spec.* ]] && continue
110
+ grep -n "console\.\(log\|error\|warn\|debug\)" "$f" 2>/dev/null | \
111
+ while read -r line; do
112
+ echo "$f:${line%%:*} — unstructured console.log in production code [info]"
113
+ done
114
+ done
115
+ ```
116
+
117
+ ### Step 6 — set -e / set -euo pipefail missing in shell scripts
118
+
119
+ ```bash
120
+ find rihal/ .rihal/ -name "*.sh" -maxdepth 8 2>/dev/null | \
121
+ while read -r f; do
122
+ if ! grep -q "set -e\|set -euo pipefail\|set -o errexit" "$f" 2>/dev/null; then
123
+ echo "$f — no set -e or set -euo pipefail (errors silently ignored) [warn]"
124
+ fi
125
+ done
126
+ ```
127
+
128
+ ### Step 7 — Compile findings
129
+
130
+ Format: `file:line — description [severity: critical|warn|info]`
131
+
132
+ If no findings: respond `PASS`
133
+
134
+ ## Output Format
135
+
136
+ ```
137
+ ## Observability Findings — Lens 13
138
+
139
+ | File | Line | Issue | Severity |
140
+ |------|------|-------|----------|
141
+ {rows}
142
+
143
+ Silent failure risk: {critical} critical, {warn} warnings, {info} info
144
+ Status: PASS | WARN | FAIL
145
+ ```
146
+
147
+ ## Examples
148
+
149
+ **Happy path:**
150
+ User: "observability audit" → scans all workflows and bin files for unguarded calls
151
+
152
+ **Edge — rihal not installed:**
153
+ Agent: "rihal/workflows/ not found. Checking .rihal/ instead."
154
+
155
+ **Negative — asked to add logging:**
156
+ User: "add OpenTelemetry traces" → Agent: "Audit-only. The findings above show where instrumentation is missing — open a fix issue to add it."
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: rihal-agent-sadiq
2
+ name: rihal-sadiq-analyst
3
3
  description: >
4
4
  Strategic business analyst and strategy director for market research,
5
5
  competitive analysis, product briefs, brainstorming facilitation, and
@@ -13,6 +13,7 @@ description: >
13
13
  Hussain-PM), architecture decisions (use Waleed), implementation (use
14
14
  Hanzla), sprint planning (use Hussain-SM), or design (use Layla).
15
15
  triggers:
16
+ # English
16
17
  - "market research"
17
18
  - "competitive analysis"
18
19
  - "SWOT"
@@ -24,8 +25,17 @@ triggers:
24
25
  - "prioritize these ideas"
25
26
  - "RICE framework"
26
27
  - "opportunity analysis"
27
- - "document this project"
28
28
  - "talk to Sadiq"
29
+ # Roman Urdu / Hindi
30
+ - "market research karo"
31
+ - "strategy banao"
32
+ - "Sadiq sai poocho"
33
+ # Arabic native
34
+ - "تحدث مع صادق"
35
+ - "بحث السوق"
36
+ - "تحليل تنافسي"
37
+ - "استراتيجية المنتج"
38
+ - "ماذا نبني"
29
39
  ---
30
40
  @.rihal/references/karpathy-guidelines.md
31
41
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: rihal-agent-waleed
2
+ name: rihal-waleed-architect
3
3
  description: >
4
4
  System architect and CTO for technical architecture decisions, tech stack
5
5
  selection, ADR writing, scalability planning, and security posture reviews.
@@ -15,6 +15,7 @@ description: >
15
15
  (use Fatima), deployment pipelines (use Khalid), or business strategy
16
16
  (use Sadiq).
17
17
  triggers:
18
+ # English
18
19
  - "design the architecture"
19
20
  - "what stack should I use"
20
21
  - "pick the tech stack"
@@ -26,9 +27,18 @@ triggers:
26
27
  - "review this architecture"
27
28
  - "technical decision"
28
29
  - "database choice"
29
- - "should I use X or Y"
30
30
  - "talk to Waleed"
31
31
  - "as the CTO"
32
+ # Roman Urdu / Hindi
33
+ - "architecture banao"
34
+ - "stack choose karo"
35
+ - "Waleed sai poocho"
36
+ # Arabic native
37
+ - "تحدث مع وليد"
38
+ - "صمم البنية"
39
+ - "اختر التقنية"
40
+ - "قرار معماري"
41
+ - "مراجعة معمارية"
32
42
  ---
33
43
  @.rihal/references/karpathy-guidelines.md
34
44
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: rihal-agent-yousef
2
+ name: rihal-yousef-backend
3
3
  description: >
4
4
  Senior backend engineer for APIs, databases, services, auth, data
5
5
  pipelines, integrations, and production backend work at Rihal scale.
@@ -15,6 +15,7 @@ description: >
15
15
  architectural tradeoffs (use Waleed), or deployment pipelines
16
16
  (use Khalid).
17
17
  triggers:
18
+ # English
18
19
  - "backend"
19
20
  - "API design"
20
21
  - "database"
@@ -26,9 +27,18 @@ triggers:
26
27
  - "talk to Yousef"
27
28
  - "build the backend"
28
29
  - "write the API"
29
- - "backend architecture"
30
30
  - "database schema"
31
31
  - "server performance"
32
+ # Roman Urdu / Hindi
33
+ - "backend banao"
34
+ - "API banao"
35
+ - "Yousef sai poocho"
36
+ # Arabic native
37
+ - "تحدث مع يوسف"
38
+ - "ابني الواجهة الخلفية"
39
+ - "صمم API"
40
+ - "قاعدة البيانات"
41
+ - "خدمة خلفية"
32
42
  ---
33
43
  @.rihal/references/karpathy-guidelines.md
34
44
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: rihal-agent-zahra
2
+ name: rihal-zahra-branding
3
3
  description: >
4
4
  Branding and Creative Director who owns brand identity, visual
5
5
  language, typography systems (Latin + Arabic), color systems,
@@ -17,6 +17,7 @@ description: >
17
17
  marketing copy (use Mariam), or technical documentation
18
18
  (use Noor).
19
19
  triggers:
20
+ # English
20
21
  - "branding"
21
22
  - "brand identity"
22
23
  - "logo"
@@ -30,6 +31,19 @@ triggers:
30
31
  - "typography"
31
32
  - "brand assets"
32
33
  - "design language"
34
+ - "Arabic typography"
35
+ - "type pair"
36
+ # Roman Urdu / Hindi
37
+ - "branding banao"
38
+ - "logo design karo"
39
+ - "Zahra sai poocho"
40
+ # Arabic native
41
+ - "تحدث مع زهرة"
42
+ - "هوية العلامة"
43
+ - "نظام الألوان"
44
+ - "خطوط عربية"
45
+ - "إرشادات العلامة"
46
+ - "صوت العلامة"
33
47
  ---
34
48
  @.rihal/references/karpathy-guidelines.md
35
49
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: rihal-agent-zayd
2
+ name: rihal-zayd-ml
3
3
  description: >
4
4
  Senior ML engineer for machine learning model selection, training,
5
5
  evaluation, feature engineering, LLM integration, retrieval systems,
@@ -15,6 +15,7 @@ description: >
15
15
  Haitham), architecture of non-ML systems (use Waleed), or testing
16
16
  strategy (use Fatima).
17
17
  triggers:
18
+ # English
18
19
  - "machine learning"
19
20
  - "ML model"
20
21
  - "AI"
@@ -30,6 +31,17 @@ triggers:
30
31
  - "vector database"
31
32
  - "NLP"
32
33
  - "deep learning"
34
+ - "Arabic NLP"
35
+ # Roman Urdu / Hindi
36
+ - "model train karo"
37
+ - "ML feature banao"
38
+ - "Zayd sai poocho"
39
+ # Arabic native
40
+ - "تحدث مع زيد"
41
+ - "تعلم الآلة"
42
+ - "نموذج ذكاء اصطناعي"
43
+ - "هندسة الموجهات"
44
+ - "معالجة اللغة العربية"
33
45
  ---
34
46
  @.rihal/references/karpathy-guidelines.md
35
47
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rihal-advanced-elicitation
3
- description: Push the LLM to reconsider, refine, and improve its recent output through structured methods like socratic questioning, first principles, pre-mortem, and red-teaming. Use when the user asks for deeper critique, says "push harder on this", "go deeper", "challenge this", "stress-test this section", or names a specific elicitation method. For prose editing use rihal-editorial-review-prose; for structural review use rihal-editorial-review-structure.
3
+ description: Push the LLM to reconsider, refine, and improve its recent output through structured methods like.
4
4
  agent_party: '{project-root}/.rihal/team.yaml'
5
5
  triggers:
6
6
  - "advanced elicitation"
@@ -20,7 +20,7 @@ user-invocable: true
20
20
 
21
21
  Iterative menu-driven enhancement of recently-generated content. Presents 5 contextually-chosen elicitation methods (from `methods.csv`), runs the user's pick against the current content, shows the improvement, and re-offers the menu until the user picks `x` to proceed. Designed to be invoked indirectly from a parent prompt that just produced a section, then return the enhanced version. Detailed method registry, response cases, and execution rules live in [`references.md`](references.md).
22
22
 
23
- ## Process
23
+ ## Workflow
24
24
 
25
25
  1. **Method registry loading.** Read `./methods.csv` and `{agent_party}` from `.rihal/team.yaml`.
26
26
  2. **Context analysis.** Use conversation history to detect content type, complexity, stakeholder needs, risk level, creative potential.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rihal-auth-audit
3
- description: Audit Keycloak ↔ Active Directory sync, JWT validation, and tenant isolation in multi-org Postgres. Use when seeing authentication weirdness — users disappearing, tokens accepted post-deactivation, "phantom" sessions, or tenant data leaking across orgs. Specifically encodes the lessons from the Rihal Keycloak data-loss incident — sync drift between Keycloak and AD silently broke logins.
3
+ description: Audit Keycloak ↔ Active Directory sync, JWT validation, and tenant isolation in multi-org Postgres.
4
4
  triggers:
5
5
  - "auth audit"
6
6
  - "keycloak ad sync"
@@ -8,17 +8,28 @@ description: >
8
8
  "lateral thinking", or "think outside the box". Do NOT use for strategic
9
9
  analysis (use rihal-sadiq-analyst) or product requirements (use rihal-create-prd).
10
10
  triggers:
11
+ # English
11
12
  - "brainstorm"
12
13
  - "help me brainstorm"
13
14
  - "help me ideate"
14
15
  - "ideation session"
15
- - "creative
16
- thinking"
16
+ - "creative thinking"
17
17
  - "generate ideas"
18
18
  - "idea generation"
19
19
  - "divergent thinking"
20
20
  - "lateral thinking"
21
21
  - "think outside the box"
22
+ # Roman Urdu / Hindi
23
+ - "brainstorm karo"
24
+ - "ideas socho"
25
+ - "naye ideas chahiye"
26
+ - "soch lo"
27
+ # Arabic native
28
+ - "عصف ذهني"
29
+ - "ولّد أفكارًا"
30
+ - "أفكار جديدة"
31
+ - "تفكير إبداعي"
32
+ - "ساعدني أفكر"
22
33
  user-invocable: true
23
34
  ---
24
35
  @.rihal/references/karpathy-guidelines.md
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rihal-client-gate
3
- description: Client requirement freeze gates and async-comm patterns to stop late requirements from derailing delivery. Use when a project keeps slipping because the client adds requirements mid-sprint, or when the client takes a week to respond to a blocking question. Specifically encodes Rihal's "client late requirements caused project delays" pain — the fix isn't to "communicate better", it's structural gates that the project actually enforces.
3
+ description: Client requirement freeze gates and async-comm patterns to stop late requirements from derailing.
4
4
  triggers:
5
5
  - "client gate"
6
6
  - "freeze requirements"
@@ -13,6 +13,7 @@ description: >
13
13
  brief (use rihal-dev-story with Hanzla), or inspiration-only references
14
14
  without rebuild intent.
15
15
  triggers:
16
+ # English
16
17
  - "clone this website"
17
18
  - "clone this site"
18
19
  - "rebuild this page"
@@ -22,9 +23,18 @@ triggers:
22
23
  - "copy this site"
23
24
  - "reverse engineer this site"
24
25
  - "build me a clone of"
26
+ # Roman Urdu / Hindi
25
27
  - "aisi website banao"
26
28
  - "yeh site clone karo"
27
29
  - "exact same UI chahiye like [URL]"
30
+ - "yeh website ki copy banao"
31
+ - "site ko clone karo"
32
+ # Arabic native
33
+ - "استنسخ هذا الموقع"
34
+ - "أعد بناء هذه الصفحة"
35
+ - "موقع مطابق تمامًا"
36
+ - "انسخ هذا الموقع"
37
+ - "هندسة عكسية للموقع"
28
38
  argument-hint: "<url>"
29
39
  user-invocable: true
30
40
  ---
@@ -35,7 +45,7 @@ user-invocable: true
35
45
 
36
46
  Reverse-engineer a target URL into a working Next.js + shadcn/ui + Tailwind clone. The skill is **foreman-style**: extract a section, write a spec file, dispatch a builder agent in a worktree, move on to the next section. Extraction is meticulous (computed CSS, real assets, both static and behavioral) — building runs in parallel. Detailed principles, scripts, and templates live in [`references.md`](references.md).
37
47
 
38
- ## Process
48
+ ## Workflow
39
49
 
40
50
  1. **Pre-flight** — Chrome MCP available, Next.js + shadcn scaffold builds clean, output dirs exist.
41
51
  2. **Phase 1 — Reconnaissance** — full-page screenshots (desktop + mobile), global extraction (fonts, colors, favicons), mandatory interaction sweep (scroll, click, hover, responsive), page topology map.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rihal-deploy-unify
3
- description: Detect and unify multiple deployment paths in a single project. Use when a repo has accumulated overlapping deploy mechanisms (Docker Compose + Helm + manual scripts + Vercel + Jenkins) and "which one runs in production" is unclear. Specifically encodes the Siraaj deployment chaos lesson — multiple deploy paths cost a week of debugging and broke Keycloak more than once.
3
+ description: Detect and unify multiple deployment paths in a single project.
4
4
  triggers:
5
5
  - "deploy unify"
6
6
  - "multiple deploy paths"
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rihal-distillator
3
- description: Lossless LLM-optimized compression of source documents. Use when the user requests to "distill documents" or "create a distillate". Distillates preserve every fact, decision, constraint, and relationship while stripping prose overhead — designed as drop-in LLM context. Not summarisation (summaries are lossy). For Memory Bank distillates specifically, use rcode-memory-distill.
3
+ description: Lossless LLM-optimized compression of source documents.
4
4
  argument-hint: "<source-paths> [--validate <distillate-path>] [--token-budget <N>] [--consumer <name>]"
5
5
  triggers:
6
6
  - "distillator"
@@ -16,7 +16,7 @@ user-invocable: true
16
16
 
17
17
  Compresses source documents into a dense, lossless distillate optimised for LLM context loading. Output is one (or several semantically split) markdown files containing every fact, decision, named entity, and relationship from the sources — but no prose connectives, decoration, or repetition. A downstream LLM can use the distillate as sole context with no information loss.
18
18
 
19
- ## Process
19
+ ## Workflow
20
20
 
21
21
  1. **Validate inputs.** Required: `source_documents`. Optional: `downstream_consumer` (judges signal vs noise; if omitted, preserve everything), `token_budget` (triggers split when exceeded), `output_path` (default: adjacent to primary source with `-distillate.md` suffix), `--validate` flag (round-trip reconstruction test).
22
22
  2. **Stage 1 — Analyze.** Run `scripts/analyze_sources.py` on the source paths. Use its routing recommendation (`single` / `fan-out`) and grouping output. Do not read sources yourself.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rihal-editorial-review-prose
3
- description: 'Clinical copy-editor that reviews text for communication issues. Use when user says review for prose or improve the prose'
3
+ description: "Clinical copy-editor that reviews text for communication issues."
4
4
  triggers:
5
5
  - "editorial review prose"
6
6
  ---
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rihal-editorial-review-structure
3
- description: Structural editor that proposes cuts, reorganization, and consolidation while preserving comprehension. Use when the user requests structural review, "review the structure of this doc", or "tighten this document". Run before copy editing. For prose-level fixes (typos, grammar, word choice) use rihal-editorial-review-prose instead.
3
+ description: Structural editor that proposes cuts, reorganization, and consolidation while preserving.
4
4
  triggers:
5
5
  - "editorial review structure"
6
6
  - "structural review"
@@ -25,7 +25,7 @@ Structural editor focused on high-value density. Reviews a document's organisati
25
25
  - `reader_type` (optional, default `humans`) — `humans` preserves comprehension aids; `llm` optimises for precision and density
26
26
  - `length_target` (optional) — e.g. "30% shorter", "no limit"
27
27
 
28
- ## Process
28
+ ## Workflow
29
29
 
30
30
  1. **Validate input.** HALT if content is fewer than 3 words or `reader_type` is invalid. Note current word and section counts.
31
31
  2. **Understand purpose.** Use provided `purpose` and `target_audience` or infer them. Pick the structure model that fits (Tutorial / Reference / Explanation / Prompt / Pyramid — see references).
@@ -1,8 +1,25 @@
1
1
  ---
2
2
  name: rihal-help
3
- description: 'Analyzes current state and user query to answer Rihal questions or recommend the next skill(s) to use. Use when user asks for help, Rihal help, what to do next, or what to start with in Rihal.'
3
+ description: "Answers Rihal questions and recommends the next skill to run, based on current project state."
4
4
  triggers:
5
+ # English
5
6
  - "help"
7
+ - "rihal help"
8
+ - "what should I do next"
9
+ - "what can rihal do"
10
+ - "show me my options"
11
+ # Roman Urdu / Hindi
12
+ - "madad karo"
13
+ - "madad chahiye"
14
+ - "rihal mein kya karu"
15
+ - "agla kadam kya hai"
16
+ - "kya karu rihal mein"
17
+ # Arabic native
18
+ - "ساعدني"
19
+ - "مساعدة"
20
+ - "ما الخطوة التالية"
21
+ - "ماذا أفعل في ريحال"
22
+ - "كيف أبدأ"
6
23
  ---
7
24
  @.rihal/references/karpathy-guidelines.md
8
25
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rihal-incident-record
3
- description: Generate a change record + post-mortem in one flow. Use after resolving any production incident, deploying any non-trivial change, or making any decision that future-you will need to retrace. Implements the verified Rihal change-record format from `template/docs/change_records/`. Pairs with rihal-debug — once the bug is rooted-out, this skill writes the record.
3
+ description: Generate a change record + post-mortem in one flow.
4
4
  triggers:
5
5
  - "incident record"
6
6
  - "post mortem"
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rihal-index-docs
3
- description: 'Generates or updates an index.md to reference all docs in the folder. Use if user requests to create or update an index of all files in a specific folder'
3
+ description: "Generates or updates an index.md to reference all docs in the folder."
4
4
  triggers:
5
5
  - "index docs"
6
6
  ---
@@ -6,15 +6,32 @@ description: >
6
6
  findings and one-line fix suggestions. Activates when the user says
7
7
  "audit memory bank", "check memory bank", "/rcode:memory-audit",
8
8
  "memory bank ka audit", "find stale entries", "is my memory bank healthy".
9
+ Optional --fix flag patches trivial items (typos, stale dates, broken paths)
10
+ atomically; non-trivial findings always report-only.
9
11
  Do NOT use for: bootstrap (use rcode-memory-init), surgical updates
10
12
  (use rcode-memory-update), or distillate regeneration (use rcode-memory-distill).
11
13
  triggers:
14
+ # English
12
15
  - "audit memory bank"
13
16
  - "check memory bank"
14
17
  - "find stale entries"
15
18
  - "is my memory bank healthy"
16
- - "memory bank ka audit"
19
+ - "auto-fix memory bank"
20
+ - "memory bank --fix"
21
+ - "patch trivial memory drift"
17
22
  - "/rcode:memory-audit"
23
+ - "/rihal-memory-audit"
24
+ # Roman Urdu / Hindi
25
+ - "memory bank ka audit"
26
+ - "memory bank ka --fix"
27
+ - "memory check karo"
28
+ - "purani entries dhoondo"
29
+ # Arabic native
30
+ - "افحص بنك الذاكرة"
31
+ - "تدقيق الذاكرة"
32
+ - "ابحث عن إدخالات قديمة"
33
+ - "هل بنك الذاكرة سليم"
34
+ - "أصلح الذاكرة"
18
35
  user-invocable: true
19
36
  ---
20
37
  @.rihal/references/karpathy-guidelines.md
@@ -11,13 +11,24 @@ description: >
11
11
  distillates (use rcode-memory-distill), or finding stale entries (use
12
12
  rcode-memory-audit).
13
13
  triggers:
14
+ # English
14
15
  - "init memory bank"
15
16
  - "bootstrap memory"
16
17
  - "set up memory bank"
17
18
  - "create memory bank"
18
19
  - "memory bank initialise"
19
- - "memory bank kaise banayen"
20
20
  - "/rcode:memory-init"
21
+ - "/rihal-memory-init"
22
+ # Roman Urdu / Hindi
23
+ - "memory bank kaise banayen"
24
+ - "memory bank banao"
25
+ - "memory bank shuru karo"
26
+ - "memory init karo"
27
+ # Arabic native
28
+ - "هيّئ ذاكرة المشروع"
29
+ - "أنشئ بنك الذاكرة"
30
+ - "ابدأ ذاكرة ريحال"
31
+ - "إعداد بنك الذاكرة"
21
32
  user-invocable: true
22
33
  ---
23
34
  @.rihal/references/karpathy-guidelines.md
@@ -54,6 +65,7 @@ Files seeded from your answers:
54
65
 
55
66
  Files still empty (fill as you go):
56
67
  • project/glossary.md
68
+ • project/design-system.md — visual tokens + components (read by ui-phase / frontend-design)
57
69
  • people/team.md
58
70
  • change-records/
59
71
 
@@ -11,13 +11,25 @@ description: >
11
11
  (use rcode-memory-init), regenerating distillates (use rcode-memory-distill),
12
12
  or general note-taking (use the existing rihal-note workflow).
13
13
  triggers:
14
+ # English
14
15
  - "remember this decision"
15
16
  - "log this decision"
16
17
  - "add this to memory bank"
17
18
  - "update memory bank"
18
19
  - "save this to memory"
19
- - "yeh memory mein add karo"
20
20
  - "/rcode:memory-update"
21
+ - "/rihal-memory-update"
22
+ # Roman Urdu / Hindi
23
+ - "yeh memory mein add karo"
24
+ - "memory mein save karo"
25
+ - "yeh decision yaad rakho"
26
+ - "memory bank update karo"
27
+ # Arabic native
28
+ - "احفظ هذا القرار"
29
+ - "أضف إلى الذاكرة"
30
+ - "تذكّر هذا"
31
+ - "حدّث بنك الذاكرة"
32
+ - "سجّل هذا القرار"
21
33
  user-invocable: true
22
34
  ---
23
35
  @.rihal/references/karpathy-guidelines.md
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rihal-mvp-graduate
3
- description: Move an MVP to production-grade infrastructure incrementally. Use when an MVP has shipped, has real users, and "the next round of features" is hitting walls — flaky deploys, no observability, manual ops, hand-rolled auth. Specifically addresses Rihal's "MVPs delivered, hard to revamp" pain. Companion to rihal-migrate (the engineering skill); this one is the strategic / sequenced version specifically scoped to MVP→prod.
3
+ description: Move an MVP to production-grade infrastructure incrementally.
4
4
  triggers:
5
5
  - "graduate this mvp"
6
6
  - "mvp to prod plan"
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rihal-ocr-consistency
3
- description: OCR pipeline determinism + ground-truth validation. Use when running an OCR pipeline (text extraction from PDFs, scanned documents, government forms) and seeing inconsistent output across runs, language-routing mistakes, or accuracy regressions. Specifically encodes Rihal's OCR pain — Arabic/English routing failures, Triton inconsistencies, missing ground-truth checks.
3
+ description: OCR pipeline determinism + ground-truth validation.
4
4
  triggers:
5
5
  - "ocr inconsistency"
6
6
  - "ocr pipeline"
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rihal-rebrand
3
- description: Stack-wide rebranding migration — refs, assets, copy, env vars, docs, redirects, package names. Use when a project's brand changes mid-flight and the rename has to ripple through dozens of files without breaking anything. Specifically encodes the Rihal "had to do complete rebranding" pain — the rename touched 100+ files and broke 3 deploys before we got it right.
3
+ description: Stack-wide rebranding migration — refs, assets, copy, env vars, docs, redirects, package names.
4
4
  triggers:
5
5
  - "rebrand"
6
6
  - "stack-wide rename"