docs : add TurboQuant project overview to AGENTS.md and skills - #272
Conversation
- AGENTS.md: fork overview (turbo/TQ types, key files, env knobs, test gates, git workflow, known pitfalls) - skills/code-review: fork-specific TurboQuant checklist - skills/add-new-model: fork-specific validation and dedup steps - remove REBASE_PLAN.md (planning doc, superseded) Assisted-by: DeepSeek V4 Flash
|
Merging. I fact-checked the claims rather than skimming, because a wrong line in an orientation doc propagates further than a wrong line in a function: it gets believed by everyone who arrives afterwards, including agents. Everything checkable, checked against the tree:
The type table getting TURBO4_0 = 47 right is the detail I would expect a hand-written doc to get wrong, since the sequence looks like it should be contiguous. That it survives upstream's Q2_0 claiming 42 is exactly the kind of thing a newcomer needs told. Removing One suggestion for a follow-up rather than a change request: the doc would be more useful with a short section on what the test suites do and do not cover, because that has been this fork's most expensive recurring surprise. Three separate times in the past week a green run turned out to be measuring nothing: MUL_MAT_ID passing at n=16 while the decode path was never exercised, SET_ROWS TQ4_1S cases passing vacuously on zero rows, and Thanks for writing this down. Orientation docs are unglamorous and this one is accurate. |
Overview
Requirements