/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:
- If
--track <name>is present and valid (product|feature|sources|iso), record the chosen track. - Otherwise, default to
product. - Drop
--track <name>from$ARGUMENTSso 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.mdfeature→skills/plan/references/feature-flow.mdsources→skills/plan/references/sources-flow.mdiso→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").
Source: hashgraph-online/awesome-codex-plugins → plugins/archcore-ai/plugin/skills/plan/SKILL.md