From 2e18a66a7781fd4069826fb23c700903a2a3050b Mon Sep 17 00:00:00 2001 From: Julian Lechner Date: Thu, 24 Sep 2026 19:11:21 +0200 Subject: [PATCH] docs(skill): clarify planning skill triggers --- .../planning/implementation-planner/SKILL.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/shared/skills/planning/implementation-planner/SKILL.md b/shared/skills/planning/implementation-planner/SKILL.md index 31be6ba..c55b102 100644 --- a/shared/skills/planning/implementation-planner/SKILL.md +++ b/shared/skills/planning/implementation-planner/SKILL.md @@ -1,12 +1,19 @@ --- name: implementation-planner -description: Create a concise plan for implementing an understood change. +description: Use when requirements are understood but implementation needs multiple dependent steps, affected areas, risk handling, or coordinated verification. Produce a plan without making the changes. --- # Implementation Planner -Use before implementation when a change has multiple meaningful steps. +Use when an understood change has multiple dependent steps or meaningful coordination risk. -Identify the goal, affected areas, sequence, risks, and verification. +## Workflow -Return a short actionable plan. Do not implement the change. +1. Restate the intended outcome and acceptance conditions without expanding the request. +2. Identify the files, components, data contracts, or workflows likely to change. Confirm the repository's existing patterns before proposing new structure. +3. Order work by dependency. Keep steps small enough to review and verify independently where possible. +4. Call out decisions that affect compatibility, data, permissions, or external systems. Resolve routine reversible choices using repository conventions. +5. Pair each substantial step with the cheapest useful verification. +6. Keep the plan concise and omit speculative scaffolding, unrelated cleanup, and work that can safely wait. + +Return an actionable sequence with affected areas, risks, and checks. This skill plans only; do not implement the change.