feature-edit
Intent-driven editing of an in-flight feature. The human describes what should now be true; this skill figures out which files and tools to touch and orchestrates the change, including the downstream cascade.
The cascade-owning skill — clarify and refine deliberately stay single-artifact and route multi-artifact propagation here. Mixed mode: the agent proposes an edit plan, the human confirms before any write.
When to use
Any time an existing feature's artifacts must change. checkpoint: null.
Not for: a brand-new capability (discuss); within-one-artifact ambiguity, no behavior change (clarify); validating consistency (consistency-check); cleaning up code (refine).
Workflow
- Resolve + identify the feature — resolve the methodology root + manifest via
${PLUGIN_ROOT}/scripts/dae_resolve.py(seereferences/resolving.md); locate the feature (slug, branch, or searchfeature.mdtitles/outcomes). - Is this actually an edit? — if the intent is a new capability or too big for one feature, surface it and redirect to
discuss. Stop. - Classify the entry artifact — the highest-level artifact the intent directly changes: outcome/scope →
feature.md; a behavior →acs.md; a GWT detail →spec.md; architecture/phasing →plan.md. - Build the edit plan — the cascade runs strictly downstream (
feature.md → acs.md → spec.md → plan.md); upstream problems are surfaced, never auto-propagated. Per downstream artifact, classify by blast radius: small/mechanical → feature-edit edits directly; substantial → invoke the owning skill (discover-acs/atddpluginatddskill /plan) in edit-pass mode. - Present the plan; human confirms — show entry artifact, cascade, and how each step is handled. Nothing is written before confirmation.
- Execute — in cascade order: direct edits and owning-skill invocations; regenerate
.build/spec.jsonafter anyspec.mdchange; re-run affected test streams if code exists. If regeneration reveals an upstream problem, stop and surface it. - Sync — update
progress.md(affected checkpoint rows) and the tracker via the driver. - Handoff — emit a summary.
Handoff
Emit per ${PLUGIN_ROOT}/references/handoff-summary.md. checkpoint: null; artifacts lists every artifact edited. recommended_next: typically "re-run engineer plugin -> consistency-check skill".
References
- Foundation Design — artifact schemas, the IR pipeline (Section 7)
- Discuss & Upstream Funnel — when an "edit" is really a new feature