@hanzlaa/rcode 3.6.16 → 4.1.0

package/rcode/commands/new-project-research.md

@@ -0,0 +1,18 @@
+---
+name: rcode-new-project-research
+description: Research subcommand for new-project. Deep research phase producing artifacts that feed into requirements and roadmap generation.
+argument-hint: "[--deep] [--domain <domain>]"
+allowed-tools: Read, Write, Bash, Glob, Grep, WebSearch, WebFetch
+---
+
+<objective>
+Execute the research phase of new-project setup: produce research artifacts consumed by requirements and roadmap steps.
+</objective>
+
+<execution_context>
+@.rcode/workflows/new-project-research.md
+</execution_context>
+
+<process>
+Execute the new-project-research subworkflow from @.rcode/workflows/new-project-research.md end-to-end.
+</process>

package/rcode/commands/new-project-roadmap.md

@@ -0,0 +1,18 @@
+---
+name: rcode-new-project-roadmap
+description: Roadmap subcommand for new-project. Generates PROJECT.md requirements, ROADMAP.md, and the Done signoff after setup and optional research.
+argument-hint: "[--from-research]"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Execute the requirements + roadmap phase of new-project: produce PROJECT.md, REQUIREMENTS.md, and ROADMAP.md.
+</objective>
+
+<execution_context>
+@.rcode/workflows/new-project-roadmap.md
+</execution_context>
+
+<process>
+Execute the new-project-roadmap subworkflow from @.rcode/workflows/new-project-roadmap.md end-to-end.
+</process>

package/rcode/commands/new-project.md

@@ -0,0 +1,13 @@
+---
+name: rcode-new-project
+description: Initialize a new project through unified flow — questioning, research, requirements, roadmap
+argument-hint: "[--auto @document.md]"
+allowed-tools:
+  - Read
+  - Bash
+  - Task
+  - AskUserQuestion
+  - Glob
+---
+
+@.rcode/workflows/new-project.md

package/rcode/commands/new-workspace.md

@@ -0,0 +1,12 @@
+---
+name: rcode-new-workspace
+description: Create an isolated workspace for parallel work — separate ROADMAP/STATE with independent tracking
+argument-hint: "<workspace-name> [--from-current]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+
+@.rcode/workflows/new-workspace.md

package/rcode/commands/next.md

@@ -0,0 +1,19 @@
+---
+name: rcode-next
+description: Automatically advance to the next logical step — zero friction, auto-invoke
+argument-hint: "[--force]"
+allowed-tools: Bash, Read, Grep, Glob
+---
+
+<objective>
+Detect current project state and automatically invoke the next logical rcode workflow step. No confirmation — reads state, routes, executes.
+</objective>
+
+<execution_context>
+@.rcode/workflows/next.md
+</execution_context>
+
+<process>
+Execute the next workflow from @.rcode/workflows/next.md end-to-end.
+Detect state, apply safety gates, determine next action, invoke immediately.
+</process>

package/rcode/commands/note.md

@@ -0,0 +1,12 @@
+---
+name: rcode-note
+description: Capture inline notes instantly. Append to a dated note file with YAML frontmatter. No friction, single Write operation.
+argument-hint: "<text> [--global] | list | count"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+
+@.rcode/workflows/note.md

package/rcode/commands/notify-test.md

@@ -0,0 +1,10 @@
+---
+name: rcode-notify-test
+description: Verify configured webhooks (Slack / Discord / MS Teams) by posting a test message
+argument-hint: "[--only slack|discord|teams] [--title \"<t>\"] [--body \"<b>\"]"
+allowed-tools:
+  - Read
+  - Bash
+---
+
+@.rcode/workflows/notify-test.md

package/rcode/commands/pause-work.md

@@ -0,0 +1,8 @@
+---
+name: rcode-pause-work
+description: Capture project state and blocking constraints before pausing work. Creates HANDOFF.json and .continue-here.md for context restoration.
+argument-hint: ""
+allowed-tools: Read, Write, Bash, AskUserQuestion
+---
+
+@.rcode/workflows/pause-work.md

package/rcode/commands/phase.md

