@hanzlaa/rcode 3.4.29 → 3.4.31

package/AGENTS.md

@@ -24,7 +24,7 @@ If a user says "just keep going" or "don't stop until done", that authorization
 
 - Follow [Conventional Commits](https://www.conventionalcommits.org/) format: `type(scope): subject`
 - Types allowed: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`, `perf`, `revert`
-- Scopes allowed: `agents`, `skills`, `workflows`, `templates`, `dashboard`, `docs`, `config`, `github`, `commands`, `memory`, `brand`, `cli`, `ci`, `release`, `meta`, `tasks`, `migrations`, `refs`, `state`, `hooks`, `install`, `parity`, `triggers`, `dogfood`, `namespace`, `planning`, `insights`, `help`, `roadmap`, `session`, `audits`, `execute`, `executor`, `plan`, `planner`, `readme`, `sync`, `sprint`, `agent-exp`, `extensibility`, `lens-audit`, `tiers`, `build`, `council`, `doctor`, `postinstall`, `progress`, `security`, `tools`, `uninstall`, `update`, `test`, plus numeric phase/sprint scopes (e.g. `docs(15)`, `feat(8.3)`)
+- Scopes allowed: `agents`, `skills`, `workflows`, `templates`, `dashboard`, `docs`, `config`, `github`, `commands`, `memory`, `brand`, `cli`, `ci`, `release`, `meta`, `tasks`, `migrations`, `refs`, `state`, `hooks`, `install`, `parity`, `triggers`, `dogfood`, `namespace`, `planning`, `insights`, `help`, `roadmap`, `session`, `audits`, `execute`, `executor`, `plan`, `planner`, `readme`, `sync`, `sprint`, `agent-exp`, `extensibility`, `lens-audit`, `tiers`, `build`, `council`, `doctor`, `postinstall`, `progress`, `security`, `tools`, `uninstall`, `update`, `test`, `changelog`, `scopes`, plus numeric phase/sprint scopes (e.g. `docs(15)`, `feat(8.3)`)
 - Subject: lowercase first letter, imperative mood, no trailing period, under 72 chars
 - **NEVER add Claude/AI attribution to commit messages.** No "Generated with Claude Code", no "Co-Authored-By: Claude", no "🤖 Generated". The user does not want this.
 - **NEVER use `--no-verify`** to bypass hooks. If hooks fail, fix the underlying issue.

package/CONTRIBUTING.md

@@ -308,6 +308,8 @@ We use [Conventional Commits](https://www.conventionalcommits.org/) format. The
 - `tools` — `rihal/bin/rihal-tools.cjs` subcommands
 - `uninstall` — `cli/uninstall.js` flow
 - `update` — `cli/update.js` flow
+- `changelog` — CHANGELOG.md edits
+- `scopes` — AGENTS.md / CONTRIBUTING.md scope-list maintenance
 - `<phase-id>` — numeric phase scope when committing inside a phase (e.g. `docs(15)`, `feat(8.3)`)
 - `<sprint-id>` — numeric sprint scope inside a phase (e.g. `feat(15.1)`)
 

package/cli/generate-command-skills.cjs

@@ -27,29 +27,30 @@ const fs = require('fs');
 const path = require('path');
 
 /**
- * Curated list of commands that get skill stubs. Not every command
- * deserves a sidebar entry — only the user-facing entry points and
- * lifecycle verbs. Internal sub-commands stay slash-only.
+ * Curated list of commands that get skill stubs.
+ *
+ * Issue #710: sidebar-stub bloat. The picker has a token budget for skill
+ * descriptions; every stub here counts. Pre-#710 this list had 43 entries —
+ * the user hit "491 descriptions dropped" because rcode + plugins blew the
+ * budget. Trimmed to the minimum set users actually pick from the sidebar:
+ * navigation + the verb-style commands they invoke daily.
+ *
+ * Everything else stays reachable via `/` autocomplete (claude-code reads
+ * .claude/commands/ for slash dispatch — sidebar stubs are UX sugar, not
+ * functional). Power users running niche commands like /rihal-prfaq or
+ * /rihal-ui-phase still get them — they just don't show up in the sidebar.
  */
 const SIDEBAR_COMMANDS = new Set([
-  // Navigation & status
-  'do', 'status', 'progress', 'next', 'health',
-  // Core planning & execution
-  'plan', 'execute', 'add-phase', 'discuss-phase', 'complete-milestone',
-  'plan-milestone-gaps', 'autonomous',
-  // Project setup
-  'new-project', 'new-milestone', 'milestone-summary',
-  // Sprint workflow
-  'sprint-planning', 'sprint-status', 'execute-sprint', 'dev-story',
-  'create-story', 'create-epics-and-stories',
-  // Discussion & council
-  'council', 'discuss', 'prfaq',
-  // Quality & review
-  'ship', 'audit', 'verify-phase', 'verify-work', 'review', 'code-review',
-  'feature-drift', 'ui-phase', 'ui-review',
+  // Navigation & status (the daily check-in)
+  'do', 'status', 'next',
+  // Core lifecycle (the workflow loop)
+  'plan', 'execute', 'ship',
+  // Strategic
+  'council',
+  // Quality gate
+  'audit', 'verify-phase',
   // Utility
-  'debug', 'session-report', 'forensics', 'map-codebase', 'quick',
-  'note', 'add-todo', 'check-todos', 'pause-work', 'resume-work',
+  'note',
 ]);
 
 function parseFrontmatter(text) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzlaa/rcode",
-  "version": "3.4.29",
+  "version": "3.4.31",
   "description": "rcode — the memory bank for AI-driven SaaS teams. Persistent project context, distinctive engineering personas, and phase-based workflows. Built by Rihal. Works in Claude Code, Cursor, Gemini, VS Code, and Antigravity.",
   "main": "cli/index.js",
   "bin": {

package/rihal/skills/actions/1-analysis/research/rihal-domain-research/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-domain-research
+internal: true
 description: >
   Conduct industry domain deep-dive research to build subject matter
   expertise on a specific business domain. Activates when the user says

package/rihal/skills/actions/1-analysis/research/rihal-market-research/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-market-research
+internal: true
 description: >
   Analyze market size, competitive landscape, customer needs, and trends for
   a product or industry. Activates when the user says "market research",

package/rihal/skills/actions/1-analysis/research/rihal-technical-research/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-technical-research
+internal: true
 description: >
   Research technical feasibility, architecture options, and implementation
   approaches for a proposed product or feature. Activates when the user says

package/rihal/skills/actions/1-analysis/rihal-document-project/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-document-project
+internal: true
 description: >
   Analyze an existing codebase and produce documentation for both human and
   LLM consumption (brownfield analysis). Activates when the user says

package/rihal/skills/actions/1-analysis/rihal-prfaq/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-prfaq
+internal: true
 description: Working Backwards PRFAQ challenge to forge product concepts.
 triggers:
   - "prfaq"

package/rihal/skills/actions/1-analysis/rihal-product-brief/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-product-brief
+internal: true
 description: >
   Create a product brief through guided discovery or autonomous research.
   Activates when the user says "create a product brief", "write a product

package/rihal/skills/actions/2-plan/rihal-create-epics-and-stories/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-create-epics-and-stories
+internal: true
 description: >
   Break a PRD into epics and user stories that drive development. Activates
   when the user says "create epics", "break this into stories", "generate

package/rihal/skills/actions/2-plan/rihal-create-milestone/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-create-milestone
+internal: true
 description: >
   Design the milestone roadmap (M1..Mn) for a project from an approved PRD.
   Activates when the user says "create milestones", "plan milestones",

package/rihal/skills/actions/2-plan/rihal-create-prd/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-create-prd
+internal: true
 description: >
   Create a new Product Requirements Document from scratch through guided
   facilitation. Activates when the user says "create a PRD", "write product

package/rihal/skills/actions/2-plan/rihal-create-story/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-create-story
+internal: true
 description: >
   Prepare a dev-ready user story with full implementation context. Activates
   when the user says "create the next story", "prepare a story", "create

package/rihal/skills/actions/2-plan/rihal-create-ux-design/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-create-ux-design
+internal: true
 description: >
   Guide through realizing a UX design that informs architecture and
   implementation — user flows, wireframes, design system updates. Activates

package/rihal/skills/actions/2-plan/rihal-edit-prd/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-edit-prd
+internal: true
 description: >
   Update an existing Product Requirements Document with new sections,
   revisions, or clarifications. Activates when the user says "update the

package/rihal/skills/actions/2-plan/rihal-frontend-design/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-frontend-design
+internal: true
 description: >
   Create distinctive, production-grade frontend interfaces with a committed
   aesthetic direction — typography, colour, motion, spatial composition,

package/rihal/skills/actions/2-plan/rihal-validate-prd/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-validate-prd
+internal: true
 description: >
   Validate an existing PRD for comprehensiveness, leanness, organization,
   and internal consistency. Activates when the user says "validate the PRD",

package/rihal/skills/actions/3-solutioning/rihal-check-implementation-readiness/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-check-implementation-readiness
+internal: true
 description: >
   Verify that PRD, UX designs, architecture decisions, and epics/stories are
   all aligned and ready for implementation. Activates when the user says

package/rihal/skills/actions/3-solutioning/rihal-create-architecture/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-create-architecture
+internal: true
 description: >
   Write an Architecture Decision Record (ADR) to lock a significant
   technical decision. Activates when the user says "write an ADR", "create

package/rihal/skills/actions/3-solutioning/rihal-generate-project-context/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-generate-project-context
+internal: true
 description: >
   Generate a project-context.md file that summarizes project standards,
   conventions, tech stack, and key patterns for AI agents to reference.

package/rihal/skills/actions/4-implementation/rihal-browser-verify/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-browser-verify
+internal: true
 description: Use Chrome DevTools MCP to verify browser behaviour — DOM state, console errors, network requests,.
 triggers:
   - "verify in browser"

package/rihal/skills/actions/4-implementation/rihal-checkpoint-preview/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-checkpoint-preview
+internal: true
 description: "LLM-assisted human-in-the-loop review."
 triggers:
   - "checkpoint preview"

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-ci
+internal: true
 description: CI/CD setup and quality gates for the rcode-default stack — GitHub Actions for Node test matrix,.
 triggers:
   - "set up ci"

package/rihal/skills/actions/4-implementation/rihal-code-review/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-code-review
+internal: true
 description: >
   Review code changes using parallel adversarial review layers and produce
   actionable findings. Activates when the user says "review this code", "run

package/rihal/skills/actions/4-implementation/rihal-correct-course/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-correct-course
+internal: true
 description: >
   Course-correct when major change is discovered mid-sprint or
   mid-implementation. Activates when the user says "course correct", "change

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-debug
+internal: true
 description: Root-cause debugging via the scientific method.
 triggers:
   # English

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-dev-story
+internal: true
 description: >
   Execute an approved story file by writing tests and code that fulfill
   every acceptance criterion. Activates when the user says "dev this story",

package/rihal/skills/actions/4-implementation/rihal-git-flow/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-git-flow
+internal: true
 description: Branching, commits, conflicts, parallel work — aligned with the Rihal Epic→Feature→Task hierarchy.
 triggers:
   - "git flow"

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-harden
+internal: true
 description: Security hardening checklist for SaaS applications.
 triggers:
   - "harden this"

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-incremental
+internal: true
 description: Ship code in small, atomic, verifiable steps.
 triggers:
   - "ship incrementally"

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-migrate
+internal: true
 description: Plan and execute the move from MVP to production-grade infrastructure without rewriting from.
 triggers:
   - "graduate the mvp"

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-perf
+internal: true
 description: Performance optimisation for the rcode-default stack — Next.js (LCP / TBT / CLS / hydration),.
 triggers:
   - "optimize performance"

package/rihal/skills/actions/4-implementation/rihal-prove-it/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-prove-it
+internal: true
 description: Test-first development.
 triggers:
   - "prove it"

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-qa-generate-e2e-tests
+internal: true
 description: >
   Generate end-to-end tests for an existing feature using the project's
   standard test framework. Activates when the user says "generate e2e

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-retrospective
+internal: true
 description: >
   Run an epic retrospective that reviews completed work, extracts learnings,
   and produces owned action items. Activates when the user says "run

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-scaffold-project
+internal: true
 description: >
   Scaffold a new project for Rihalians using the official Rihal template repo.
   Activates when the user says "scaffold project", "create project", "new project",

package/rihal/skills/actions/4-implementation/rihal-source-truth/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: rihal-source-truth
+internal: true
 description: Cite official documentation before writing or recommending any framework, library, or API code.
 triggers:
   - "cite the docs"

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-sprint-planning
+internal: true
 description: >
   Generate or update a sprint plan that sequences stories for dev execution.
   Activates when the user says "plan the sprint", "create sprint plan", "run

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-sprint-status
+internal: true
 description: >
   Generate a sprint status report showing progress, blockers, and
   recommended next actions. Activates when the user says "sprint status",

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

@@ -1,5 +1,6 @@
 ---
 name: rihal-trim
+internal: true
 description: Code simplification.
 triggers:
   - "trim this"