docs: consolidate plans + specs into top-level project-plan/

Move 120 plan/spec files from docs/superpowers/ to project-plan/ so the
project-planning artifacts are discoverable from the repo root. The
"superpowers" name comes from the Anthropic internal skill that wrote
the plans; outside readers find "project-plan/" self-explanatory.

Migration:
- git mv docs/superpowers/plans  → project-plan/plans
- git mv docs/superpowers/specs  → project-plan/specs
- rmdir docs/superpowers/ (now empty)

Link rewrite (78 markdown files updated):
- "docs/superpowers/<x>"          → "project-plan/<x>"
- "../superpowers/<x>" patterns   → depth-aware new relative path
- Per-file relative paths recomputed via os.path.relpath() so links
  resolve from each file's new location

Index:
- New project-plan/README.md: sub-project table mapping each entry to
  its spec, master plan, phase plans, completion doc, and release tag

Prose:
- README.md repo-map entry updated to project-plan/
- CONTRIBUTING.md "Working with phase plans" section updated

Drive-by fixes (pre-existing date typos in completion docs):
- docs/internal-api-completion.md: 2026-04-27 → 2026-04-28 (spec+plan)
- docs/external-api-completion.md: 2026-04-28 → 2026-04-29 (spec+plan)

Verified: 90 project-plan links across the tree, all resolve.

Author: Moamen Kilany

CHANGELOG.md

@@ -317,7 +317,7 @@ See `docs/foundation-completion.md` for the full list.
 ### Phase summary
 
 The Foundation was built across 20 phases (00-19). Each phase has its own plan under
-`docs/superpowers/plans/2026-04-24-foundation/phase-NN-*.md`. ~30 cross-phase patches
+`project-plan/plans/2026-04-24-foundation/phase-NN-*.md`. ~30 cross-phase patches
 were captured during execution as real tooling quirks; each is documented in its
 commit message.
 

CONTRIBUTING.md