@@ -0,0 +1,11 @@
+---
+name: rcode-phase
+description: Phase CRUD — add (default), insert decimal, or remove. Unified entry replacing /rcode-add-phase, /rcode-insert-phase, /rcode-remove-phase.
+argument-hint: "[name] [--insert <after>] [--remove <id>]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+@.rcode/workflows/phase.md

package/rcode/commands/plan-milestone-gaps.md

@@ -0,0 +1,18 @@
+---
+name: rcode-plan-milestone-gaps
+description: Create all phases necessary to close gaps identified by `/rcode-audit-milestone`. Reads MILESTONE-AUDIT.md, groups gaps 
+argument-hint: ""
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent
+---
+
+<objective>
+Create all phases necessary to close gaps identified by `/rcode-audit-milestone`. Reads MILESTONE-AUDIT.md, groups gaps 
+</objective>
+
+<execution_context>
+@.rcode/workflows/plan-milestone-gaps.md
+</execution_context>
+
+<process>
+Execute the plan-milestone-gaps workflow from @.rcode/workflows/plan-milestone-gaps.md end-to-end.
+</process>

package/rcode/commands/plan-milestone.md

@@ -0,0 +1,18 @@
+---
+name: rcode-plan-milestone
+description: Plan all phases in a milestone in parallel dependency waves. Reads ROADMAP.md, groups phases into dependency waves, spawns rcode-planner agents in parallel per wave. Closes #732.
+argument-hint: "[--milestone <name>] [--dry-run] [--skip-research] [--wave N]"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent, TaskCreate, TaskUpdate
+---
+
+<objective>
+Plan all phases for a milestone using parallel dependency-wave execution. Group independent phases into concurrent waves, run rcode-planner for each in parallel.
+</objective>
+
+<execution_context>
+@.rcode/workflows/plan-milestone.md
+</execution_context>
+
+<process>
+Execute the plan-milestone workflow from @.rcode/workflows/plan-milestone.md end-to-end.
+</process>

package/rcode/commands/plan.md

@@ -0,0 +1,19 @@
+---
+name: rcode-plan
+description: Convert council follow-ups or task descriptions into executable SPRINT.md files. Spawns rcode-planner to produce structured plans that /rcode-execute can run.
+argument-hint: "<list | show <id> | <description>> [--phase <name>] [--output <dir>]"
+allowed-tools: Read, Write, Glob, Grep, Bash, Agent
+---
+
+<objective>
+Convert scope or task description into executable SPRINT.md files with story breakdown, dependencies, and acceptance criteria.
+</objective>
+
+<execution_context>
+@.rcode/workflows/plan.md
+</execution_context>
+
+<process>
+Execute the plan workflow from @.rcode/workflows/plan.md end-to-end.
+Spawn rcode-planner to produce SPRINT.md. Run rcode-sprint-checker to verify quality before execution.
+</process>

package/rcode/commands/plant-seed.md

@@ -0,0 +1,18 @@
+---
+name: rcode-plant-seed
+description: Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone
+argument-hint: "<idea>"
+allowed-tools: Read, Write, Bash
+---
+
+<objective>
+Capture a future idea with trigger conditions. Seeds surface automatically when their conditions are met at milestone boundaries.
+</objective>
+
+<execution_context>
+@.rcode/workflows/plant-seed.md
+</execution_context>
+
+<process>
+Execute the plant-seed workflow from @.rcode/workflows/plant-seed.md end-to-end.
+</process>

package/rcode/commands/pr-branch.md

@@ -0,0 +1,18 @@
+---
+name: rcode-pr-branch
+description: "Create a clean PR branch that strips all rcode planning artifacts (.planning/, SPRINT.md, SUMMARY.md, STATE.md). Reviewers see only code changes. Use before /rcode-ship when you want a clean git history in the PR."
+argument-hint: "[<base-branch>]"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Execute pr-branch workflow
+</objective>
+
+<execution_context>
+@.rcode/workflows/pr-branch.md
+</execution_context>
+
+<process>
+Execute the pr-branch workflow from @.rcode/workflows/pr-branch.md end-to-end.
+</process>

package/rcode/commands/prfaq.md

