plan

Plan a feature or initiative: default product flow (idea → PRD → plan), feature flow with formal spec + task-type, sources flow (MRD → BRD → URD), or ISO 29148 cascade (BRS → StRS → SyRS → SRS). Use f

SKILL.md

GitHub

/archcore:plan

Plan a feature or initiative. Default is the product flow (idea → PRD → plan); switch with --track:

  • --track product (default) — idea → PRD → plan (lightweight)
  • --track feature — PRD → spec → plan → task-type (formal feature lifecycle)
  • --track sources — MRD → BRD → URD (discovery research)
  • --track iso — BRS → StRS → SyRS → SRS (ISO 29148 cascade for regulated work)

When to use

  • "Plan the auth redesign" → default product flow
  • "Create a feature plan for the API migration" → default
  • "I need market research before we plan" → --track sources
  • "We need a formal feature spec with a repeatable task-type" → --track feature
  • "We're regulated — start the ISO requirements cascade" → --track iso
  • "Just a plan, skip the idea/PRD" → see Step 3 (single-plan shortcut)

Not plan:

  • Recording a decision → /archcore:decide
  • Documenting existing code → /archcore:capture
  • Codifying a team standard → /archcore:decide (offers rule + guide continuation)
  • Reading applicable rules/ADRs/specs before coding → /archcore:context
  • Picking up where work left off → /archcore:context

Routing table

Signal Route Documents
Default — feature or initiative → product flow idea → prd → plan
--track product → product flow idea → prd → plan
--track feature → feature flow prd → spec → plan → task-type
--track sources → sources flow mrd → brd → urd
--track iso → ISO 29148 flow brs → strs → syrs → srs
User says "just a plan" or "only the plan document" → single plan plan only
Ambiguous arguments → ask one question "Full feature plan (idea + PRD + plan) or just a plan document?"

For --track sources and --track iso, the chain may continue into a product or feature flow afterwards — the reference for each track documents the natural follow-ups.

Execution

Content voice: default to architectural prose — decisions, rationale, intent. See skills/_shared/precision-rules.md Rule 6. Code blocks only where the document type requires it (rule, guide, cpat) or the user asks.

Global sources (only when a flow's check-existing surfaces one). If a list_documents / search_documents result has global: true / read_only: true / source_kind: "global", load skills/_shared/globals.md. Create local documents and wire relations to local documents only — never reference a global as a relation endpoint. No global match → proceed unchanged.

Step 1: Resolve track

Parse $ARGUMENTS:

  1. If --track <name> is present and valid (product|feature|sources|iso), record the chosen track.
  2. Otherwise, default to product.
  3. Drop --track <name> from $ARGUMENTS so the remainder is treated as the topic.

Step 2: Read the matching flow reference

Open exactly one reference file based on track:

  • product → skills/plan/references/product-flow.md
  • feature → skills/plan/references/feature-flow.md
  • sources → skills/plan/references/sources-flow.md
  • iso → skills/plan/references/iso-flow.md

Follow the steps in that reference verbatim — they own check-existing, scope determination, per-document elicitation, content composition, and relation wiring.

Step 3: Single-plan shortcut

If the user explicitly said "just a plan" or "only the plan document":

  • Skip the reference. Ask: "What is the goal? What are the key phases and dependencies?"
  • Compose content covering Goal, Tasks (phased), Acceptance Criteria, Dependencies.
  • mcp__archcore__create_document(type="plan").

Step 4: Cross-link

After the chosen flow completes, suggest mcp__archcore__add_relation calls to link the chain into existing ADRs, specs, or related plans.

Result

The matching chain of documents per the chosen track. Single-plan: one plan document. Report: paths, relations, recommended next actions (e.g., "consider creating a spec for the technical contract — run /archcore:decide with 'and formalize the contract' for an ADR-spec-plan cascade").