@hanzlaa/rcode 3.6.14 → 3.6.16

package/rihal/skills/actions/4-implementation/rihal-dev-story/workflow.md

@@ -3,6 +3,19 @@
 **Goal:** Execute story implementation following a context filled story spec file.
 
 **Your Role:** Developer implementing the story.
+
+## State-sync rule (NO EXCEPTIONS)
+
+After this workflow writes any SUMMARY.md, updates a story status in epics.md, or marks a phase complete:
+
+```bash
+node .rihal/bin/rihal-tools.cjs state sync --from-disk
+```
+
+This keeps `.rihal/state.json` in sync with disk — `/rihal:progress`, `/rihal:status`, and `/rihal:execute` all read state.json. Skipping the sync silently drifts them. See `../../_shared/state-sync-rule.md`.
+
+---
+
 - Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
 - Generate all documents in {document_output_language}
 - Only modify the story file in these areas: Tasks/Subtasks checkboxes, Dev Agent Record (Debug Log, Completion Notes), File List, Change Log, and Status

package/rihal/skills/actions/4-implementation/rihal-qa-generate-e2e-tests/SKILL.md

@@ -15,6 +15,7 @@ triggers:
   - "qa this
   feature"
   - "generate integration tests"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/actions/4-implementation/rihal-retrospective/SKILL.md

@@ -14,6 +14,7 @@ triggers:
   - "sprint retrospective"
   - "review completed work"
   - "extract learnings from this sprint"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/actions/4-implementation/rihal-retrospective/workflow.md

@@ -3,6 +3,18 @@
 **Goal:** Post-epic review to extract lessons and assess success.
 
 **Your Role:** Scrum Master facilitating retrospective.
+
+## State-sync rule (NO EXCEPTIONS)
+
+After this workflow writes any `.planning/` artifact (ROADMAP.md, epics.md, sprint-*.md, SUMMARY.md, etc.) or updates phase/story status:
+
+```bash
+node .rihal/bin/rihal-tools.cjs state sync --from-disk
+```
+
+This keeps `.rihal/state.json` in sync with disk — `/rihal:progress`, `/rihal:status`, and `/rihal:execute` all read state.json. Skipping the sync silently drifts them. See `../../_shared/state-sync-rule.md`.
+
+---
 - No time estimates — NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed.
 - Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
 - Generate all documents in {document_output_language}

package/rihal/skills/actions/4-implementation/rihal-scaffold-project/SKILL.md

@@ -18,6 +18,7 @@ triggers:
   - "create from template"
   - "rihal new project"
   - "start a new rihal project"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/actions/4-implementation/rihal-sprint-planning/SKILL.md

@@ -25,6 +25,7 @@ triggers:
   - "أنشئ خطة السباق"
   - "السباق التالي"
   - "جدولة السبرنت"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/actions/4-implementation/rihal-sprint-planning/workflow.md

@@ -4,6 +4,18 @@
 
 **Your Role:** You are a Scrum Master generating and maintaining sprint tracking. Parse epic files, detect story statuses, and produce a structured sprint-status.yaml.
 
+## State-sync rule (NO EXCEPTIONS)
+
+After this workflow writes any `.planning/` artifact (ROADMAP.md, epics.md, sprint-*.md, SUMMARY.md, etc.) or updates phase/story status:
+
+```bash
+node .rihal/bin/rihal-tools.cjs state sync --from-disk
+```
+
+This keeps `.rihal/state.json` in sync with disk — `/rihal:progress`, `/rihal:status`, and `/rihal:execute` all read state.json. Skipping the sync silently drifts them. See `../../_shared/state-sync-rule.md`.
+
+---
+
 ---
 
 ## CRITICAL RULES (NO EXCEPTIONS)

package/rihal/skills/actions/4-implementation/rihal-sprint-status/SKILL.md

@@ -13,6 +13,7 @@ triggers:
   - "generate status report"
   - "sprint progress"
   - "where are we in the sprint"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/ahmed-hassani-director/SKILL.md

@@ -38,6 +38,7 @@ triggers:
   - "معايير الهندسة"
   - "تنسيق الفرق"
   - "مقاييس التسليم"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/dalil-scout/SKILL.md

