Skip to content

chore: track GSD planning docs (un-ignore .planning + docs/superpowers)#168

Merged
HanSur94 merged 1 commit into
mainfrom
chore/track-planning-docs
May 29, 2026
Merged

chore: track GSD planning docs (un-ignore .planning + docs/superpowers)#168
HanSur94 merged 1 commit into
mainfrom
chore/track-planning-docs

Conversation

@HanSur94
Copy link
Copy Markdown
Owner

What & why

.gitignore has been silently swallowing GSD planning docs since #61, which added .planning/, .superpowers/, and docs/superpowers/ as "local workflow artifacts."

The catch: git only ignores untracked files. When that rule landed, 75 .planning files were already tracked, so they kept getting committed — while every planning doc created afterward was hidden. The result in the main checkout:

dir on disk tracked hidden
.planning/ 483 75 408
docs/superpowers/ 1 0 1
.superpowers/ 0 0 0 (empty)

That's ~6.8 MB of planning history (PROJECT.md, MILESTONES.md, config.json, REQUIREMENTS/ROADMAP/STATE, codebase/, debug/, milestones/, research/, and the phases/ + quick/ dirs) that never made it into the repo.

Change

  • Remove the .planning/ and docs/superpowers/ ignore rules.
  • Commit the 409 previously-hidden planning docs (all Markdown/JSON, no binaries, largest file 84 KB).
  • Leave .superpowers/ ignored — it's empty, and is brainstorm scratch rather than durable planning output.

Notes

  • Scanned the added content for secrets (token prefixes, private-key blocks, ANTHROPIC_API_KEY=) — none found.
  • Big diff by file count (410 files) but it's all docs; no source/code touched besides the two .gitignore lines.
  • Going forward, GSD-generated planning docs will show up in git status instead of being silently ignored.

🤖 Generated with Claude Code

PR #61 added `.planning/`, `.superpowers/`, and `docs/superpowers/` to
.gitignore as "local workflow artifacts". But git only ignores untracked
files — 75 `.planning` files were already tracked and kept getting
committed, while every planning doc created afterward was silently
swallowed: 408 files (~6.8 MB) sat on disk but never entered the repo.

Drop the `.planning/` and `docs/superpowers/` ignore rules and commit the
previously-hidden GSD planning docs — PROJECT.md, MILESTONES.md,
config.json, REQUIREMENTS/ROADMAP/STATE, codebase/, debug/, milestones/,
research/, and the phase/quick directories.

`.superpowers/` stays ignored (currently empty).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@HanSur94
Copy link
Copy Markdown
Owner Author

ℹ️ Heads-up: the failing "Example Smoke Tests" check is pre-existing on main, not introduced by this PR.

This change is docs-only (un-ignores .planning/ + docs/superpowers/ and commits the previously-hidden GSD planning docs — no source touched besides two .gitignore lines).

The same workflow is already red on main — including 99d138fa, the exact commit this branch was cut from, plus the two commits before it. The failure is:

example_dock → Tab 2 "Power Systems", tile 1 → Vectors must be the same length.
(examples/01-basics/example_dock.m)

That's an unrelated example/engine bug and is best fixed in its own PR rather than bundled here.

@HanSur94 HanSur94 merged commit 644ab14 into main May 29, 2026
13 of 14 checks passed
@HanSur94 HanSur94 deleted the chore/track-planning-docs branch May 29, 2026 18:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant