chore(docs): drop a product brief nothing reads and nothing checks - #784
Merged
Conversation
`aidd_docs/product/aidd-kanban.md` was written once and never referenced again: no test asserts anything about it, no source file names it, and no other document links to it. Its two neighbours in that folder are the opposite — `metrics-contract.md` is held by three test files and `cost-report-contract.md` by four, which recompute the figures those documents state and fail when a field is added or removed without being written down. A document nothing checks can drift without anyone finding out, and this one describes a screen that has changed since. Read as current, it misleads; read as history, it is not marked as such. The 101 lines go. Nothing else moves: 373 repository script tests, 0 broken links in 797 files, and the eight cases guarding the two contracts that remain still pass. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VWNxk63AGKkqE8HRqHLjGp
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
aidd_docs/product/aidd-kanban.md— 101 lines, zero tests, zero source references, zero inbound links.Its two neighbours are the opposite, and that contrast is the point:
metrics-contract.mdcost-report-contract.mdaidd-kanban.mdThose tests are not cosmetic — they assert every field the record actually has is documented, that no documented field has since been removed, and they recompute the figures the documents state from the code. A contract that drifts turns the suite red.
This one has nothing. It describes a screen that has changed since it was written: read as current it misleads, read as history it is not marked as such.
373 repository script tests, 0 broken links in 797 files, and the eight cases guarding the two remaining contracts still pass.
🤖 Generated with Claude Code
https://claude.ai/code/session_01VWNxk63AGKkqE8HRqHLjGp