Skip to content

docs: point at the design docs, and stop describing Spec Kit - #72

Merged
retr0h merged 2 commits into
mainfrom
docs/point-at-the-design-docs
Oct 1, 2026
Merged

retr0h merged 2 commits into
mainfrom
docs/point-at-the-design-docs

Conversation

@retr0h

@retr0h retr0h commented Oct 1, 2026

Copy link
Copy Markdown
Contributor

Paired with osapi-io/specs#226, which reorganizes the specs repo and removes Spec Kit.

CONTRIBUTING.md and AGENTS.md both said the conventions live in the specs repo "whose .specify/memory/ is the standing record", and both carried a paragraph forbidding superpowers on the grounds that Spec Kit governed specification, planning and implementation.

Neither holds now. That repo is reorganized to components/<name>/ with the docs at the top level of each, and Spec Kit is gone from it, so the prohibition protects nothing and the pointer named a directory that does not exist.

Both files now say the same shorter thing, in the same words as every sister repository:

Design docs. How this repository is built is documented in osapi-io/specs under components/osapi-justfiles/. Read it before changing behaviour, and change it when you do. A design doc kept in this repository goes stale the moment the code moves past it, and nothing catches the drift.

just test passes.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FuKUsHFG1EqZXamffh9M2c

retr0h and others added 2 commits September 26, 2026 12:33
The private dependency recipes ran `go get -tool` for gofumpt, golines,
golangci-lint and gocover-cobertura. Every one of those tools is already
recorded in the consuming module's `tool (...)` block, so `go tool <pkg>`
resolves it from the module graph and nothing needs installing. What
`go get -tool` added was a re-resolution to whatever is newest, rewriting
go.mod and go.sum in the process.

That rewrite made `go-mod-check` unpassable. It runs in the same `go-test`
chain, so CI mutated the checkout and then failed the build for being
mutated: `upgraded go-diff v0.8.0 => v0.9.0` followed two lines later by
`untidy: .`. Any upstream tool release turned every open pull request red
across the organization, while each default branch stayed green because
its run predated the release.

Depend on _go-mod-download instead, which downloads and changes nothing.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FuKUsHFG1EqZXamffh9M2c
CONTRIBUTING.md and AGENTS.md both said the conventions live in the
specs repo "whose .specify/memory/ is the standing record", and both
carried a paragraph forbidding superpowers because Spec Kit governed
specification and planning.

Neither is true now. That repo is reorganized to components/<name>/ with
the docs at the top level of each, and Spec Kit is removed from it
entirely, so the prohibition has nothing left to protect and the pointer
named a directory that no longer exists.

Both now say the same shorter thing, in the same words as every sister
repository: how this repository is built is documented under
components/osapi-justfiles/ in the specs repo. Read it before changing behaviour,
change it when you do.
@github-actions

github-actions Bot commented Oct 1, 2026

Copy link
Copy Markdown

Thank you for contributing to this project! 😊🕹️

@retr0h
retr0h merged commit 9d86c63 into main Oct 1, 2026
4 checks passed
@retr0h
retr0h deleted the docs/point-at-the-design-docs branch October 1, 2026 04:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant