docs(knowledge): product PRD catalog + adopt knowledge-template v1.1.0 - #63
Merged
Conversation
Author 38 test-backed PRD drafts covering the whole package across the base/provider/modality/flow ontology — the product contracts (what must be true for a consumer, and whether a test proves it) that prd/ previously lacked. Each row is transcribed from the consumer docs; where a test proves it, the Evidence column names that test. Drafts await file-by-file owner ratification into prd/. Add .knowledge/scripts/prd-evidence — the check doc-lint cannot do: asserts every green PRD Evidence name resolves to a real Pest test description. Wired into composer check as lint:prd. Update CODEMAP, MEMORY, and the scripts catalog.
Apply the v1.1.0 wording migration: the always-loaded README now surfaces that scripts/ holds project scripts alongside the versioned linter and marks tmp/ as throwaway. Bump .knowledge/.version to 1.1.0. Wording only — no manifested file changed, so payload integrity still passes.
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.
What this adds
A complete, test-backed PRD catalog for the whole package — 38 draft contracts across the declared
base-/provider-/modality-/flow-ontology, filling the previously-empty.knowledge/prd-drafts/. Each row is a product-level requirement (what must be true for a consumer) transcribed from the consumer docs; where a test proves it, the Evidence column names that test. 316 rows are✅(test-proven), ~12 are honest❌gaps (moderation categories, cross-vendor prompt-cache, provider failover).A project-owned evidence linter —
.knowledge/scripts/prd-evidence, the checkdoc-lintcannot do: it asserts every✅PRD Evidence name resolves to a real Pest test description. Wired intocomposer checkaslint:prd.Adopt knowledge-template v1.1.0 — the always-loaded README now surfaces that
scripts/holds project scripts alongside the versioned linter, and markstmp/throwaway;.knowledge/.version→1.1.0(wording only, integrity unchanged).Status
Drafts are pre-ratification — they await file-by-file owner sign-off, at which point each
git mvs into.knowledge/prd/. Nothing lands inprd/here.Verification
doc-lint— greenprd-evidence— green (316 ✅ Evidence names all resolve)