Skip to content

MVPavan/via / .claude/skills/planning

planning

Verified

Use when settled work needs a durable implementation plan, dependency graph, or workstream decomposition. Skip planning ceremonies for clear bounded tasks.

Planning

Turn settled scope into executable work at the smallest useful scale.

Route

SituationPath
Material behavior unresolvedBrainstorming for those decisions
Clear bounded taskBrief local sequence if useful; continue execution without a plan document
Durable implementation plan requested or needed for handoffElaborate
Approved spec needs phase/stage decompositionDecompose
Standard phase with sufficient roadmap acceptanceExecute from its roadmap row

Reuse recorded approvals. Ask only about material scope, dependency or authority choices that remain open. Planning-only requests authorize planning artifacts, not implementation; when implementation is already authorized, continue to it.

Decompose

Read the governing spec and only relevant project constraints and current Beads state. Confirm approval evidence; if missing, record the settled decision in the spec rather than treating a draft as approved.

Use references/decompose.md for layout, join keys and seeding commands. Reuse an obvious named workstream; ask when the choice is consequential or unclear. Split into demoable phases with checkable exits, flat stages with acceptance, and real dependency edges. Independent subsystems need separate ownership, not necessarily separate specs or an additional interview.

Present consequential structural choices for approval if not already authorized. Then seed epics/stages and render tracking. A single-phase spec may use one epic and an Elaborate plan without creating a workstream. Write later phase plans just in time against the code those phases will encounter.

Elaborate

Use references/plan-format.md for a durable plan. Read the origin, relevant code and tests, and stage acceptance for phase work. Identify ownership boundaries, interfaces, verification and dependencies. List known files; permit implementers to discover internal details within that ownership. Do not invent exact symbols or freeze a file map without evidence.

Every phase plan task names an existing Stage: <epic>.N; every stage has covering tasks. Preserve this mapping because execution uses it to close stages. Mark risky changes test-first or characterization-first as appropriate.

Check requirement coverage, compatibility, unresolved decisions and integration risks. Use independent critique when required by the task or justified by risk, following AGENTS.md; do not require a critic for every plan.

Save phase plans under docs/workstreams/<name>/plans/, standalone plans under docs/plans/, or the supplied path. Put plan: <path> in Beads notes. An epic's --spec-id holds its spec and --design its roadmap, never its plan. Attribute Beads writes with --actor and reuse existing records.

Slicing

Prefer independently verifiable vertical slices. For broad refactors, use expand → migrate → contract with genuine dependencies. If intermediate tasks cannot remain green, name one integration boundary or atomic group explicitly. A plan is ready when an implementer can identify acceptance, ownership and the next ready unit; unresolved material decisions remain visible blockers.

planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 117kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall