repolore

Files (93)

• marketplace.json · .claude-plugin/
• plugin.json · .claude-plugin/
• test-init-ux.js · .claude/workflows/
• validate.yml · .github/workflows/
• .gitignore
• manifest.json · .repolore/
• lib.mjs · .repolore/scripts/
• wiki-check.mjs · .repolore/scripts/
• wiki-coverage.mjs · .repolore/scripts/
• wiki-flow-check.mjs · .repolore/scripts/
• wiki-flow-refresh.mjs · .repolore/scripts/
• wiki-flow-render.mjs · .repolore/scripts/
• wiki-hook.mjs · .repolore/scripts/
• wiki-index.mjs · .repolore/scripts/
• wiki-install-hook.mjs · .repolore/scripts/
• wiki-stamp.mjs · .repolore/scripts/
• update-classification-seteq.mjs · .repolore/validators/
• AGENTS.md
• CLAUDE.md
• README.md
• SKILL.md
• RESEARCH-AUDIT.md · docs/
• RESEARCH-FINDINGS.md · docs/
• RESEARCH-FLOWS.md · docs/
• RESEARCH-WORKFLOWS.md · docs/
• RESEARCH.md · docs/
• ROADMAP.md · docs/
• AGENTS.md · docs/wiki/
• CLAUDE.md · docs/wiki/
• GLOSSARY.md · docs/wiki/
• decision.md · docs/wiki/_templates/
• flow.md · docs/wiki/_templates/
• page.md · docs/wiki/_templates/
• overview.md · docs/wiki/architecture/
• freshness-model.md · docs/wiki/concepts/
• adr-001-blob-sha-freshness-anchors.md · docs/wiki/decisions/
• adr-002-computed-status.md · docs/wiki/decisions/
• adr-003-stdlib-only-vendored-scripts.md · docs/wiki/decisions/
• adr-004-umbrella-skill-plugin-shims.md · docs/wiki/decisions/
• adr-005-bootstrap-mechanical-vendoring.md · docs/wiki/decisions/
• adr-006-vendored-tooling.md · docs/wiki/decisions/
• adr-007-verification-ladder-placement.md · docs/wiki/decisions/
• adr-008-per-harness-entry-point-bridging.md · docs/wiki/decisions/
• adr-009-findings-inbox-contract.md · docs/wiki/decisions/
• adr-010-audit-evidence-contract.md · docs/wiki/decisions/
• bootstrap-vendoring.md · docs/wiki/flows/
• update-classification.md · docs/wiki/flows/
• cross-tool-depth-untested.md · docs/wiki/gotchas/
• audit-the-wiki.md · docs/wiki/howto/
• run-the-ux-harness.md · docs/wiki/howto/
• index.md · docs/wiki/
• log.md · docs/wiki/
• wiki.config.yml · docs/wiki/
• audit.md · references/
• check.md · references/
• flow.md · references/
• init.md · references/
• refresh.md · references/
• setup.md · references/
• update.md · references/
• …and 33 more

SKILL.md (first lines)

# repolore

Your codebase has lore — the decisions, gotchas, and
why-things-are-the-way-they-are that live in nobody's head for long. This
skill makes you write it down, cite it, and keep it honest: an in-repo,
human-editable wiki distilled from the code, with per-claim citations and
mechanical (blob-SHA) staleness detection. The code is always the source of
truth; the wiki is the orientation layer.

`<SKILL_ROOT>` below means **the directory containing this SKILL.md** (it
ships with `scripts/`, `templates/`, and `references/` alongside).

## Six workflows — pick by what the user asked

| User intent | Procedure to read and execute |
|---|---|
| "set up a wiki / knowledge base for this repo" (once per repo) | `<SKILL_ROOT>/references/init.md` |
| "is the wiki up to date?" / before relying on wiki content | `<SKILL_ROOT>/references/check.md` |
| "update the wiki" / check reported stale pages | `<SKILL_ROOT>/references/refresh.md` |
| "audit the wiki for wrongness" / check's dust line reports overdue pages / "triage the findings" | `<SKILL_ROOT>/references/audit.md` |
| "update repolore's tooling in this repo" / check reported newer tooling | `<SKILL_ROOT>/references/update.md` |
| "activate repolore extras" (hook, team-wide nudge, auto-update) / after an update adds capabilities | `<SKILL_ROOT>/references/setup.md` |

Read the matching procedure fully and follow it exactly, substituting
`<SKILL_ROOT>` as defined above. Each is self-contained; the scripts they
invoke are stdlib-only (node + git, no npm install).

Day-to-day, outside those workflows: once a repo is initialized, its wiki
rules live in `<wikiRoot>/AGENTS.md` *inside that repo* (location recorded in
`.repolore/manifest.json`) — pages are drafted on demand ("draft
`features/<slug>` from the wiki plan") and updated as part of the change
that altered the behaviour they describe.

Also available as a Claude Code plugin (`/plugin marketplace add
emyann/repolore`), where these workflows surface as the namespaced commands
`/repolore:init`, `/repolore:check`, `/repolore:refresh`.

From emyann/repolore, MIT.

More from emyann/repolore