@hanzlaa/rcode 2.1.0

package/rihal/brain/README.md

@@ -0,0 +1,38 @@
+# rihal/brain — The Rihal Context Layer
+
+This directory is populated on install (and on every `/rihal:update`) by `rihal-tools brain pull`. Its job is simple: pull Rihal's institutional knowledge — PR/commit/issue standards, architecture decisions, internal guides — into every Rihalian's project so their AI assistant already knows how Rihal builds.
+
+## Structure
+
+```
+rihal/brain/
+├── sources.yaml           # upstream repo configuration (see below)
+├── rihal-github/          # PR/commit/issue standards from the Rihal GitHub org
+├── rihal-docs/            # architecture, guides, playbooks from the Rihal docs repo
+└── best-practices/        # in-repo best practices, pulled from rihal/skills/_shared/
+```
+
+## Sources
+
+Content is pulled from three kinds of source:
+
+1. **External Rihal repos** — GitHub org + docs repo. URLs are placeholders until M5 / issue #162 lands with the real addresses. Once filled, `brain pull` uses `git` sparse-checkout to fetch only the paths listed in `sources.yaml`.
+2. **Self** — the special `repo: self` entry points back at this repo, so in-tree best-practices land under `rihal/brain/best-practices/` on every install.
+3. **Cached** — fetched content is cached locally with a short TTL (configurable per source, default 6h). `brain pull` respects the cache; pass `--fresh` to force a re-clone.
+
+## Update policy
+
+- Local edits to any file under `rihal/brain/` are **overwritten** on every `/rihal:update`. Rihal Code treats the upstream sources as the single source of truth. If the Rihal standard needs to change, the change happens upstream — then every Rihalian benefits.
+- Per-invocation: `node .rihal/bin/rihal-tools.cjs brain pull`.
+- Per project: runs automatically as part of `npx rihal-code install`.
+
+## Privacy
+
+If any source is private, `brain pull` uses the user's `gh auth` token (set `defaults.private: true` in `sources.yaml`). If `gh auth status` fails, the pull skips that source with a clear message instead of hanging.
+
+## Status — v2.0
+
+- `sources.yaml` is scaffolded with placeholder URLs.
+- `brain pull` subcommand is wired in `rihal/bin/rihal-tools.cjs`.
+- Real URLs arrive with issue #162 (M5).
+- Live MCP replacement lands in v3.0 (issue #163 / design doc at `docs/adr/mcp-design.md`).

package/rihal/brain/best-practices/no-autonomous-bypass.md

@@ -0,0 +1,37 @@
+# No Autonomous-Mode Bypass
+
+This fragment is referenced by every step-file workflow that enforces halt-at-menu. Do not inline its contents into individual step files — reference this file so the rule stays single-sourced.
+
+## The Rule
+
+Step-file skills (`rihal-create-prd`, `rihal-sprint-planning`, `rihal-create-epics-and-stories`, etc.) halt at every menu and wait for user input. **This is invariant.** The agent MUST NOT invent an "autonomous mode", "research mode", or any other self-declared bypass that skips discovery questions.
+
+Phrases like *"just write it autonomously"*, *"create the full thing ready to execute"*, *"skip the questions"*, or *"use research mode"* from the user are **not** authorization to bypass halt. They are signals that the user wants the skill to move efficiently — answer by running the next step's questions compactly, not by skipping them.
+
+## The Only Sanctioned Bypass Paths
+
+There are exactly two ways to legitimately run a skill without halting at menus:
+
+1. **Project-wide:** `.rihal/config.yaml` → `mode: yolo`. The config loader flags `yoloMode=true` in the runtime context; step files check this flag and may auto-advance.
+2. **Per-invocation:** `/rihal:do --auto <question>` on the router. The router sets `autoMode=true` and passes it to the dispatched skill.
+
+If **neither** flag is set, halt is mandatory regardless of what the user's prompt text says.
+
+## Required Behavior When Asked to Bypass Without a Flag
+
+1. Acknowledge the user's intent in one sentence.
+2. Show the current step's menu anyway.
+3. Tell the user the two sanctioned paths (config flag or `--auto`) if they want fully hands-off execution.
+4. Do not generate any output artifact (PRD, sprint plan, roadmap, etc.) until the user either selects a menu option or sets one of the sanctioned flags.
+
+## Anti-Example (What NOT to Do)
+
+> User: *"use rihal research skills and create best PRD ready to execute"*
+>
+> ❌ Agent: *"Switching to autonomous mode — researching the domain and drafting a complete execution-ready PRD."* *(then writes full PRD)*
+
+That response invents a mode that does not exist and violates the halt invariant.
+
+## Correct Response
+
+> ✅ Agent: *"I hear you want the PRD written end-to-end. The halt rule applies unless you set `mode: yolo` in `.rihal/config.yaml` or re-invoke via `/rihal:do --auto`. Here is the step-01 menu — pick Continue and I will drive each step concisely."*

package/rihal/brain/best-practices/research-citation-rule.md

@@ -0,0 +1,39 @@
+# Research & Citation Rule
+
+Referenced by any step-file workflow that writes content derived from external sources (competitor pricing, API tiers, market sizing, benchmark numbers, vendor claims, etc.).
+
+## The Rule
+
+If an output artifact (PRD, research note, architecture doc, roadmap) contains a specific external claim — a price, a percentage, a named competitor feature, an API limit — then **every such claim must be traceable to a `WebFetch` (or equivalent document-fetch) call made in the same session**. `WebSearch` snippets alone are not sufficient evidence because snippets are paraphrased and may be stale.
+
+## What This Means in Practice
+
+Before writing a claim like *"Competitor X costs $12.50/mo"*:
+
+1. Run `WebFetch` on the source URL (not just `WebSearch` for a snippet).
+2. Quote the exact sentence from the fetched content in your internal reasoning.
+3. Include the URL in the citations block of the artifact.
+4. If the URL is paywalled, login-walled, or returns a different claim than expected, drop the number — do not paraphrase from memory or search-result previews.
+
+## The Trap to Avoid
+
+Observed failure pattern (rihal-code session, social-poster-x PRD generation):
+
+- Agent ran two `WebSearch` calls.
+- Agent wrote a PRD citing four specific URLs with specific dollar amounts.
+- Agent never ran `WebFetch` on any of the four URLs.
+- Numbers may be accurate-looking hallucinations.
+
+This pattern is forbidden. A citation block without `WebFetch` evidence is a lie to the reader.
+
+## If the User Is Running Autonomously
+
+`mode: yolo` and `/rihal:do --auto` bypass halt-at-menu, but they do **not** bypass this rule. A fully-autonomous run still has to fetch every cited URL before writing the claim.
+
+## Checklist Before Writing a Citation
+
+- [ ] `WebFetch` was called on this URL in this session.
+- [ ] The fetched content contains the specific number / claim being cited.
+- [ ] The claim in the artifact matches the fetched content verbatim (or is a clearly labeled summary).
+
+If any box is unchecked: remove the claim, replace with *"(needs source)"*, and flag to the user.

package/rihal/brain/best-practices/state-sync-rule.md

@@ -0,0 +1,43 @@
+# State Sync Rule
+
+Referenced by skills that write `ROADMAP.md`, `epics.md`, or sprint artifacts. These artifacts are not authoritative on their own — downstream workflows (`/rihal:status`, `/rihal:progress`, `/rihal:execute`) read `.rihal/state.json`. If you write a planning artifact and skip state sync, the project ends up with two divergent pictures.
+
+## The Rule
+
+Immediately after appending content to any of:
+
+- `.planning/ROADMAP.md` — milestones and phases
+- `.planning/epics.md` — epics and stories
+- `.rihal/phases/{phase}/sprint-{N}.md` — sprint commitments
+
+Call the state-sync helper:
+
+```bash
+node .rihal/bin/rihal-tools.cjs state sync --from-disk
+```
+
+or, for a more targeted write, use the JSON-API helpers exposed by `rihal-tools.cjs`:
+
+```bash
+node .rihal/bin/rihal-tools.cjs state upsert-milestone <json>
+node .rihal/bin/rihal-tools.cjs state upsert-phase <json>
+node .rihal/bin/rihal-tools.cjs state upsert-epic <json>
+```
+
+If `rihal-tools.cjs` does not yet expose the needed subcommand, fall back to `state sync --from-disk` which re-parses `ROADMAP.md` + `epics.md` and rebuilds the relevant sections of `state.json`.
+
+## Verification After Sync
+
+- `node .rihal/bin/rihal-tools.cjs state read` returns a phase count that matches the phase table in `ROADMAP.md`.
+- `/rihal:status` and `/rihal:progress`, run back-to-back, agree on the current milestone name and phase count.
+
+## Why This Matters
+
+Observed failure (rihal-code, social-poster-x install, Apr 2026):
+
+- User ran `/rihal:create-epics-and-stories`.
+- `ROADMAP.md` gained 10 phases; `epics.md` gained 62 stories.
+- `.rihal/state.json` remained at the initial bootstrap with 1 phase.
+- `/rihal:status` showed 1 phase; `/rihal:progress` showed 10.
+
+That divergence is what this rule exists to prevent.

package/rihal/brain/sources.yaml

@@ -0,0 +1,59 @@
+# Rihal Brain — content sources
+#
+# This file lists upstream repositories whose content is pulled into
+# rihal/brain/ on install and on every `/rihal:update`. Anything pulled
+# here ends up in every Rihalian's project context.
+#
+# Repo URLs are placeholders until M5 (issue #162) when Hanzla supplies
+# the real Rihal GitHub org and docs repo addresses. `brain pull` will
+# detect `<PLACEHOLDER>` entries and skip them with a clear message.
+#
+# Real URLs land as part of issue #162. Until then, this file documents
+# the intent and shape of the pipeline.
+
+version: 1
+
+defaults:
+  # Branch to track when no per-source override is set.
+  branch: main
+  # How long before a cached checkout is considered stale and re-cloned.
+  cache_ttl: 6h
+  # Private repos — if true, `brain pull` uses the user's `gh auth` token.
+  # Set to false for public repos (faster, no auth needed).
+  private: true
+
+sources:
+  - name: rihal-github-standards
+    description: >
+      PR, issue, and commit standards for the Rihal GitHub org. Every
+      Rihalian's AI sees these when reviewing or drafting a PR.
+    repo: "<PLACEHOLDER: github.com/rihal-om/???>"
+    branch: main
+    paths:
+      - docs/pr-standards.md
+      - docs/issue-standards.md
+      - docs/commit-standards.md
+      - docs/review-checklist.md
+    dest: rihal/brain/rihal-github/
+
+  - name: rihal-docs
+    description: >
+      Architecture decisions, internal guides, role playbooks. The bulk
+      of the Rihal institutional knowledge lives here.
+    repo: "<PLACEHOLDER: github.com/rihal-om/???>"
+    branch: main
+    paths:
+      - "architecture/**/*.md"
+      - "guides/**/*.md"
+      - "standards/**/*.md"
+      - "playbooks/**/*.md"
+    dest: rihal/brain/rihal-docs/
+
+  - name: rihal-best-practices
+    description: >
+      Hanzla's one-year-of-usage best practices — in-repo, version-
+      controlled alongside the rest of Rihal Code.
+    repo: self
+    paths:
+      - rihal/skills/_shared/**/*.md
+    dest: rihal/brain/best-practices/

package/rihal/commands/add-phase.md

@@ -0,0 +1,18 @@
+---
+name: rihal:add-phase
+description: Execute add-phase workflow
+argument-hint: ""
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Execute add-phase workflow
+</objective>
+
+<execution_context>
+@.rihal/workflows/add-phase.md
+</execution_context>
+
+<process>
+Execute the add-phase workflow from @.rihal/workflows/add-phase.md end-to-end.
+</process>

package/rihal/commands/add-tests.md

@@ -0,0 +1,18 @@
+---
+name: rihal:add-tests
+description: Generate unit and E2E tests for a completed phase based on its SUMMARY.md, CONTEXT.md, and implementation. Classifies ea
+argument-hint: ""
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent
+---
+
+<objective>
+Generate unit and E2E tests for a completed phase based on its SUMMARY.md, CONTEXT.md, and implementation. Classifies ea
+</objective>
+
+<execution_context>
+@.rihal/workflows/add-tests.md
+</execution_context>
+
+<process>
+Execute the add-tests workflow from @.rihal/workflows/add-tests.md end-to-end.
+</process>

package/rihal/commands/add-todo.md

@@ -0,0 +1,8 @@
+---
+name: rihal:add-todo
+description: Capture an idea or task for later work
+argument-hint: "<todo-title>"
+allowed-tools: bash, read, write
+---
+
+@.rihal/workflows/add-todo.md

package/rihal/commands/analyze-dependencies.md

@@ -0,0 +1,11 @@
+---
+name: rihal:analyze-dependencies
+description: Analyze phase dependencies, suggest "Depends on" entries for ROADMAP.md
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Grep
+  - Bash
+---
+
+@.rihal/workflows/analyze-dependencies.md

package/rihal/commands/audit-fix.md

@@ -0,0 +1,14 @@
+---
+name: rihal:audit-fix
+description: Autonomous audit-to-fix pipeline — find issues, classify, fix, test, commit.
+argument-hint: "[--max N] [--severity high|medium|all] [--dry-run] [--source <audit>]"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+
+@.rihal/workflows/audit-fix.md

package/rihal/commands/audit-milestone.md

@@ -0,0 +1,12 @@
+---
+name: rihal:audit-milestone
+description: Cross-phase audit — verify milestone completion against original goals
+argument-hint: "[--strict] [--report]"
+allowed-tools:
+  - Read
+  - Grep
+  - Bash
+  - AskUserQuestion
+---
+
+@.rihal/workflows/audit-milestone.md

package/rihal/commands/audit-uat.md

@@ -0,0 +1,18 @@
+---
+name: rihal:audit-uat
+description: Cross-phase audit of all UAT and verification files. Finds every outstanding item (pending, skipped, blocked, human_need
+argument-hint: ""
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent
+---
+
+<objective>
+Cross-phase audit of all UAT and verification files. Finds every outstanding item (pending, skipped, blocked, human_need
+</objective>
+
+<execution_context>
+@.rihal/workflows/audit-uat.md
+</execution_context>
+
+<process>
+Execute the audit-uat workflow from @.rihal/workflows/audit-uat.md end-to-end.
+</process>

package/rihal/commands/autonomous.md

@@ -0,0 +1,19 @@
+---
+name: rihal:autonomous
+description: Execute remaining phases autonomously with minimal human intervention. Runs plan → execute → verify cycles for unfinished work, pausing at checkpoints and failures.
+argument-hint: "[--from N] [--to M] [--only N] [--interactive]"
+allowed-tools: Read, Bash, Agent, AskUserQuestion
+---
+
+<objective>
+Execute remaining incomplete phases autonomously — plan, execute, verify in a loop, pausing only at checkpoints, failures, or decision gates.
+</objective>
+
+<execution_context>
+@.rihal/workflows/autonomous.md
+</execution_context>
+
+<process>
+Execute the autonomous workflow from @.rihal/workflows/autonomous.md end-to-end.
+Loop through todo phases: spawn rihal-planner if no SPRINT.md, then rihal-executor, handle checkpoints.
+</process>

package/rihal/commands/brainstorm.md

@@ -0,0 +1,11 @@
+---
+name: rihal:brainstorm
+description: Guided brainstorming session — select a method, apply it to your challenge, generate ideas systematically
+argument-hint: "<challenge> [--method=METHOD] [--people=N] [--personas=LIST]"
+allowed-tools:
+  - Read
+  - Bash
+  - AskUserQuestion
+---
+
+@.rihal/workflows/brainstorm.md

package/rihal/commands/chain.md

@@ -0,0 +1,8 @@
+---
+name: rihal:chain
+description: Run a sequential agent pipeline (research → scope → build). Each stage reads the previous stage's artifact.
+argument-hint: "<preset|agent-list> <topic>"
+allowed-tools: Read, Write, Bash, Agent
+---
+
+@.rihal/workflows/chain.md

package/rihal/commands/check-implementation-readiness.md

@@ -0,0 +1,8 @@
+---
+name: rihal:check-implementation-readiness
+description: Verify PRD approved, architecture approved, external deps identified, no blocking assumptions. Returns pass/fail report. Guard in plan.md and execute.md.
+argument-hint: "[--phase <name>]"
+allowed-tools: Read, Bash, Agent
+---
+
+@.rihal/workflows/check-implementation-readiness.md

package/rihal/commands/check-todos.md

@@ -0,0 +1,18 @@
+---
+name: rihal:check-todos
+description: List all pending todos, allow selection, load full context for the selected todo, and route to appropriate action.
+argument-hint: ""
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent
+---
+
+<objective>
+List all pending todos, allow selection, load full context for the selected todo, and route to appropriate action.
+</objective>
+
+<execution_context>
+@.rihal/workflows/check-todos.md
+</execution_context>
+
+<process>
+Execute the check-todos workflow from @.rihal/workflows/check-todos.md end-to-end.
+</process>

package/rihal/commands/cleanup.md

@@ -0,0 +1,18 @@
+---
+name: rihal:cleanup
+description: Execute cleanup workflow
+argument-hint: ""
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent
+---
+
+<objective>
+Execute cleanup workflow
+</objective>
+
+<execution_context>
+@.rihal/workflows/cleanup.md
+</execution_context>
+
+<process>
+Execute the cleanup workflow from @.rihal/workflows/cleanup.md end-to-end.
+</process>

package/rihal/commands/code-review-fix.md

@@ -0,0 +1,14 @@
+---
+name: rihal:code-review-fix
+description: Auto-fix issues found by code review.
+argument-hint: "<phase> [--all] [--auto]"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+
+@.rihal/workflows/code-review-fix.md

package/rihal/commands/code-review.md

@@ -0,0 +1,14 @@
+---
+name: rihal:code-review
+description: Review source files for bugs, security issues, and code quality problems.
+argument-hint: "<phase> [--depth=quick|standard|deep] [--files=file1,file2,...]"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+
+@.rihal/workflows/code-review.md

package/rihal/commands/complete-milestone.md

@@ -0,0 +1,12 @@
+---
+name: rihal:complete-milestone
+description: Archive and reset — move completed milestone to archive and prepare for next cycle
+argument-hint: "[--archive-path=PATH]"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - AskUserQuestion
+---
+
+@.rihal/workflows/complete-milestone.md

package/rihal/commands/config.md

@@ -0,0 +1,8 @@
+---
+name: rihal:config
+description: View or edit Rihal configuration (language, mode, model profile, branching strategy)
+argument-hint: "[show | set <key> <value>]"
+allowed-tools: Read, Bash, AskUserQuestion
+---
+
+@.rihal/workflows/config.md

package/rihal/commands/correct-course.md

@@ -0,0 +1,8 @@
+---
+name: rihal:correct-course
+description: Load original PRD/architecture, compare to current codebase. Classify deviation (scope drift / wrong architecture / missing AC / tech debt). Produce ordered remediation plan + updated story file.
+argument-hint: "[--prd <path>] [--architecture <path>]"
+allowed-tools: Read, Glob, Grep, Bash, Agent
+---
+
+@.rihal/workflows/correct-course.md

package/rihal/commands/council.md

@@ -0,0 +1,25 @@
+---
+name: rihal:council
+description: Convene the Rihal majlis — spawns 3-5 specialist subagents in parallel to answer a strategic question. Agents are picked by keyword scoring.
+argument-hint: "<question> [--full] [--agents=a,b,c] [--explain]"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+
+<objective>
+Convene 3-5 specialist agents in parallel to answer a strategic question. Agents picked by keyword scoring, responses synthesized into actionable decision.
+</objective>
+
+<execution_context>
+@.rihal/workflows/council.md
+</execution_context>
+
+<process>
+Execute the council workflow from @.rihal/workflows/council.md end-to-end.
+Use rihal-tools.cjs classify-question and select-panel to pick agents. Spawn agents in parallel. Synthesize responses.
+</process>

package/rihal/commands/create-epics-and-stories.md

@@ -0,0 +1,8 @@
+---
+name: rihal:create-epics-and-stories
+description: Parse a PRD or project document to generate numbered epic files in .planning/epics/. Each epic contains user stories with acceptance criteria and development notes.
+argument-hint: "<prd-path|project-path> [--prefix <name>]"
+allowed-tools: Read, Write, Glob, Grep, Bash, Agent
+---
+
+@.rihal/workflows/create-epics-and-stories.md

package/rihal/commands/create-story.md

@@ -0,0 +1,8 @@
+---
+name: rihal:create-story
+description: Transform a story from an epic file into a self-contained STORY.md with full AC, dev notes, and implementation guidance. Ready for /rihal:dev-story.
+argument-hint: "<EPIC-file.md> [--story <id>]"
+allowed-tools: Read, Write, Glob, Bash
+---
+
+@.rihal/workflows/create-story.md

package/rihal/commands/dashboard.md

@@ -0,0 +1,10 @@
+---
+name: rihal:dashboard
+description: Start the Diwan view-only dashboard (port 7717) to browse project state, phases, decisions, and council sessions in the browser
+argument-hint: "[--port 7717] [--no-open]"
+allowed-tools:
+  - Bash
+  - Read
+---
+
+@.rihal/workflows/dashboard.md

package/rihal/commands/debug.md

@@ -0,0 +1,8 @@
+---
+name: rihal:debug
+description: Systematically investigate and diagnose issues
+argument-hint: "<issue-description>"
+allowed-tools: task, bash, read, grep, glob
+---
+
+@.rihal/workflows/debug.md

package/rihal/commands/decisions.md

@@ -0,0 +1,10 @@
+---
+name: rihal:decisions
+description: Browse decisions across every Rihal project on this machine — sourced from .rihal/decisions.jsonl
+argument-hint: "[--limit N] [--project <name>] [--since <ISO>] [--this-project]"
+allowed-tools:
+  - Read
+  - Bash
+---
+
+@.rihal/workflows/decisions.md

package/rihal/commands/dev-story.md

@@ -0,0 +1,8 @@
+---
+name: rihal:dev-story
+description: Wrap a STORY.md file for AI-coder execution. Produces explicit file paths, context, and checklist. Gated by checklist-story-draft.md entry.
+argument-hint: "<STORY.md>"
+allowed-tools: Read, Write, Bash, Glob
+---
+
+@.rihal/workflows/dev-story.md

package/rihal/commands/diff.md

@@ -0,0 +1,10 @@
+---
+name: rihal:diff
+description: Show changes to plans and state between commits
+argument-hint: "[--last] [<sha1> <sha2>]"
+allowed-tools:
+  - Read
+  - Bash
+---
+
+@.rihal/workflows/diff.md

package/rihal/commands/discuss-phase-power.md

@@ -0,0 +1,11 @@
+---
+name: rihal:discuss-phase-power
+description: Power variant of discuss-phase — bulk question generation with async UI
+argument-hint: "<phase> [--power]"
+allowed-tools:
+  - Read
+  - Grep
+  - Bash
+---
+
+@.rihal/workflows/discuss-phase-power.md

package/rihal/commands/discuss-phase.md

@@ -0,0 +1,19 @@
+---
+name: rihal:discuss-phase
+description: Gather context through adaptive questioning before sprint planning. Creates CONTEXT.md with decisions, discretion areas, deferred ideas.
+argument-hint: "<phase-number> [--auto] [--chain]"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Gather phase context through adaptive questioning before planning. Produces CONTEXT.md that locks decisions and boundaries for the planner. Use --auto to skip questions, --chain for discuss→plan→execute pipeline.
+</objective>
+
+<execution_context>
+@.rihal/workflows/discuss-phase.md
+</execution_context>
+
+<process>
+Execute the discuss-phase workflow from @.rihal/workflows/discuss-phase.md end-to-end.
+Ask adaptive questions, produce CONTEXT.md with locked decisions and deferred ideas.
+</process>

package/rihal/commands/discuss.md

@@ -0,0 +1,23 @@
+---
+name: rihal:discuss
+description: Quick sync with one Rihal agent. Lighter than /rihal:council — one agent, no cross-talk, optional save.
+argument-hint: "[agent-name] <question>"
+allowed-tools:
+  - Read
+  - Bash
+  - Agent
+  - AskUserQuestion
+---
+
+<objective>
+Quick sync with one Rihal agent — lighter than council. One agent answers, no cross-talk, optional artifact save.
+</objective>
+
+<execution_context>
+@.rihal/workflows/discuss.md
+</execution_context>
+
+<process>
+Execute the discuss workflow from @.rihal/workflows/discuss.md end-to-end.
+Identify the right agent from the question, spawn it, return focused answer.
+</process>