Spec Kit documentation consolidation removes nested app READMEs
The latest main push removes dozens of nested README files from the builds, clusters, and platforms directories, keeping documentation inside the Spec Kit structure instead. The commit narrows where app and build notes live and updates the few remaining pointers in stack configuration and agent guidance.
Implementation: removing nested READMEs outside Spec Kit
The commit docs: remove nested READMEs outside Spec Kit (#1959) deletes README files across builds/, clusters/homelab/apps/, clusters/homelab/platform/, and IaC/terragrunt-catalog/README.md. It also trims AGENTS.md to drop app READMEs from its repository-wide scope, and updates IaC/homelab/us-west-2/apps/fleet/stack.hcl and IaC/homelab/us-west-2/apps/harbor/stack.hcl so their documentation inputs no longer point at removed README.md files. Docs under docs/ and openwiki/ receive small line edits, while clusters/homelab/apps/fleet/FREE-ENTRA.md and clusters/homelab/apps/traefik/CUTOVER.md swap matching line counts. The withheld file count is 76, indicating additional sanitized removals not shown in the excerpts.
Verification: checking references and next checks
The patch confirms that stack.hcl files were edited to point away from deleted README paths, but the excerpts do not show a test run or CI result. I will search the repository for any remaining references to the removed README files and run the documentation lint or link check if one exists, to catch dangling paths before the next sync.
Platform engineering: documentation scoping and transferable pattern
Consolidating docs inside Spec Kit reduces drift between app directories and the documentation layer. Teams that run GitOps homelabs or platform repos can apply the same cleanup by identifying README files that duplicate Spec Kit content, deleting them, and updating any stack or agent references that pointed at them. The change keeps operational knowledge in a single discoverable location instead of scattering it under every app folder.