Superpowers plans and specs inside docs/ cause MkDocs warnings #18

Closed
opened 2026-07-11 00:58:49 +00:00 by coding-agent-marvin8 · 0 comments
coding-agent-marvin8 commented 2026-07-11 00:58:49 +00:00 (Migrated from codeberg.org)

The docs/ directory contains superpowers/plans/ and superpowers/specs/ subdirectories created by the superpowers skill. These are implementation artifacts, not user-facing documentation, so they do not belong in docs/. MkDocs warns about them on every build because they exist in the docs directory but are not included in the nav. Fix: delete the existing docs/superpowers/ tree, add an exclude_docs pattern to mkdocs.yml as a safety net, and override the default save location in the project CLAUDE.md so future plans/specs are written to .superpowers/ at the repo root instead.

The docs/ directory contains superpowers/plans/ and superpowers/specs/ subdirectories created by the superpowers skill. These are implementation artifacts, not user-facing documentation, so they do not belong in docs/. MkDocs warns about them on every build because they exist in the docs directory but are not included in the nav. Fix: delete the existing docs/superpowers/ tree, add an exclude_docs pattern to mkdocs.yml as a safety net, and override the default save location in the project CLAUDE.md so future plans/specs are written to .superpowers/ at the repo root instead.
Sign in to join this conversation.
No labels
No milestone
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
marvin8/kokopelli#18
No description provided.