@@ -37,6 +37,7 @@ triggers:
   - "استكشف الكود"
   - "خريطة الكود"
   - "ما هو في المستودع"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/fatima-qa/SKILL.md

@@ -39,6 +39,7 @@ triggers:
   - "تغطية الاختبارات"
   - "خطة الاختبار"
   - "ضمان الجودة"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/haitham-frontend/SKILL.md

@@ -39,6 +39,7 @@ triggers:
   - "تصميم RTL"
   - "صفحة Next"
   - "مكون React"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 @.rihal/references/design-tokens.md

package/rihal/skills/agents/hanzla-engineer/SKILL.md

@@ -38,6 +38,7 @@ triggers:
   - "ابني هذه الميزة"
   - "أصلح الخطأ"
   - "إعادة هيكلة"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/hussain-pm/SKILL.md

@@ -40,6 +40,7 @@ triggers:
   - "قصص المستخدم"
   - "معايير القبول"
   - "خارطة المنتج"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/hussain-sm/SKILL.md

@@ -37,6 +37,7 @@ triggers:
   - "مراجعة السباق"
   - "إزالة العوائق"
   - "حالة السباق"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/layla-designer/SKILL.md

@@ -37,6 +37,7 @@ triggers:
   - "مراجعة التصميم"
   - "تجربة الاستخدام"
   - "نظام التصميم"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/majlis-council/SKILL.md

@@ -41,6 +41,7 @@ triggers:
   - "استشارة جماعية"
   - "ما رأي الفريق"
   - "قرار جماعي"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/mariam-marketing/SKILL.md

@@ -41,6 +41,7 @@ triggers:
   - "محتوى تسويقي"
   - "السوق الخليجي"
   - "تحديد الجمهور"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/nasser-eng-manager/SKILL.md

@@ -41,6 +41,7 @@ triggers:
   - "خطة التوظيف"
   - "صحة الفريق"
   - "نمو الموظفين"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/noor-writer/SKILL.md

@@ -39,6 +39,7 @@ triggers:
   - "اكتب README"
   - "دليل المستخدم"
   - "ملاحظات الإصدار"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/raees-orchestrator/SKILL.md

@@ -38,6 +38,7 @@ triggers:
   - "توجيه المهمة"
   - "ترتيب التنفيذ"
   - "من يتولى"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/rihal-cross-platform-auditor/SKILL.md

@@ -26,6 +26,7 @@ not-for:
   - Docker / container portability (use rihal-khalid for infra)
   - browser compatibility (use rihal-haitham)
 allowed-tools: Read, Bash, Write
+user-invocable: true
 ---
 
 ## Overview

package/rihal/skills/agents/rihal-dep-auditor/SKILL.md

@@ -26,6 +26,7 @@ not-for:
   - license compliance audits
   - bundle size analysis (use rihal-perf)
 allowed-tools: Read, Bash, Write
+user-invocable: true
 ---
 
 ## Overview

package/rihal/skills/agents/rihal-deviation-analyzer/SKILL.md

@@ -22,6 +22,7 @@ triggers:
   - "deviation analyzer"
   - "انحراف الخطة"
   - "تحليل الانحراف"
+user-invocable: true
 ---
 @.rihal/references/response-style.md
 

package/rihal/skills/agents/rihal-i18n-auditor/SKILL.md

@@ -27,6 +27,7 @@ not-for:
   - RTL CSS flipping (use rihal-haitham for frontend RTL)
   - content translation (use a human translator)
 allowed-tools: Read, Bash, Write
+user-invocable: true
 ---
 
 ## Overview

package/rihal/skills/agents/rihal-observability-auditor/SKILL.md

@@ -28,6 +28,7 @@ not-for:
   - performance monitoring (use rihal-perf)
   - log aggregation setup (use rihal-khalid)
 allowed-tools: Read, Bash, Write
+user-invocable: true
 ---
 
 ## Overview

package/rihal/skills/agents/sadiq-analyst/SKILL.md

@@ -36,6 +36,7 @@ triggers:
   - "تحليل تنافسي"
   - "استراتيجية المنتج"
   - "ماذا نبني"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/waleed-architect/SKILL.md

