Skip to content

feat: /wiki-code umbrella — the /wiki for codebases (completes Mode B Code Wiki)#85

Open
RasenGUY wants to merge 4 commits into
AgriciDaniel:mainfrom
RasenGUY:feat/wiki-code
Open

feat: /wiki-code umbrella — the /wiki for codebases (completes Mode B Code Wiki)#85
RasenGUY wants to merge 4 commits into
AgriciDaniel:mainfrom
RasenGUY:feat/wiki-code

Conversation

@RasenGUY

Copy link
Copy Markdown

Summary

Adds /wiki-code — the /wiki for codebases: a status-aware umbrella skill that turns the Mode B code-wiki family (wiki-code-ingest, wiki-code-lint, wiki-code-watch) into a single entry point, mirroring how /wiki fronts the prose-wiki sub-skills.

This is the capstone of the Mode B "Code Wiki" work. Because main does not yet contain any of the Mode B stack, this PR carries the whole feature (ingest → lint → watch → umbrella) so it stands alone.

Relationship to open PRs: this supersedes #81 (Mode B ingestion) and #82 (ingestion + /wiki-code-lint) — it contains their commits plus the /wiki-code umbrella and a test-wiring fix. If you merge this, #81 and #82 can be closed. Happy to split it back into incremental PRs if you'd rather land it in stages.

What's in this PR

Commit What
10edf7c Mode B codebase ingestion, drift lint, commit-triggered sync (= #81)
062a69a fix: match abbreviated / inline code_anchors in the drift check
9580caa /wiki-code-lint code-fidelity audit + emit aliases (= #82)
282ef1d /wiki-code umbrella skill + wire two previously-unrun lint test suites (new)

The /wiki-code umbrella (new here)

skills/wiki-code/SKILL.md + commands/wiki-code.md, mirroring skills/wiki/SKILL.md:

  • Read-only STATUS dashboard on a bare /wiki-code — vault presence, code-page counts, watched repos (code-sync-check.py --status --json), anchored pages (code-anchor-check.py --peek --json). Mutates nothing on a status call.
  • First-run scaffold + ingest/wiki-code <repo> scaffolds a minimal Mode B vault via bin/setup-vault.sh if none exists, then hands off to wiki-code-ingest, honoring its scope + module-list checkpoints.
  • Routing — ingest / sync / watch / lint dispatch to the existing engines; code questions ("which modules depend on X") route to the existing /wiki-query (no new query skill — intentional). The umbrella never re-implements an engine.
  • Coexists with /wiki/wiki keeps its natural-language code routing; /wiki-code is the explicit, status-aware entry point. One CODE WIKI row added to /wiki's operations table.

Design decisions: full umbrella + status dashboard; reuse /wiki-query for code Q&A; auto-scaffold-then-ingest on first run.

Also fixed: two test suites that never ran

wiki-code-lint's check scripts (scripts/code-coverage-check.py, scripts/wiki-link-resolve-check.py) shipped with hermetic tests (tests/test_code_coverage_check.py, tests/test_wiki_link_resolve_check.py) that were never wired into make test. This PR adds test-code-coverage + test-link-resolve targets, taking the suite from 15 → 17.

Docs / packaging

  • CLAUDE.md — Skills line, Plugin Skills table row, new "Code Wiki" section.
  • README.md — skill count 15 → 18, code-wiki command rows, File Structure tree with accurate counts (18 skills / 19 scripts / 17 suites / 7 bin).
  • CHANGELOG.md[Unreleased] entries for the umbrella and the /wiki-code-lint slice; suite count 15 → 17.
  • .claude-plugin/plugin.json + marketplace.json — 1.9.2 → 1.10.0.

Verification

  • make test17/17 suites green (9 pre-existing + 8 new), exit 0.
  • Both manifests valid JSON; version bump consistent across both.
  • Every relative link, sub-skill name, and referenced script/flag in the new SKILL.md resolves (../wiki/references/modes.md, ../wiki/references/frontmatter.md, code-sync-check.py --status, code-anchor-check.py --peek, bin/setup-vault.sh, …).
  • STATUS dashboard commands dry-run read-only with no errors.
  • All README count claims reconciled against ground truth on disk.

Try it

/wiki-code                 # read-only status dashboard
/wiki-code <repo-path>     # scaffold (if needed) + map a repo as a Mode B architecture wiki
/wiki-code-lint            # code-fidelity audit (drift, staleness, coverage, link resolution)
/wiki-code-watch <repo>    # commit-triggered auto-sync

@RasenGUY RasenGUY requested a review from AgriciDaniel as a code owner June 10, 2026 07:43
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