@@ -0,0 +1,15 @@
+---
+name: rcode-prfaq
+description: Working Backwards PRFAQ challenge — stress-test a product concept by writing the press release before building it. Produces a battle-hardened PRFAQ document + PRD distillate.
+argument-hint: "[<idea>] [--headless] [--customer=<persona>] [--problem=<problem>] [--stakes=<why>] [--solution=<concept>]"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - Agent
+  - AskUserQuestion
+  - WebSearch
+  - WebFetch
+---
+
+@.rcode/workflows/prfaq.md

package/rcode/commands/profile-user.md

@@ -0,0 +1,8 @@
+---
+name: rcode-profile-user
+description: Classify developer on 4 dimensions — communication style, autonomy preference, domain depth, and iteration speed. Produces .rcode/USER-PROFILE.md with YAML frontmatter.
+argument-hint: "[--json <json-blob>]"
+allowed-tools: Agent, Read, Write
+---
+
+@.rcode/workflows/profile-user.md

package/rcode/commands/progress.md

@@ -0,0 +1,18 @@
+---
+name: rcode-progress
+description: Alias of /rcode-status --verbose — full project state dashboard with decisions, blockers, and next-step routes
+argument-hint: ""
+allowed-tools: Bash, Read, Grep
+---
+
+<objective>
+Alias of `/rcode-status --verbose`. Produces the verbose project state dashboard — phase, sprint progress, recent decisions, blockers, last council session, and a Next Up route tree.
+</objective>
+
+<execution_context>
+@.rcode/workflows/progress.md
+</execution_context>
+
+<process>
+Execute the progress workflow from @.rcode/workflows/progress.md end-to-end. That workflow delegates to `.rcode/workflows/status.md` in verbose mode — single source of truth via `rcode-tools progress init`.
+</process>

package/rcode/commands/quick.md

@@ -0,0 +1,14 @@
+---
+name: rcode-quick
+description: Execute small ad-hoc tasks with guarantees — planning, execution, optional verification
+argument-hint: "[description] [--full] [--discuss] [--research]"
+allowed-tools:
+  - Read
+  - Bash
+  - Task
+  - Edit
+  - Write
+  - AskUserQuestion
+---
+
+@.rcode/workflows/quick.md

package/rcode/commands/remove-phase.md

@@ -0,0 +1,18 @@
+---
+name: rcode-remove-phase
+description: "Remove an unstarted future phase from ROADMAP.md, delete its directory, and renumber all subsequent phases to maintain a clean sequence. Cannot remove a phase already in progress or completed."
+argument-hint: "<phase-number>"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Execute remove-phase workflow
+</objective>
+
+<execution_context>
+@.rcode/workflows/remove-phase.md
+</execution_context>
+
+<process>
+Execute the remove-phase workflow from @.rcode/workflows/remove-phase.md end-to-end.
+</process>

package/rcode/commands/remove-workspace.md

@@ -0,0 +1,11 @@
+---
+name: rcode-remove-workspace
+description: Remove a workspace and clean up its artifacts — no recovery
+argument-hint: "<workspace-name> [--archive] [--force]"
+allowed-tools:
+  - Read
+  - Bash
+  - AskUserQuestion
+---
+
+@.rcode/workflows/remove-workspace.md

package/rcode/commands/replay.md

@@ -0,0 +1,11 @@
+---
+name: rcode-replay
+description: Re-run a past council session with the same question — fresh panel round, linked to the original
+argument-hint: "<session-path-or-slug> [--agents a,b,c]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+---
+
+@.rcode/workflows/replay.md

package/rcode/commands/rerun.md

@@ -0,0 +1,11 @@
+---
+name: rcode-rerun
+description: Re-execute a phase or plan, resetting its state and creating fresh commits
+argument-hint: <phase-id|plan-id>
+allowed-tools:
+  - Read
+  - Bash
+  - AskUserQuestion
+---
+
+@.rcode/workflows/rerun.md

package/rcode/commands/research-phase.md

@@ -0,0 +1,18 @@
+---
+name: rcode-research-phase
+description: "Research how to implement a phase before planning. Spawns rcode-phase-researcher with phase context. Standalone tool — /rcode-plan already runs this automatically. Use only when you want research without immediately creating a plan."
+argument-hint: "<phase-number>"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Execute research-phase workflow
+</objective>
+
+<execution_context>
+@.rcode/workflows/research-phase.md
+</execution_context>
+
+<process>
+Execute the research-phase workflow from @.rcode/workflows/research-phase.md end-to-end.
+</process>