@@ -39,6 +39,7 @@ triggers:
   - "اختر التقنية"
   - "قرار معماري"
   - "مراجعة معمارية"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/yousef-backend/SKILL.md

@@ -39,6 +39,7 @@ triggers:
   - "صمم API"
   - "قاعدة البيانات"
   - "خدمة خلفية"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/zahra-branding/SKILL.md

@@ -44,6 +44,7 @@ triggers:
   - "خطوط عربية"
   - "إرشادات العلامة"
   - "صوت العلامة"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/agents/zayd-ml/SKILL.md

@@ -42,6 +42,7 @@ triggers:
   - "نموذج ذكاء اصطناعي"
   - "هندسة الموجهات"
   - "معالجة اللغة العربية"
+user-invocable: true
 ---
 @.rihal/references/karpathy-guidelines.md
 

package/rihal/skills/core/rihal-init/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: rihal-init
 internal: true
-description: "INTERNAL config loader — called by other skills, not by users directly. Loads module config vars from .rihal/. Install puts this in .rihal/skills/, not .claude/skills/."
+description: "INTERNAL config loader for skills. Loads .rihal/ vars; lives in .rihal/skills/ not .claude/skills/."
 argument-hint: "[--module=module_code] [--vars=var1:default1,var2] [--skill-path=/path/to/calling/skill]"
 triggers:
   - "init"

package/rihal/skills/core/rihal-memory-audit/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Audit the Memory Bank for stale entries, contradictions, missing sections,
   and content that should be archived. Produces a report with severity-tagged
   findings and one-line fix suggestions. Activates when the user says
-  "audit memory bank", "check memory bank", "/rcode:memory-audit",
+  "audit memory bank", "check memory bank", "/rihal-memory-audit",
   "memory bank ka audit", "find stale entries", "is my memory bank healthy".
   Optional --fix flag patches trivial items (typos, stale dates, broken paths)
   atomically; non-trivial findings always report-only.
@@ -19,7 +19,7 @@ triggers:
   - "auto-fix memory bank"
   - "memory bank --fix"
   - "patch trivial memory drift"
-  - "/rcode:memory-audit"
+  - "/rihal-memory-audit"
   - "/rihal-memory-audit"
   # Roman Urdu / Hindi
   - "memory bank ka audit"
@@ -72,7 +72,7 @@ CRITICAL (1)
 WARN (3)
   milestones/current.md
     └─ Milestone target close was 2026-02-01 (84 days ago) but file still says "active"
-       Fix: archive via /rcode:memory-update or move to milestones/archive/
+       Fix: archive via /rihal-memory-update or move to milestones/archive/
 
   incidents/known-issues.md
     └─ Issue "SSO Safari 16 fails" — real fix was planned for M2 (closed)
@@ -80,14 +80,14 @@ WARN (3)
 
   distillates/project.distillate.md
     └─ Source digest stale — 4 source files modified since last regenerate
-       Fix: /rcode:memory-distill
+       Fix: /rihal-memory-distill
 
 INFO (2)
   project/glossary.md
     └─ Empty — no terms recorded yet
   people/team.md
     └─ Coverage table contains 3 unfilled cells