@@ -89,11 +89,11 @@ Suppression of a security tool finding (CodeQL, Semgrep, SonarCloud, Trivy, Depe
 
 ## Working with phase plans
 
-This project follows a brainstorm → spec → plan → execute workflow under `docs/superpowers/`. New planned work goes through:
+This project follows a brainstorm → spec → plan → execute workflow under `project-plan/`. New planned work goes through:
 
 1. A **brainstorm** that explores intent and scope.
-2. A **spec** in `docs/superpowers/specs/` once requirements are clear.
-3. A **plan** in `docs/superpowers/plans/<date>-<slug>/` with one task at a time.
+2. A **spec** in `project-plan/specs/` once requirements are clear.
+3. A **plan** in `project-plan/plans/<date>-<slug>/` with one task at a time.
 4. **Execution** with one commit per task, exact commit messages from the plan.
 
 If you're picking up unfinished work, start by reading the parent plan file and the most recent phase plan.

README.md

@@ -8,7 +8,7 @@ A bilingual (Arabic RTL / English LTR) knowledge hub for the Circular Carbon Eco
 ## Documentation
 
 - [Roadmap](docs/roadmap.md) — sub-project map, status, BRD references.
-- [Foundation design spec](docs/superpowers/specs/2026-04-24-foundation-design.md)
+- [Foundation design spec](project-plan/specs/2026-04-24-foundation-design.md)
 - [Architecture Decision Records](docs/adr/) — 38 ADRs covering Foundation through Sub-5 decisions.
 - [Sub-project briefs](docs/subprojects/)
 - [Requirements traceability](docs/requirements-trace.csv) — BRD section → sub-project mapping.
@@ -98,7 +98,7 @@ docker compose down -v    # destroys all local data
 | `scripts/`           | Repo-wide tooling (`check-contracts-clean.sh`, etc.).                           |
 | `docs/adr/`          | Architecture Decision Records (0001–0018).                                      |
 | `docs/subprojects/`  | Per-sub-project briefs (01–09).                                                 |
-| `docs/superpowers/`  | Specs and phase plans for the brainstorm → spec → plan workflow.                |
+| `project-plan/`      | Specs and phase plans for the brainstorm → spec → plan workflow.                |
 | `.github/workflows/` | CI pipelines: build, test, OpenAPI drift, security scans, SBOM.                 |
 
 ## Architecture Decision Records

deploy/README.md

@@ -68,4 +68,4 @@ Useful for ad-hoc verification without redeploying.
 - [Production deploy runbook](../docs/runbooks/deploy.md)
 - [Rollback runbook](../docs/runbooks/rollback.md) (Phase 02)
 - [Forward-only migrations](../docs/runbooks/migrations.md)
-- [Sub-10b design spec](../docs/superpowers/specs/2026-05-03-sub-10b-design.md)
+- [Sub-10b design spec](../project-plan/specs/2026-05-03-sub-10b-design.md)

docs/admin-cms-completion.md

@@ -2,8 +2,8 @@
 
 **Tag:** `admin-cms-v0.1.0`
 **Date:** 2026-04-30
-**Spec:** [Admin CMS Design Spec](superpowers/specs/2026-04-29-admin-cms-design.md)
-**Plan:** [Admin CMS Implementation Plan](superpowers/plans/2026-04-29-admin-cms.md)
+**Spec:** [Admin CMS Design Spec](../project-plan/specs/2026-04-29-admin-cms-design.md)
+**Plan:** [Admin CMS Implementation Plan](../project-plan/plans/2026-04-29-admin-cms.md)
 
 ## Tooling versions
 

docs/adr/0001-decomposition-9-subprojects.md

@@ -3,7 +3,7 @@
 - **Status:** Accepted
 - **Date:** 2026-04-26
 - **Sub-project owner:** Foundation
-- **Spec ref:** [Foundation §10](../superpowers/specs/2026-04-24-foundation-design.md#10-decomposition-into-sub-projects)
+- **Spec ref:** [Foundation §10](../../project-plan/specs/2026-04-24-foundation-design.md#10-decomposition-into-sub-projects)
 
 ## Context
 
@@ -58,4 +58,4 @@ The full project is decomposed into **nine sub-projects**, each with its own bra
 ## Related
 
 - [`docs/roadmap.md`](../roadmap.md)
-- [`docs/superpowers/specs/2026-04-24-foundation-design.md`](../superpowers/specs/2026-04-24-foundation-design.md) §10
+- [`project-plan/specs/2026-04-24-foundation-design.md`](../../project-plan/specs/2026-04-24-foundation-design.md) §10

docs/adr/0002-angular-over-react.md

@@ -3,7 +3,7 @@
 - **Status:** Accepted
 - **Date:** 2026-04-26
 - **Sub-project owner:** Foundation
-- **Spec ref:** [Foundation §3](../superpowers/specs/2026-04-24-foundation-design.md#3-stack-decisions)
+- **Spec ref:** [Foundation §3](../../project-plan/specs/2026-04-24-foundation-design.md#3-stack-decisions)
 
 ## Context
 

docs/adr/0003-material-bootstrap-grid-dga-tokens.md

@@ -3,7 +3,7 @@
 - **Status:** Accepted
 - **Date:** 2026-04-26
 - **Sub-project owner:** Foundation
-- **Spec ref:** [Foundation §3](../superpowers/specs/2026-04-24-foundation-design.md#3-stack-decisions)
+- **Spec ref:** [Foundation §3](../../project-plan/specs/2026-04-24-foundation-design.md#3-stack-decisions)
 
 ## Context
 

docs/adr/0004-single-repo-backend-frontend.md

@@ -3,7 +3,7 @@
 - **Status:** Accepted
 - **Date:** 2026-04-26
 - **Sub-project owner:** Foundation
-- **Spec ref:** [Foundation §3](../superpowers/specs/2026-04-24-foundation-design.md#3-stack-decisions)
+- **Spec ref:** [Foundation §3](../../project-plan/specs/2026-04-24-foundation-design.md#3-stack-decisions)
 
 ## Context
 

docs/adr/0005-local-first-docker-compose.md

@@ -3,7 +3,7 @@
 - **Status:** Accepted
 - **Date:** 2026-04-26
 - **Sub-project owner:** Foundation
-- **Spec ref:** [Foundation §4.1](../superpowers/specs/2026-04-24-foundation-design.md#4-architecture)
+- **Spec ref:** [Foundation §4.1](../../project-plan/specs/2026-04-24-foundation-design.md#4-architecture)
 
 ## Context