build-express

Build Express

Interactive builder loop for rapid, small changes. Delegates each request to a single general sub-agent.

This command ONLY orchestrates. It does NOT implement code.

Parameters

Extract these parameters from the user's input:

Parameter	Required	Default	Description
REQUEST	No	""	Initial development request (may be empty; will prompt if missing)

Environment values (resolve via shell):

• RP1_ROOT: !rp1 agent-tools rp1-root-dir (extract data.root from JSON response)

1. Main Loop

stateDiagram-v2
  [*] --> GetRequest
  GetRequest --> Clarify: vague
  GetRequest --> ScopeCheck: clear
  Clarify --> ScopeCheck: clarified
  ScopeCheck --> Redirect: medium_or_large
  ScopeCheck --> Build: small
  Redirect --> Prompt
  Build --> Prompt
  Prompt --> Commit: user=commit
  Prompt --> Build: user=refine
  Prompt --> GetRequest: user=new
  Prompt --> [*]: user=exit
  Commit --> GetRequest

1.1 Get Request

If REQUEST empty:

{% ask_user "What would you like to build?" %}

1.2 Clarity Check

Super vague (ask for clarification):

• Single word: "refactor", "fix", "improve"
• No actionable target: "make it better"

Clear enough (proceed):

• Specific action + target: "add logout button to navbar"
• Bug description: "fix null error in auth.ts"
• File/component reference: "update UserCard styling"

If vague: ask ONE clarifying question. Do NOT over-interrogate.

1.3 Scope Gate

Before delegating, assess the request:

Factor	Small (proceed)	Medium/Large (redirect)
Files	1-3	>3
Systems	1	>1
Risk	Low	Medium or High
Estimated effort	<2h	>2h

If Medium or Large: Do NOT delegate. Instead output:

## This request is better suited for a structured workflow

**Request**: {summary}
**Why**: {brief reason — e.g. touches multiple systems, high risk, many files}

**Recommended**:
- For medium work (2-8h): `/rp1-dev:build-fast "{REQUEST}"`
- For large work (>8h): `/rp1-dev:build "{feature-id}"`

Then loop to §1.5 (Post-Build Prompt) so the user can submit a smaller request or exit.

1.4 Deploy Builder

Spawn a single general sub-agent to implement the request:

{% dispatch_agent "rp1-dev:express-builder" %} Implement the following change in the codebase:

{REQUEST}

Keep changes minimal and focused. Run any relevant lint/format/test checks after making changes. Do NOT commit. {% enddispatch_agent %}

Wait for completion. Do NOT implement anything yourself.

1.5 Post-Build Prompt

After builder completes:

{% ask_user "What would you like to do next?", options: "Commit & move on", "Refine", "New task (no commit)", "Exit" %}

Option	Action
Commit & move on	Commit current changes (conventional commit), then loop to 1.1
Refine	Ask what to change, re-invoke §1.4 with refinement as REQUEST
New task (no commit)	Loop to 1.1 without committing
Exit	STOP

After a scope redirect (§1.3), show only "New task" and "Exit" options.

1.6 Commit

When user chooses "Commit & move on":

1. Stage all changed files (prefer specific files over git add -A)
2. Generate a concise conventional commit message summarizing the change
3. Create the commit
4. Loop to 1.1 (Get Request)

1.7 New Task

Clear REQUEST, loop to 1.1 (Get Request).

2. Session End

On exit, report tasks completed count.

## Session Summary

**Tasks Completed**: {count}

Express session ended.

3. Orchestrator Rules

YOU MUST:

• Only use user-input and agent-dispatch tools
• Delegate ALL implementation to the sub-agent
• Scope-gate every request before delegating
• Track task count

YOU MUST NOT:

• Read/write/edit any code files
• Load KB files
• Run quality checks
• Make any implementation decisions
• Delegate medium or large scope work