-       Fix: /rcode:memory-update with team coverage info
+       Fix: /rihal-memory-update with team coverage info
 ```
 
 ## Examples

package/rihal/skills/core/rihal-memory-distill/SKILL.md

@@ -5,7 +5,7 @@ description: >
   compressions of Memory Bank source files for fast LLM context loading.
   Produces `distillates/project.distillate.md` and `distillates/stack.distillate.md`.
   Activates when the user says "distill memory bank", "regenerate distillates",
-  "refresh distillates", "/rcode:memory-distill", "compress memory bank",
+  "refresh distillates", "/rihal-memory-distill", "compress memory bank",
   "memory bank ko compress karo". Do NOT use for: bootstrap (use rcode-memory-init),
   surgical updates (use rcode-memory-update), or finding stale entries (use
   rcode-memory-audit). For non-Memory-Bank document compression, use the
@@ -16,7 +16,7 @@ triggers:
   - "refresh distillates"
   - "compress memory bank"
   - "memory bank ko compress karo"
-  - "/rcode:memory-distill"
+  - "/rihal-memory-distill"
 user-invocable: false
 ---
 @.rihal/references/karpathy-guidelines.md
@@ -39,7 +39,7 @@ Read the Memory Bank source files and produce two LLM-optimised distillates: a f
    ---
    generated: true
    do-not-edit: true
-   regenerate-with: /rcode:memory-distill
+   regenerate-with: /rihal-memory-distill
    source-digest: <hash>
    generated-at: <ISO datetime>
    source-files: [list of files included]
@@ -69,14 +69,14 @@ Skip notice: source files unchanged since last run — no rewrite was needed.
 ## Examples
 
 **Happy path**
-User: `/rcode:memory-distill`
+User: `/rihal-memory-distill`
 Skill: reads sources, regenerates both distillates, prints summary. ~10 seconds for a typical project.
 
 **No-op skip**
 User runs distill twice in a row without changing source files. Second run reports "source files unchanged" and exits without rewriting.
 
 **Force refresh**
-User: `/rcode:memory-distill --force`
+User: `/rihal-memory-distill --force`
 Skill: regenerates regardless of digest match. Useful when distillate format itself changes.
 
 **Negative — used on non-memory docs**

package/rihal/skills/core/rihal-memory-init/SKILL.md

@@ -5,7 +5,7 @@ description: >
   `rihal/templates/memory/` into `.rihal/memory/`, then asks 5 questions to
   populate the most-used files (stack, current milestone, primary stakeholder).
   Activates when the user says "init memory bank", "bootstrap memory",
-  "set up memory bank", "/rcode:memory-init", "create memory bank",
+  "set up memory bank", "/rihal-memory-init", "create memory bank",
   "memory bank initialise", "memory bank kaise banayen". Do NOT use for:
   updating an existing Memory Bank (use rcode-memory-update), regenerating
   distillates (use rcode-memory-distill), or finding stale entries (use
@@ -17,7 +17,7 @@ triggers:
   - "set up memory bank"
   - "create memory bank"
   - "memory bank initialise"
-  - "/rcode:memory-init"
+  - "/rihal-memory-init"
   - "/rihal-memory-init"
   # Roman Urdu / Hindi
   - "memory bank kaise banayen"
@@ -49,7 +49,7 @@ Initialise the `.rihal/memory/` directory in the current project. Copies the tem
    3. Current milestone name → seeds `milestones/current.md` Milestone Name
    4. Primary external stakeholder (name + role) → seeds `people/stakeholders.md`
    5. Any known production issue today → seeds `incidents/known-issues.md`
-5. **Print the summary.** Show the file tree, where to add more, and recommend running `/rcode:memory-distill` once `project/stack.md` is fleshed out.
+5. **Print the summary.** Show the file tree, where to add more, and recommend running `/rihal-memory-distill` once `project/stack.md` is fleshed out.
 6. **Update `.rihal/state.json`** to record `memory_bank.initialised_at` so the dashboard shows it as live.
 
 ## Output Format
@@ -69,18 +69,18 @@ Files still empty (fill as you go):
   • people/team.md
   • change-records/
 
-Next step: run /rcode:memory-distill to generate fast-load distillates.
+Next step: run /rihal-memory-distill to generate fast-load distillates.
 ```
 
 ## Examples
 
 **Happy path**
-User: `/rcode:memory-init`
+User: `/rihal-memory-init`
 Skill: asks 5 questions, populates files, prints summary, updates state.json. Total time: under two minutes.
 
 **Already initialised**
-User: `/rcode:memory-init` on a project that already has `.rihal/memory/INDEX.md`.
-Skill: refuses to overwrite. Lists files, shows which are still empty, suggests `/rcode:memory-update` for surgical edits.
+User: `/rihal-memory-init` on a project that already has `.rihal/memory/INDEX.md`.
+Skill: refuses to overwrite. Lists files, shows which are still empty, suggests `/rihal-memory-update` for surgical edits.
 
 **Negative — wrong skill**
 User wants to "update the stakeholder list". Do not use this skill. Use `rcode-memory-update`.

package/rihal/skills/core/rihal-memory-update/SKILL.md

@@ -5,7 +5,7 @@ description: >
   Adds an entry to decisions.md, appends a known issue, updates the current
   milestone, or extends the stakeholder list — without rewriting whole files.
   Activates when the user says "remember this decision", "log this decision",
