mgocbr3/world-of-aphasya / .agents/skills/woc-feature-plan
woc-feature-plan
VerifiedPlan a large or multi-session World of ClaudeCraft feature as architecture-aligned vertical slices with explicit decisions, verification, and handoff state. Use when the user requests a phased implementation plan, planning packet, session breakdown, or scalable approach before implementation.
Feature Plan
Create the smallest planning artifact that makes a large feature safe to execute across sessions.
Research before planning
- Read the root and relevant local
CLAUDE.mdfiles. - Run
git status --shortand preserve unrelated work. - Inspect production paths, tests, module seams, and relevant project documentation.
- Use bounded parallel exploration for independent subsystems.
- Fetch current official documentation for version-sensitive external interfaces.
- When work adds or changes SQL, a database call site, stored-data growth, scheduled database
work, pool sizing or admission, transaction or lock scope, or timeout policy; a database
driver/dependency version, or PostgreSQL engine/resource/configuration/topology, use
woc_database_performancefor a read-only scaling pass.
Do not create planning files until the goal, scope, and important constraints are understood. Ask the user when a choice would materially change architecture or product behavior.
Define the change
Record current behavior and ownership, desired behavior and acceptance criteria, affected systems and platforms, constraining invariants, decisions already made, truly blocking open decisions, and compatibility, migration, localization, privacy, security, database performance, and testing implications. For database-backed work, record expected query frequency and cardinality, the index/cache/pagination strategy, pool and lock impact, version-sensitive timeout/planner assumptions, and the measured evidence the implementation must produce. Reference canonical instructions instead of copying them.
Build vertical phases
Prefer phases that deliver a testable behavior slice. Each phase states:
- Outcome and explicit scope.
- Expected modules or seams.
- Tests to add or update.
- Validation commands and manual verification.
- Exit criteria.
- State needed by the next phase.
Keep a phase small enough for one focused session when practical. Do not isolate documentation that belongs beside its implementation.
Persist only useful state
If the user requests planning files, use a minimal packet:
implementation-plan.mdfor architecture, decisions, phases, and completion criteria.progress.mdfor verified phase status.state.mdfor the exact resume point, blocker, and next action.
Add per-phase files only when a phase needs substantial independent detail. Starter prompts must be model-neutral and include the goal, relevant files, canonical constraints, authorized actions, checks, and handoff. Do not pin a model or effort.
Planning does not authorize implementation, commits, pushes, issues, or pull requests.
Do not modify CLAUDE.md or .claude/** as Codex support work.
Return the phases, unresolved decisions, risk areas, and recommended first executable step.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 119k | Updated | Claude CodeCodex | Verified | Install |
| 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: 118k | Updated | Claude CodeCodex | Verified | Install |
| 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: 108k | Updated | Claude CodeCodex | Verified | Install |
| 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: 108k | Updated | Claude CodeCodex | Verified | Install |