Skip to content

fix: README pins + docs catalog backfill — drift-guards extended to README/docs#268

Merged
kiki830621 merged 1 commit into
mainfrom
idd/267-docs-pin-sync
Jul 18, 2026
Merged

fix: README pins + docs catalog backfill — drift-guards extended to README/docs#268
kiki830621 merged 1 commit into
mainfrom
idd/267-docs-pin-sync

Conversation

@kiki830621

Copy link
Copy Markdown
Member

Refs #267

README pins + docs catalog 回填 + guard 擴網(#122 根因機制解)

修了什麼

結構性防範(雙向)

  1. model-generation-sync refute 網擴及 README + 兩個 catalog docs(31 assertions)— pin 漏網即紅
  2. 新 suite docs-catalog-sync:每個 skills/*/ 目錄名必須出現在 catalog docs(RED 抓到 idd-ask + idd-config)— [IDD][design] Enforce strict separation: idd-issue → idd-diagnose → idd-all / idd-all-chain (no auto-swallow diagnose) #122 的根因「catalog 無強制回填機制」從此 test-detectable;guard 只鎖提及,內容品質仍是人的判斷(尾注明文)

Verification

docs-catalog-sync 19/19、model-generation-sync 31/31、全 sweep 38 suites 0 fail。issue 結案不由本 PR 觸發。

…cover README/docs

README carried THREE stale gpt-5.5 pins (skill table, dependency table,
prerequisites) plus a stale 'vendored codex-call / three-tier degrade' claim
— all outside model-generation-sync's scan net, which is exactly how they
leaked past the #251/#264 zero-pin contract (the guard caught two of them
only after its net was widened mid-fix). docs/workflows.md + skill-dimensions
backfilled to v2.99 reality: P-find-lookup, P-ask-history, P-report-rollup,
P-config-maintain, P-verify-file-profile paths; matrix rows for idd-find /
idd-ask / idd-config (the last a pre-#122 legacy gap); D12 line gains the 4th
member. Systemic prevention, both directions: model-generation-sync refutes
now include README + both catalog docs (31 assertions), and a new
docs-catalog-sync suite requires every skills/*/ directory name to appear in
a catalog doc — the #122 root cause (no forcing function for backfill) is
now test-detectable (RED caught idd-ask + idd-config). Sweep 38 suites 0
fail.

Refs #267
@kiki830621
kiki830621 merged commit cc0caa5 into main Jul 18, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant