docs/planning โ
Where new work gets scoped. This folder groups the artifacts that design and plan a project, so a spec and its rollout plan live together.
specs/: design specs (the what and how of a feature or system).plans/: implementation plans, roadmaps, and live working trackers (the when and the steps). A single file may hold a frozen baseline plus a live dashboard; delineate them in section 1.notes/: scratch that does not fit a spec or plan yet.
Renamed from docs/superpowers/ and merged with the former top-level docs/plans/ on 2026-07-13. "Superpowers" was the agent-framework codename, not a description of the contents; the framework's own scratch still lives at .superpowers/. See specs/2026-07-13-agents-config-hierarchy-design.md for the broader agent-config cleanup this was part of.