-  "add this to memory bank", "update memory bank", "/rcode:memory-update",
+  "add this to memory bank", "update memory bank", "/rihal-memory-update",
   "save this to memory", "yeh memory mein add karo", or after a council
   session that produced a clear decision. Do NOT use for: initial bootstrap
   (use rcode-memory-init), regenerating distillates (use rcode-memory-distill),
@@ -17,7 +17,7 @@ triggers:
   - "add this to memory bank"
   - "update memory bank"
   - "save this to memory"
-  - "/rcode:memory-update"
+  - "/rihal-memory-update"
   - "/rihal-memory-update"
   # Roman Urdu / Hindi
   - "yeh memory mein add karo"
@@ -53,7 +53,7 @@ Append or update a single Memory Bank file based on the current conversation con
 3. **Append using the file's documented format.** Each Memory Bank file documents its own entry format at the top — follow it exactly.
 4. **Never overwrite.** If the user wants to *change* an existing entry, refuse and direct them to edit the file directly. This skill is append-only for safety.
 5. **Stamp with date** in `YYYY-MM-DD` format.
-6. **Suggest distillate refresh** if the update was substantive (`/rcode:memory-distill`).
+6. **Suggest distillate refresh** if the update was substantive (`/rihal-memory-distill`).
 
 ## Output Format
 
@@ -64,7 +64,7 @@ Append or update a single Memory Bank file based on the current conversation con
   **Decision:** Upgrade primary database to Postgres 16.4.
   **Rationale:** ...
 
-Tip: run /rcode:memory-distill to refresh the project distillate.
+Tip: run /rihal-memory-distill to refresh the project distillate.
 ```
 
 ## Examples

package/rihal/team.yaml

@@ -85,6 +85,20 @@ agents:
       - backlog
     description: Scope, requirements, PRD writing, user stories, and backlog curation.
 
+  - id: rihal-hussain-sm
+    name: Hussain (حسين)
+    skill_path: rihal/skills/agents/hussain-sm
+    role: Scrum Master
+    authority_level: product
+    domain_keywords:
+      - sprint-planning
+      - story-preparation
+      - sprint-status
+      - retrospective
+      - course-correction
+      - agile-ceremonies
+    description: Sprint planning, story preparation, sprint status reporting, retrospectives, and mid-sprint course correction.
+
   - id: rihal-yousef
     name: Yousef (يوسف)
     file_path: rihal/agents/rihal-yousef.md
@@ -272,6 +286,48 @@ agents:
       - migrations
     description: Generalist engineer for implementation tasks spanning frontend and backend. Pairs with Hanzla on complex stories.
 
+  - id: rihal-dalil-scout
+    name: Dalil (دليل)
+    skill_path: rihal/skills/agents/dalil-scout
+    role: Codebase Scout
+    authority_level: analysis
+    domain_keywords:
+      - codebase-discovery
+      - repository-exploration
+      - topic-sweep
+      - architecture-mapping
+      - integrations-audit
+      - project-structure
+    description: Repository discovery, multi-root exploration, focused topic sweeps, and structured codebase documents.
+
+  - id: rihal-raees-orchestrator
+    name: Raees (رئيس)
+    skill_path: rihal/skills/agents/raees-orchestrator
+    role: Project Orchestration Director
+    authority_level: strategic
+    domain_keywords:
+      - orchestration
+      - dispatch
+      - work-routing
+      - phase-sequencing
+      - team-coordination
+      - handoffs
+    description: Dispatches work to the right specialists, sequences phases, identifies parallel vs sequential work, and coordinates handoffs.
+
+  - id: rihal-majlis-council
+    name: Majlis (مجلس)
+    skill_path: rihal/skills/agents/majlis-council
+    role: Multi-Agent Council
+    authority_level: strategic
+    domain_keywords:
+      - council
+      - team-consultation
+      - multi-agent-discussion
+      - crisis-mode
+      - incident-response
+      - cross-domain
+    description: Convenes the Rihal team to discuss any topic, collects perspectives from all relevant specialists, and delivers a synthesised answer with dissent noted.
+
 utility_agents:
   - id: rihal-planner
     name: Rihal Planner