Clawpatch Wiki Watchlist¶
Use Clawpatch as a review ledger for public knowledge and generated-runtime seams, not as an automatic fixer. The goal is to catch public/private boundary drift, citation holes, generated artifact mistakes, and agent-access regressions that normal lint may not explain in product terms.
Operating Rules¶
- Keep
.clawpatch/local. Do not commit generated maps, findings, reports, or patch attempts. - Review first. Do not run
clawpatch fixuntil a human has triaged the finding and picked a scope. - Do not review raw source bodies by default;
raw/**is excluded because it can contain large copyrighted or pointer artifacts. - Never hand-edit generated benefits pages as the source of truth; fix
../gc-benefits, then regenerate. - Keep private strategy, prompts, production metrics, and partner-sensitive proof out of public wiki pages.
Setup¶
Canonical Watchlist¶
| Watch item | Trigger it when changes touch | Ask Clawpatch to look for | Local verification anchors |
|---|---|---|---|
| Lane A resources | docs/benefits, docs/conditions, docs/guides, docs/organizations, zone indexes |
Hand edits to generated benefits pages, stale verified dates, missing source role, caregiver next-step ambiguity. | pnpm lint, pnpm check:raw, regenerate from gc-benefits when needed. |
| Lane B synthesis | docs/product, docs/domain, docs/evidence, docs/bench, docs/architecture |
Uncited claims, contradictions overwritten silently, public/private leakage, duplicate definitions instead of links. | pnpm lint, source page cross-checks. |
| Source graph | docs/sources, footnotes, docs/log.md, docs/gaps.md editorial section |
Orphan source intent, stale cited_by, numbers without citations, gaps that should be captured. |
pnpm regen, pnpm lint --json. |
| Agent access | agent-access.yml, scripts/build-agent-index.ts, Lane B opt-ins |
Cards that leak prompt/pathing, wrong domains, stale cautions, missing key points, over-broad runtime exposure. | pnpm build:agent-index, inspect site/agent-index.json. |
| Resource catalog | scripts/extract.ts, scripts/publish.ts, Lane A resource pages |
Broken zone/category mapping, duplicate source IDs, unsafe resource text, import key assumptions. | pnpm extract:knowledge, pnpm test. |
| Public deploy/SEO | mkdocs.yml, overrides, docs/llms.txt, docs/robots.txt, SEO scripts |
Noindex/canonical drift, missing llms discovery, public route claims not in nav, stale generated site expectations. | pnpm build, pnpm verify:seo-render. |
| Code-derived synthesis | Pages updated after gc-sms, gc-benefits, or gc-bench changes |
Wiki explanation falling behind code behavior, source owner not named, runtime details published too deeply. | Read sibling diff; pnpm lint. |
Coverage Gotchas¶
- If the agent mapper omits
docs/product/*, create a local manual feature for product score / assessment synthesis before review. Include at leastdocs/product/score.md,docs/product/assessments.md,docs/product/benefits.md,docs/domain/zones.md,docs/domain/sdoh.md, the relevant architecture pages, andagent-access.yml.
Triage¶
Treat findings as review input. A finding is actionable only after the public claim, source owner, and verification command are clear.