# Docs References Inventory

> Working artifact. Not shipped. Authoring/audit material for the docs-reference-contract enforcement work.
> Generated: 2026-05-16. Source: `grep -rn "docs/" .claude/{agents,skills,commands,memory,hooks,scripts,rules,rules-conditional,modes}/ | grep -vE "https?://"` → 224 matches.

## Summary

| Type | Definition | Count | Status |
|---|---|---|---|
| 1 | Target-project doc (resolved under USER project root; generated by a producer skill) | 200+ refs | OK — on contract allowlist |
| 2 | MeowKit-internal doc leaking into shipped runtime files | 12 refs | BROKEN — patched by surgical-patches phase |
| 3 | Source-attribution citation containing a `docs/*` path | 3 refs | De-pathed by surgical-patches phase |
| 4 | False positive (glob pattern, external URL fragment, slash-list category, .webm example data, template placeholder) | rest | No action |

## Type 2 — Broken Internal-Doc Leaks (12 refs)

| # | File | Line | Target | Patch strategy |
|---|---|---|---|---|
| 1 | .claude/skills/benchmark/SKILL.md | 26 | docs/dead-weight-audit.md | Hosted URL `https://docs.meowkit.dev/dead-weight-audit` |
| 2 | .claude/skills/benchmark/SKILL.md | 151 | docs/dead-weight-audit.md | Hosted URL |
| 3 | .claude/skills/harness/references/adaptive-density-matrix.md | 68 | docs/dead-weight-audit.md | Hosted URL |
| 4 | .claude/skills/harness/references/adaptive-density-matrix.md | 83 | docs/dead-weight-audit.md | Drop the orphan bullet (stale Phase-6 TODO; Phase 8 shipped) |
| 5 | .claude/rules/harness-rules.md | 57 | docs/dead-weight-audit.md | Hosted URL (rules file is always-loaded; cannot inline a multi-page playbook) |
| 6 | .claude/agents/reviewer.md | 65 | docs/red-team-overview.md | Hosted URL `https://docs.meowkit.dev/red-team-overview` (file lives at docs/operations/red-team-overview.md, do NOT drop) |
| 7 | .claude/commands/mk/summary.md | 56 | docs/operations/harness-runbook.md | Hosted URL `https://docs.meowkit.dev/harness-runbook` |
| 8 | .claude/memory/architecture-decisions.md | 51 | docs/memory-system.md:28-31 | Inline 1–2 sentences capturing the rationale; preserve citation by title |
| 9 | .claude/memory/architecture-decisions.md | 53 | docs/meowkit-architecture.md line 240-241 | Same — inline the claim with title-only attribution |
| 10 | .claude/hooks/HOOKS_INDEX.md | 42 | docs/memory-system.md | Hosted URL or inline the tombstone summary |
| 11 | .claude/hooks/HOOKS_INDEX.md | 104 | docs/meowkit-rules.md | Hosted URL `https://docs.meowkit.dev/rules` or link to `.claude/rules/` index |
| 12 | .claude/scripts/lint-brand-prose.sh | 36 | docs/branding-style-guide.md | Hosted URL `https://docs.meowkit.dev/branding-style-guide` (this string is printed to user, must remain actionable) |

## Type 3 — Attribution Citations (3 refs)

| # | File | Line | Target | Patch strategy |
|---|---|---|---|---|
| 1 | .claude/skills/prompt-enhancer/references/context-safeguards.md | 9 | docs/research/effective-context-engineering-for-ai-agents.md | "Source: Anthropic — Effective Context Engineering for AI Agents" |
| 2 | .claude/skills/elicit/SKILL.md | 18 | docs/explanation/advanced-elicitation.md | "Inspired by BMAD-METHOD's Advanced Elicitation pattern" |
| 3 | .claude/skills/jira/references/cli-idioms.md | 3 | docs/jira-as/README.md | "Authored from the jira-as upstream README + direct verification against `src/jira_as/cli/commands/*.py` Click decorators." |

## Template Placeholder Leak (1 ref)

| # | File | Line | Target | Patch strategy |
|---|---|---|---|---|
| 1 | .claude/skills/plan-creator/references/phase-template.md | 63 | ../../../docs/relevant-doc.md | Replace with `<path-to-related-doc-in-your-project>` |

## Type 1 — Target-Project Allowlist (200+ refs across .claude/)

Already covered by the allowlist in `.claude/rules/docs-reference-contract.md`. Highest-volume consumers:

- `docs/project-context.md` — ~81 refs (agent "constitution" load per `agent-conduct.md` A2)
- `docs/architecture/` and subpaths — ~18 refs (ADRs, system-architecture; owned by architect agent)
- `docs/journal/` — owned by journal-writer agent
- `docs/design-guidelines.md`, `docs/designs/`, `docs/wireframe/` — owned by ui-ux-designer / plan-ceo-review
- `docs/code-standards.md`, `docs/codebase-summary.md` — generated by `mk:docs-init`
- `docs/project-overview.md`, `docs/project-changelog.md`, `docs/development-roadmap.md` — generated / maintained by `mk:document-release`
- `docs/api-reference.md`, `docs/components.md`, `docs/modules.md`, `docs/setup.md`, `docs/changelog.md` — emitted by `commands/mk/docs-sync.md`
- `docs/retros/YYMMDD-retro.md` — emitted by `commands/mk/retro.md`
- `docs/cost-report.md` — emitted by `.claude/scripts/cost-report.py`
- `docs/rollback/` — emitted by `mk:ship` for high-risk changes
- `docs/usage.md`, `docs/deployment-guide.md`, `docs/relevant-doc.md` (as a Type-1 example placeholder) — referenced in plan templates

## Type 4 — False Positives (do not patch)

- `.claude/hooks/gate-enforcement.sh:88` — `docs/*|*/docs/*)` glob path-match in a case statement, not a doc reference
- `.claude/hooks/project-context-loader.sh` — reads `docs/project-context.md` from the USER project root (it IS the producer/consumer for the Type-1 contract)
- `.claude/skills/scale-routing/SKILL.md:35` — `bug_fix/feature/refactor/security/devops/docs/review/intake` is a slash-separated task-type category list, not a path
- `.claude/skills/agent-browser/references/video-recording.md:71` — `./docs/how-to-login.webm` is example user-project data in a CLI invocation example
- `.claude/skills/jira-issue/references/issue-templates.md:177` — `jira-issue/docs/templates/` is part of an attribution-prose phrase about upstream JIRA-Assistant-Skills layout, not a load
- `.claude/skills/lazy-agent-loader/SKILL.md:42` — `docs/documentation/changelog/readme` appears in a CSV row example, not a path
- `code.claude.com/docs/en/hooks` references — external URL fragments (the http:// prefix was stripped by the grep filter on a few lines)

## Method

```bash
cd /Users/sangnguyen/Desktop/claude-tool/meowkit
grep -rn --exclude-dir="site-packages" --exclude-dir="__pycache__" "docs/" \
  .claude/agents/ .claude/skills/ .claude/commands/ .claude/memory/ \
  .claude/hooks/ .claude/scripts/ .claude/rules/ .claude/rules-conditional/ \
  .claude/modes/ 2>/dev/null | grep -vE "https?://"
```
