Plan Feature
Own one planning-only workflow from ordered Jira intake through a published canonical
graph plan. Remain the main coordinator; controlled agents are bounded workers.
Required contracts
Before acting, read:
Also follow the runtime-local problem-definition, low-level-design, feature-planner, and
agent-boundary contracts.
Entry
For new work, require one or more supplied Jira keys, allocate one collision-safe
plans/<feature>-feature-workflow-state.json, and init --owner plan-feature through
../_shared/scripts/feature_workflow_state.py. For resume, require the exact state path
and read back its recorded owner and stage. Never scan for a newest run, and never claim
a state the helper reports as owned by build-feature. Enter only on a direct human request under the routing contract's
human front door; refuse invocation by a spawned agent or another skill.
Workflow
- Close one aggregate Jira intake of at most 50 issues. For each state-frontier key,
dispatch a fresh
rocprof-compute-jira-intake-writer / snapshot, record its immutable
file/digest, and let state add only bounded relationship context. Missing supplied
issues block.
- Dispatch one initial questionnaire from the complete snapshot inventory, record it, and
pause for human completion. Resume only by exact state/artifact; focused follow-ups stay
in this same lineage.
- Dispatch one aggregate problem formulation in
formulate, present its returned
candidate for explicit human approval through plan mode, then publish it.
- Dispatch
rocprof-compute-lld-writer / draft from that approved formulation, its
questionnaire, the snapshots, any existing design/*.md by exact path, and the
repository surfaces in scope. Resolve returned questions through grill-me as the
coordinator, present the returned body for explicit human approval through plan mode,
publish it, and record the exact path and digest with set-lld. An lld-current
outcome adopts the declared existing document and publishes nothing.
- Dispatch the feature planner only from that approved formulation and that recorded
design. Record planner questions, apply
grill-me, ask them as the coordinator, record
all answers, and use a fresh draft dispatch.
- Require one parser-valid 1–9 package DAG of thin vertical slices: stable
WPn
identities, each package's declared behaviors delivered end-to-end by it alone,
interface contracts copied unchanged from the approved design with one provider per
name and every consumer depending on its provider, global path ownership, exactly one
final-integration package, an optional first kind: "interface" package that claims no
behavior, package RED and verbatim blind GREEN, restack/stack data, terminal review,
and stacked-PR publication data.
- Prepare and persist its exact pending chunks/digest, display those bytes, and obtain
explicit human approval. Record the approval receipt, run receipt-bound publication,
verify the sole canonical plan and digest, and record it.
- Stop at released
plan_ready. Return exact state/plan paths, stage/digests, Jira
closure, approver/time, and recommend a later explicit implement-feature invocation.
Never enter package execution, create branches, push, create a PR, or invoke another
public feature skill.
Resources
- REFERENCE.md — intake, graph, approval, and artifact checks.
- EXAMPLES.md — aggregate intake, pauses, resume, and routing.
- writing style — normative prose rules and the pre-save self-check for
every human-read artifact this skill produces.
1---2name: plan-feature3description: Creates and publishes one approved executable rocprof-compute graph plan from a bounded aggregate Jira closure, through controlled questionnaire, formulation, approved low-level design, planner questions, and receipt-bound publication. Use for executable planning-only requests, literal `$plan-feature`, or exact active plan-feature state. Stops at a released `plan_ready` state and recommends `implement-feature`. Human-invoked only.4---56# Plan Feature78Own one planning-only workflow from ordered Jira intake through a published canonical9graph plan. Remain the main coordinator; controlled agents are bounded workers.1011## Required contracts1213Before acting, read:1415- [`FEATURE-WORKFLOW-ROUTING.md`](../_shared/FEATURE-WORKFLOW-ROUTING.md);16- [`FEATURE-WORKFLOW-STATE.md`](../_shared/FEATURE-WORKFLOW-STATE.md); and17- [`FEATURE-PLANNING-CONTRACT.md`](../_shared/FEATURE-PLANNING-CONTRACT.md).1819Also follow the runtime-local problem-definition, low-level-design, feature-planner, and20agent-boundary contracts.2122## Entry2324For new work, require one or more supplied Jira keys, allocate one collision-safe25`plans/<feature>-feature-workflow-state.json`, and `init --owner plan-feature` through26`../_shared/scripts/feature_workflow_state.py`. For resume, require the exact state path27and read back its recorded `owner` and stage. Never scan for a newest run, and never claim28a state the helper reports as owned by `build-feature`. Enter only on a direct human request under the routing contract's29human front door; refuse invocation by a spawned agent or another skill.3031## Workflow32331. Close one aggregate Jira intake of at most 50 issues. For each state-frontier key,34 dispatch a fresh `rocprof-compute-jira-intake-writer` / `snapshot`, record its immutable35 file/digest, and let state add only bounded relationship context. Missing supplied36 issues block.372. Dispatch one initial questionnaire from the complete snapshot inventory, record it, and38 pause for human completion. Resume only by exact state/artifact; focused follow-ups stay39 in this same lineage.403. Dispatch one aggregate problem formulation in `formulate`, present its returned41 candidate for explicit human approval through plan mode, then `publish` it.424. Dispatch `rocprof-compute-lld-writer` / `draft` from that approved formulation, its43 questionnaire, the snapshots, any existing `design/*.md` by exact path, and the44 repository surfaces in scope. Resolve returned questions through `grill-me` as the45 coordinator, present the returned body for explicit human approval through plan mode,46 `publish` it, and record the exact path and digest with `set-lld`. An `lld-current`47 outcome adopts the declared existing document and publishes nothing.485. Dispatch the feature planner only from that approved formulation and that recorded49 design. Record planner questions, apply `grill-me`, ask them as the coordinator, record50 all answers, and use a fresh draft dispatch.516. Require one parser-valid 1–9 package DAG of thin vertical slices: stable `WPn`52 identities, each package's declared behaviors delivered end-to-end by it alone,53 interface contracts copied unchanged from the approved design with one provider per54 name and every consumer depending on its provider, global path ownership, exactly one55 final-integration package, an optional first `kind: "interface"` package that claims no56 behavior, package RED and verbatim blind GREEN, restack/stack data, terminal review,57 and stacked-PR publication data.587. Prepare and persist its exact pending chunks/digest, display those bytes, and obtain59 explicit human approval. Record the approval receipt, run receipt-bound publication,60 verify the sole canonical plan and digest, and record it.618. Stop at released `plan_ready`. Return exact state/plan paths, stage/digests, Jira62 closure, approver/time, and recommend a later explicit `implement-feature` invocation.6364Never enter package execution, create branches, push, create a PR, or invoke another65public feature skill.6667## Resources6869- [REFERENCE.md](REFERENCE.md) — intake, graph, approval, and artifact checks.70- [EXAMPLES.md](EXAMPLES.md) — aggregate intake, pauses, resume, and routing.71- [writing style](../_shared/WRITING-STYLE.md) — normative prose rules and the pre-save self-check for72 every human-read artifact this skill produces.