package/rcode/commands/resume-work.md

@@ -0,0 +1,8 @@
+---
+name: rcode-resume-work
+description: Restore project context and resume work
+argument-hint: ""
+allowed-tools: Bash, Read
+---
+
+@.rcode/workflows/resume-work.md

package/rcode/commands/retrospective.md

@@ -0,0 +1,18 @@
+---
+name: rcode-retrospective
+description: "Run an epic retrospective and produce owned action items."
+argument-hint: "[epic]"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Execute retrospective workflow
+</objective>
+
+<execution_context>
+@.rcode/workflows/retrospective.md
+</execution_context>
+
+<process>
+Execute the retrospective workflow from @.rcode/workflows/retrospective.md end-to-end.
+</process>

package/rcode/commands/review-edge-case-hunter.md

@@ -0,0 +1,18 @@
+---
+name: rcode-review-edge-case-hunter
+description: "Hunt for edge cases and boundary conditions by category and severity before execution."
+argument-hint: "[--phase <n>]"
+allowed-tools: Read, Write, Bash, Glob, Grep, Agent
+---
+
+<objective>
+Execute review-edge-case-hunter workflow
+</objective>
+
+<execution_context>
+@.rcode/workflows/review-edge-case-hunter.md
+</execution_context>
+
+<process>
+Execute the review-edge-case-hunter workflow from @.rcode/workflows/review-edge-case-hunter.md end-to-end.
+</process>

package/rcode/commands/review-fix.md

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

package/rcode/commands/review.md

@@ -0,0 +1,18 @@
+---
+name: rcode-review
+description: Cross-AI peer review — invoke external AI CLIs to independently review phase plans.
+argument-hint: ""
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Agent
+---
+
+<objective>
+Cross-AI peer review — invoke external AI CLIs to independently review phase plans.
+</objective>
+
+<execution_context>
+@.rcode/workflows/review.md
+</execution_context>
+
+<process>
+Execute the review workflow from @.rcode/workflows/review.md end-to-end.
+</process>

package/rcode/commands/scaffold-milestone.md

@@ -0,0 +1,18 @@
+---
+name: rcode-scaffold-milestone
+description: Bulk-create all phase directories for a milestone from a pipe-separated name list or ROADMAP.md planned phases. Closes #731.
+argument-hint: "--names \"Phase Name 1|Phase Name 2|...\" [--start N]"
+allowed-tools: Read, Write, Bash, Glob, Grep
+---
+
+<objective>
+Execute scaffold-milestone workflow
+</objective>
+
+<execution_context>
+@.rcode/workflows/scaffold-milestone.md
+</execution_context>
+
+<process>
+Execute the scaffold-milestone workflow from @.rcode/workflows/scaffold-milestone.md end-to-end.
+</process>

package/rcode/commands/scaffold-project.md

@@ -0,0 +1,18 @@
+---
+name: rcode-scaffold-project
+description: "Scaffold a new project from the official rcode template repo."
+argument-hint: "[project-name]"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Execute scaffold-project workflow
+</objective>
+
+<execution_context>
+@.rcode/workflows/scaffold-project.md
+</execution_context>
+
+<process>
+Execute the scaffold-project workflow from @.rcode/workflows/scaffold-project.md end-to-end.
+</process>

package/rcode/commands/scaffold-skill.md

@@ -0,0 +1,18 @@
+---
+name: rcode-scaffold-skill
+description: "Scaffold a new compliant SKILL.md file for a rcode role. Eliminates the friction of finding the right folder, copying an existing skill, and chasing 5-component compliance. Use when adding a new role-specific skill."
+argument-hint: "--role <role> --name <skill-name>"
+allowed-tools: Read, Write, Bash, Glob, Grep
+---
+
+<objective>
+Execute scaffold-skill workflow
+</objective>
+
+<execution_context>
+@.rcode/workflows/scaffold-skill.md
+</execution_context>
+
+<process>
+Execute the scaffold-skill workflow from @.rcode/workflows/scaffold-skill.md end-to-end.
+</process>

package/rcode/commands/scan.md

@@ -0,0 +1,14 @@
+---
+name: rcode-scan
+description: Rapid codebase assessment — lightweight alternative to map-codebase.
+argument-hint: "[--focus <area>]"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+
+@.rcode/workflows/scan.md

