Skip to content

chore(repo): untrack two planning artifacts that rode into main via #11088 - #11272

Closed
yourspraveen wants to merge 1 commit into
diegosouzapw:mainfrom
yourspraveen:chore/remove-stray-planning-artifacts
Closed

yourspraveen wants to merge 1 commit into
diegosouzapw:mainfrom
yourspraveen:chore/remove-stray-planning-artifacts

Conversation

@yourspraveen

Copy link
Copy Markdown
Contributor

What

Removes two tracked planning artifacts from main:

docs/superpowers/plans/2026-08-23-qdrant-configuration-guidance.md
docs/superpowers/specs/2026-08-23-qdrant-configuration-guidance-design.md

Why — main is currently red on check:tracked-artifacts

Not cosmetic. The gate that runs on pre-commit and in CI fails on the current main tip (65e81158a):

[tracked-artifacts] FAIL — 2 forbidden artifact(s) tracked by git:
  ✗ forbidden tracked artifact (docs/superpowers/*): docs/superpowers/plans/2026-08-23-qdrant-configuration-guidance.md
  ✗ forbidden tracked artifact (docs/superpowers/*): docs/superpowers/specs/2026-08-23-qdrant-configuration-guidance-design.md

After this change: [tracked-artifacts] OK — no forbidden artifacts tracked by git.

docs/superpowers/ is already in .gitignore (line 169) — the ignore simply never applied, because the files were tracked before it could matter. tests/unit/build/check-tracked-artifacts.test.ts:111 asserts this exact prefix is flagged, so the gate is behaving correctly; the tree is what is wrong.

How they got there — my PR, my cleanup

They came from #11213 on release/v3.8.50, and 855243ab1 already removed them from that branch. They reached main only through my #11088: the branch was cut from the release line but targeted main, so the squash carried the full release delta — 5,094 files — including these two. Everything else in that delta was already on the release branch and is correct on main; these two were the exception, because the release branch had since deleted them.

This just mirrors on main what 855243ab1 did on the release branch. Per CLAUDE.md, planning artifacts belong in _tasks/superpowers/, not docs/.

Verification

  • npm run check:tracked-artifacts — FAIL before, OK after
  • No code, docs-nav or link references to either file: grep -rn "docs/superpowers" returns only the CLAUDE.md rule text, a quantumPatterns.ts comment pointing at a different (already-untracked) design doc, and the two gate tests
  • Deletion only — nothing else touched

check:tracked-artifacts is red on main: two docs/superpowers/* files are
tracked, which the gate forbids (and .gitignore:169 already covers — the
ignore never applied because they were tracked before it mattered).

They came from diegosouzapw#11213 on release/v3.8.50, were removed there by 855243a,
and reached main only because diegosouzapw#11088 was cut from the release line while
targeting main, so its squash carried the whole delta including these two.
Removing them here mirrors what the release branch already did.

Gate green after removal; the CLAUDE.md rule they violate points planning
artifacts at _tasks/, not docs/.
@diegosouzapw

Copy link
Copy Markdown
Owner

Closing as already-covered: the two docs/superpowers planning files were untracked on release/v3.8.50 by 855243a (fix(dashboard) follow-up to #11228), and they ride to main with the v3.8.50 release squash — at which point main matches your PR exactly. Merging this into main separately would just duplicate the deletion. Thank you @yourspraveen for the clean hygiene catch and for deliberately leaving them out of the #11271 port as well.

@yourspraveen
yourspraveen deleted the chore/remove-stray-planning-artifacts branch October 3, 2026 04: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.

2 participants