tzachbon/smart-ralph

Communication Style defines concise output rules for agents: short, scannable, actionable. Use it when writing plans, status updates, or task breakdowns that need to be easy to scan in a terminal.

Delegation Principle defines the main agent as a coordinator that parses input, reads context, and delegates all work to subagents. Use it when an agent must avoid direct implementation and route each phase to the right specialist.

Ralph Specum coordinates spec-driven coding phases for Ralph workflows, including triage, research, requirements, design, tasks, and implementation. Use it when explicitly invoking $ralph-specum, asking for autonomous or quick mode, or resuming a named phase.

Ralph Specum Cancel stops a spec execution and can remove spec state or files when explicitly requested. Use it to resolve the target spec, clear execution state, and confirm before deleting directories.

Ralph Specum Design coordinates the design phase for an active spec and delegates all architecture work to an architect-reviewer sub-agent. Use it when explicitly invoking the Ralph design phase for a spec.

Ralph Specum Feedback captures product feedback or bug reports for Ralph Specum. Use it to summarize the issue, collect reproduction details, and draft or submit a GitHub issue when requested.

Ralph Specum Help explains the Ralph Specum surface in Codex and when to use each helper command. Use it when a user explicitly asks for $ralph-specum-help or asks for Ralph Specum command guidance.

Ralph Specum Implement coordinates approved spec tasks by delegating each step to a spec-executor sub-agent. Use it when asked to run implementation for an active spec, resume work, or continue a quick-mode run.

Ralph Specum Index generates deterministic searchable index artifacts for an existing codebase. Use it when explicitly asked to refresh Ralph Specum index files under specs/.index/.

Ralph Specum Refactor delegates spec updates to a refactor-specialist sub-agent after implementation learnings. Use it to revise requirements, design, tasks, and progress notes for an active spec.

Ralph Specum Requirements coordinates the requirements phase for an active spec and delegates the work to a product-manager sub-agent. Use it when explicitly running the Ralph Specum requirements step.

Ralph Specum Research coordinates the research phase of a Ralph spec by delegating to a research analyst sub-agent. Use it when explicitly starting the research step for a spec and preparing approval.

Ralph Specum Start initializes or resumes a spec run, updates the current spec state, and prepares the next step. Use it when starting a new spec or continuing an existing one with Ralph Specum.

Ralph Specum Status reports the active spec, current phase, backlog, approval state, and available artifacts across configured spec roots. Use it when you explicitly ask for Ralph Specum status or active spec progress.

Ralph Specum Switch updates the active spec pointer when explicitly asked to switch specs. It lists available specs, resolves exact names or paths, and summarizes the selected spec state.

Ralph Specum Tasks coordinates the tasks phase for a spec by resolving the active spec, checking required documents, delegating task planning, and updating progress state. Use it when explicitly asked to run the tasks phase in Ralph Specum.

Ralph Specum Triage coordinates an epic into multiple specs by delegating decomposition to a triage analyst. Use it when you need to plan scope, dependencies, and sequencing before implementation.

Smart Ralph defines shared arguments, execution modes, state files, and commit behavior for Ralph plugins. Use it when implementing or running a Ralph plugin that follows the common loop and branch rules.

SpecKit Workflow guides constitution-driven feature development through specify, plan, tasks, and implement phases. Use it to define, organize, and execute features with explicit governance and traceable artifacts.