package/rcode/commands/secure-phase.md

@@ -0,0 +1,14 @@
+---
+name: rcode-secure-phase
+description: Retroactively verify threat mitigations for a completed phase.
+argument-hint: "<phase>"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+
+@.rcode/workflows/secure-phase.md

package/rcode/commands/session-report.md

@@ -0,0 +1,10 @@
+---
+name: rcode-session-report
+description: Generate a session report with work summary, token usage estimation, commits, decisions, and open blockers
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Bash
+---
+
+@.rcode/workflows/session-report.md

package/rcode/commands/settings.md

@@ -0,0 +1,8 @@
+---
+name: rcode-settings
+description: View or edit rcode project settings (mode, model_profile, workflow gates, git strategy). Supports show / get / set / interactive modes.
+argument-hint: "[show | get <key> | set <key> <value>]"
+allowed-tools: Read, Write, Bash, AskUserQuestion
+---
+
+@.rcode/workflows/settings.md

package/rcode/commands/ship.md

@@ -0,0 +1,30 @@
+---
+name: rcode-ship
+description: "After a phase is verified, create a PR: push branch, auto-generate PR body from planning artifacts (ROADMAP, VERIFICATION, SUMMARY), and optionally request review. Closes the plan→execute→verify→ship loop."
+argument-hint: "[<phase>] [--draft]"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Ship a completed, verified phase by pushing its feature branch and opening a
+pull request with an auto-generated body drawn from planning artifacts.
+
+**When to use:**
+- You have finished `/rcode-execute <phase>` and `/rcode-verify-phase <phase>` passed
+- You want to open a PR from your feature branch into main/develop
+- You want the PR body auto-filled with phase goal, changes, requirements addressed, and verification status
+
+**When NOT to use:**
+- Publishing a package to npm → use `npm publish` directly
+- Tagging a release → use `git tag` + `git push --tags`
+- You are inside the rcode framework repo itself (no phases exist here)
+- Your project uses `git.branching_strategy: none` and you commit directly to main
+</objective>
+
+<execution_context>
+@.rcode/workflows/ship.md
+</execution_context>
+
+<process>
+Execute the ship workflow from @.rcode/workflows/ship.md end-to-end.
+</process>

package/rcode/commands/show.md

@@ -0,0 +1,10 @@
+---
+name: rcode-show
+description: Print a plan or phase in full with execution status
+argument-hint: <id>
+allowed-tools:
+  - Read
+  - Bash
+---
+
+@.rcode/workflows/show.md

package/rcode/commands/sprint-planning.md

@@ -0,0 +1,20 @@
+---
+name: rcode-sprint-planning
+description: Plan the next sprint — compute capacity, prioritize stories, create SPRINT.md, register in state.
+argument-hint: "[--phase <NN>] [--velocity <points>] [--goal 'Sprint goal']"
+allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+---
+
+<objective>
+Plan a sprint end-to-end: load phase scope, compute capacity from velocity history, curate stories with user, create SPRINT.md, register sprint + stories in state.json, start the sprint.
+</objective>
+
+<execution_context>
+@.rcode/workflows/sprint-planning.md
+</execution_context>
+
+<process>
+Execute the sprint-planning workflow from @.rcode/workflows/sprint-planning.md end-to-end.
+Use rcode-tools.cjs for state operations (sprint add, story add, sprint start, sprint velocity).
+Present story table to user for confirmation before committing to sprint.
+</process>

package/rcode/commands/sprint-status.md

@@ -0,0 +1,21 @@
+---
+name: rcode-sprint-status
+description: Show current sprint progress — stories, points, velocity, burndown. Quick view of where the sprint stands.
+argument-hint: "[--sprint <NN.S>]"
+allowed-tools:
+  - Bash
+  - Read
+---
+
+<objective>
+Display current sprint status board: stories by status, points done vs remaining, velocity comparison, and actionable next-step recommendation.
+</objective>
+
+<execution_context>
+@.rcode/workflows/sprint-status.md
+</execution_context>
+
+<process>
+Execute the sprint-status workflow from @.rcode/workflows/sprint-status.md end-to-end.
+Load sprint data from state.json via rcode-tools.cjs, display compact board, suggest next action.
+</process>