help

name

help

description

Interactive orientation for the request-devflow-plan workflow — inspects the current repo (existing plan? documentation base? progress state?) and recommends the exact next command, with a map of the full lifecycle. Use when the user asks how to use request-devflow-plan, where to start, which command to run next, or wants a guided tour. Triggers: help, getting started, where do I start, 怎麼用, 怎麼開始, 教學, 入門.

request-devflow-plan:help

Orient the user in under a minute: inspect the repo, tell them where they are in the lifecycle, and recommend the exact next command. Strictly read-only — never modify anything. Answer in the user's conversation language.

Flow

Step 1 — Inspect (quick, read-only)

• Is there a DevFlow plan folder? (docs/*/ containing a doc-map README beside 00-iron-rules.md) → read its PROGRESS.md and audit-log.md for state
• Is there a documentation base? (docs/SPEC/, docs/diagrams/, docs/SPEC/WORKFLOW.md)
• Is this a git repo at all? Are tests/gates present?

Step 2 — Say where they are, then recommend

State the detected situation in one sentence, then lead with exactly ONE recommended command (full form, actual unit numbers where a plan exists, /clear advisory when it needs a fresh context). Alternatives after it, one line each:

Detected situation	Recommend
No git repo / brand-new idea	initialize the repo first, then /request-devflow-plan:plan
Repo without docs, user wants documentation only	/request-devflow-plan:foundation
Repo (documented or not), user wants planned work	/request-devflow-plan:plan — recon handles a missing foundation via Sprint 0
Plan exists, units unfinished	/request-devflow-plan:kickoff sprint <next unsigned unit> — or continue sprint <n> when one is half-done
All feature units signed off, no audit round yet	/request-devflow-plan:audit (fresh session)
Latest audit round: PASS	/request-devflow-plan:handoff
Latest audit round: FAIL	/request-devflow-plan:plan — remediation mode picks the report up
Small bug, no plan involved	fix it directly, oriented by the foundation docs — no command needed (see the usage guide's bug scenario)

Step 3 — Show the map

Close with a compact lifecycle overview (plan → kickoff/review loop → built-in acceptance audit → PASS / PASS WITH FINDINGS / FAIL routing → handoff), the six commands with one line each, and where the full guides live: docs/USAGE.md and docs/USAGE.zh-TW.md in the plugin repository (https://github.com/Zhen-Bo/request-devflow-plan) — also present in the installed plugin's own folder.

Never

• Modify any file
• Start lifecycle work from here — help orients; the recommended command does the work