chore: move superpowers specs/plans to planning/

Mirror httpware layout: docs/superpowers/{plans,specs}/ → planning/{plans,specs}/.
Rewrite path references in CLAUDE.md and inside moved files, and drop the now-stale
mkdocs `exclude_docs` entry.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: lesnik512

CLAUDE.md

@@ -4,8 +4,8 @@
 
 This project uses **Superpowers** (brainstorm → plan → TDD → review).
 
-- Brainstorm specs live in `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md`.
-- Implementation plans live in `docs/superpowers/plans/YYYY-MM-DD-<topic>.md`.
+- Brainstorm specs live in `planning/specs/YYYY-MM-DD-<topic>-design.md`.
+- Implementation plans live in `planning/plans/YYYY-MM-DD-<topic>.md`.
 - Use TDD by default: red, green, refactor. Tests before implementation.
 - Use git worktrees for feature isolation (`superpowers:using-git-worktrees`).
 - Use the verification gate before claiming work complete

mkdocs.yml

@@ -2,8 +2,6 @@ site_name: semvertag
 repo_url: https://github.com/modern-python/semvertag
 docs_dir: docs
 edit_uri: edit/main/docs/
-exclude_docs: |
-  superpowers/
 nav:
   - Quick Start: index.md
   - Providers:

docs/superpowers/plans/.gitkeep planning/plans/.gitkeepdocs/superpowers/plans/.gitkeep renamed to planning/plans/.gitkeep

@@ -8,7 +8,7 @@
 
 **Tech Stack:** Python 3.10+, `httpx2`, `pydantic` (already transitive via `pydantic-settings`), `pytest`, `modern-di`, `ty` (type checker), `ruff`, `uv`.
 
-**Spec:** `docs/superpowers/specs/2026-05-31-bmad-to-superpowers-migration-and-httpx2-wrapper-design.md`
+**Spec:** `planning/specs/2026-05-31-bmad-to-superpowers-migration-and-httpx2-wrapper-design.md`
 
 ---
 
@@ -79,7 +79,7 @@ Expected: shows the new commit; `_bmad/` no longer appears in `git ls-files`.
 **Files:**
 - Create: `CLAUDE.md` (repo root)
 
-`docs/superpowers/plans/.gitkeep` already exists (committed during the brainstorm in `37aeb6b`); no work needed there.
+`planning/plans/.gitkeep` already exists (committed during the brainstorm in `37aeb6b`); no work needed there.
 
 - [ ] **Step 1: Write `CLAUDE.md`**
 
@@ -92,8 +92,8 @@ Create `/Users/kevinsmith/src/pypi/autosemver/CLAUDE.md` with this exact content
 
 This project uses **Superpowers** (brainstorm → plan → TDD → review).
 
-- Brainstorm specs live in `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md`.
-- Implementation plans live in `docs/superpowers/plans/YYYY-MM-DD-<topic>.md`.
+- Brainstorm specs live in `planning/specs/YYYY-MM-DD-<topic>-design.md`.
+- Implementation plans live in `planning/plans/YYYY-MM-DD-<topic>.md`.
 - Use TDD by default: red, green, refactor. Tests before implementation.
 - Use git worktrees for feature isolation (`superpowers:using-git-worktrees`).
 - Use the verification gate before claiming work complete
@@ -1365,8 +1365,8 @@ Expected: all green on `main`.
 When all tasks above are done:
 
 - `_bmad/` is gone from the working tree (lives at `_archive/bmad/`).
-- `docs/superpowers/specs/` contains the migration spec.
-- `docs/superpowers/plans/` contains this plan (and `.gitkeep`).
+- `planning/specs/` contains the migration spec.
+- `planning/plans/` contains this plan (and `.gitkeep`).
 - Repo-root `CLAUDE.md` exists and points at the Superpowers flow.
 - `semvertag/providers/_http.py` contains `HttpClient`, used by every method in `gitlab.py` directly or via `_safe_get`.
 - All existing tests pass; no behavior changes to the GitLab provider's external contract.

…erpowers-migration-and-httpx2-wrapper.md …erpowers-migration-and-httpx2-wrapper.mddocs/superpowers/plans/2026-05-31-bmad-to-superpowers-migration-and-httpx2-wrapper.md renamed to planning/plans/2026-05-31-bmad-to-superpowers-migration-and-httpx2-wrapper.md docs/superpowers/plans/2026-05-31-bmad-to-superpowers-migration-and-httpx2-wrapper.md renamed to planning/plans/2026-05-31-bmad-to-superpowers-migration-and-httpx2-wrapper.md

@@ -8,7 +8,7 @@
 
 **Tech Stack:** `pydantic`, `pydantic-settings`. No new deps.
 
-**Spec:** `docs/superpowers/specs/2026-05-31-cli-overlay-simplification-design.md`
+**Spec:** `planning/specs/2026-05-31-cli-overlay-simplification-design.md`
 
 ---
 

…2026-05-31-cli-overlay-simplification.md …2026-05-31-cli-overlay-simplification.mddocs/superpowers/plans/2026-05-31-cli-overlay-simplification.md renamed to planning/plans/2026-05-31-cli-overlay-simplification.md docs/superpowers/plans/2026-05-31-cli-overlay-simplification.md renamed to planning/plans/2026-05-31-cli-overlay-simplification.md

