Skip to content

docs: delete the finished implementation plan - #72

Merged
philoserf merged 1 commit into
mainfrom
docs/delete-finished-plan
Sep 16, 2026
Merged

philoserf merged 1 commit into
mainfrom
docs/delete-finished-plan

Conversation

@philoserf

Copy link
Copy Markdown
Owner

Closes #34. Second of two PRs in milestone 7 — kept separate so a 3,662-line deletion doesn't drown the code sweep in #71.

docs/superpowers/plans/2026-05-01-quill-implementation.md described a build that finished, in terms the code no longer matches — after six milestones, considerably less so than when the issue was filed. Its "REQUIRED SUB-SKILL" preamble was an artifact of the initial build that read as an instruction to anyone who opened it.

The design spec stays. Its non-goals remain the clearest statement of what this app deliberately does not do.

One thing #34 asks for that I did not do

It suggests promoting the spec to docs/SPEC.md so the superpowers/ scaffolding — a plans/ directory with nothing left in it and a specs/ directory with one file — collapses too.

THEORY.md:141 references docs/superpowers/ by path, and that file is frozen until the refactor work is done and it can be regenerated. Moving the spec now would plant a stale reference I'm not able to correct. Leaving the directory where it is keeps that reference true. The promotion is a one-line follow-up whenever THEORY and WALKTHROUGH get regenerated.

CLAUDE.md's "Historical docs" paragraph is reduced accordingly — it stays current because it steers every future session.

bun run check:ci clean.

`docs/superpowers/plans/2026-05-01-quill-implementation.md` was 3,662 lines
describing a build that finished, in terms the code no longer matches — after
six milestones of refactoring, considerably less so than when this was filed.
Its "REQUIRED SUB-SKILL" preamble was an artifact of the initial build that
read as an instruction to anyone opening it.

The design spec stays: its non-goals remain the clearest statement of what this
app deliberately does not do.

#34 also suggests promoting the spec to `docs/SPEC.md` so the `superpowers/`
scaffolding collapses. Not done here, and deliberately: `THEORY.md:141`
references `docs/superpowers/` by path, and that file is frozen until the
refactor work is finished and it can be regenerated. Moving the spec now would
plant a stale reference that cannot be corrected. The promotion is a one-line
follow-up once THEORY and WALKTHROUGH are regenerated.

`CLAUDE.md`'s "Historical docs" paragraph reduced accordingly.

Closes #34

Co-Authored-By: Claude
@philoserf
philoserf merged commit bbbdc79 into main Sep 16, 2026
3 checks passed
@philoserf
philoserf deleted the docs/delete-finished-plan branch September 16, 2026 12:17
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.

The 3,662-line implementation plan describes a build that finished, in terms the code no longer matches

1 participant