@@ -8,7 +8,7 @@
 
 **Tech Stack:** Python 3.10+, `pytest`, `ty`, `ruff`, `uv`, `just`. Nothing new.
 
-**Spec:** `docs/superpowers/specs/2026-05-31-drop-doctor-design.md`
+**Spec:** `planning/specs/2026-05-31-drop-doctor-design.md`
 
 ---
 
@@ -543,7 +543,7 @@ Dispatch a code-review subagent against the worktree branch. Review scope: the f
 
 Brief the reviewer on:
 - The work is purely deletion; expect no new code.
-- The spec is at `docs/superpowers/specs/2026-05-31-drop-doctor-design.md`.
+- The spec is at `planning/specs/2026-05-31-drop-doctor-design.md`.
 - The Section 2 table of "doctor failure mode → main command equivalent" is the load-bearing assumption; ask them to verify the main command's typed errors really do produce the listed exit codes.
 - Don't re-litigate the decision to remove doctor (already agreed).
 

…erpowers/plans/2026-05-31-drop-doctor.md planning/plans/2026-05-31-drop-doctor.mddocs/superpowers/plans/2026-05-31-drop-doctor.md renamed to planning/plans/2026-05-31-drop-doctor.md docs/superpowers/plans/2026-05-31-drop-doctor.md renamed to planning/plans/2026-05-31-drop-doctor.md

@@ -8,7 +8,7 @@
 
 **Tech Stack:** `modern-di`, `modern-di-typer`, `typer`, `pydantic-settings`, `pytest`, `httpx2`. No new deps.
 
-**Spec:** `docs/superpowers/specs/2026-05-31-ioc-idiomatic-modern-di-typer-design.md`
+**Spec:** `planning/specs/2026-05-31-ioc-idiomatic-modern-di-typer-design.md`
 
 ---
 

…6-05-31-ioc-idiomatic-modern-di-typer.md …6-05-31-ioc-idiomatic-modern-di-typer.mddocs/superpowers/plans/2026-05-31-ioc-idiomatic-modern-di-typer.md renamed to planning/plans/2026-05-31-ioc-idiomatic-modern-di-typer.md docs/superpowers/plans/2026-05-31-ioc-idiomatic-modern-di-typer.md renamed to planning/plans/2026-05-31-ioc-idiomatic-modern-di-typer.md

@@ -8,7 +8,7 @@
 
 **Tech Stack:** `pydantic`, `pydantic-settings`. Both already project deps; no new packages.
 
-**Spec:** `docs/superpowers/specs/2026-05-31-settings-aliaschoices-design.md`
+**Spec:** `planning/specs/2026-05-31-settings-aliaschoices-design.md`
 
 ---
 
@@ -466,7 +466,7 @@ Dispatch a code-review subagent against the worktree branch (2 commits between `
 
 Brief the reviewer on:
 - The work is a refactor: machinery replacement, no behavior change.
-- The spec is at `docs/superpowers/specs/2026-05-31-settings-aliaschoices-design.md`. The "Semantic shift to be aware of" section is the one place behavior changes (both providers' tokens populated even when only one is active); confirm the reviewer accepts this is the intended trade-off.
+- The spec is at `planning/specs/2026-05-31-settings-aliaschoices-design.md`. The "Semantic shift to be aware of" section is the one place behavior changes (both providers' tokens populated even when only one is active); confirm the reviewer accepts this is the intended trade-off.
 - Existing tests in `tests/unit/test_settings.py` should pass unchanged. If they had to be modified, that's a regression.
 - The 6 smoke-test outputs from Task 4 Step 6 are the practical contract.
 

…lans/2026-05-31-settings-aliaschoices.md …lans/2026-05-31-settings-aliaschoices.mddocs/superpowers/plans/2026-05-31-settings-aliaschoices.md renamed to planning/plans/2026-05-31-settings-aliaschoices.md docs/superpowers/plans/2026-05-31-settings-aliaschoices.md renamed to planning/plans/2026-05-31-settings-aliaschoices.md

@@ -8,7 +8,7 @@
 
 **Tech Stack:** Existing — `dataclasses`, `typing.Protocol`, `typing.ClassVar`. No new deps.
 
-**Spec:** `docs/superpowers/specs/2026-05-31-strategy-no-bump-cleanup-design.md`
+**Spec:** `planning/specs/2026-05-31-strategy-no-bump-cleanup-design.md`
 
 ---
 

…s/2026-05-31-strategy-no-bump-cleanup.md …s/2026-05-31-strategy-no-bump-cleanup.mddocs/superpowers/plans/2026-05-31-strategy-no-bump-cleanup.md renamed to planning/plans/2026-05-31-strategy-no-bump-cleanup.md docs/superpowers/plans/2026-05-31-strategy-no-bump-cleanup.md renamed to planning/plans/2026-05-31-strategy-no-bump-cleanup.md

@@ -8,7 +8,7 @@
 
 **Tech Stack:** Existing — `pydantic`, `pydantic-settings`, `modern-di`, `typer`, `httpx2`, `pytest`. No new deps.
 
-**Spec:** `docs/superpowers/specs/2026-05-31-usecase-callable-design.md`
+**Spec:** `planning/specs/2026-05-31-usecase-callable-design.md`
 
 ---