Skip to content

feat(documentation): add llm-wiki skill (Karpathy + qmd) (#8)#9

Merged
serithemage merged 21 commits into
mainfrom
feat/issue-8-llm-wiki
Apr 19, 2026
Merged

feat(documentation): add llm-wiki skill (Karpathy + qmd) (#8)#9
serithemage merged 21 commits into
mainfrom
feat/issue-8-llm-wiki

Conversation

@serithemage
Copy link
Copy Markdown
Contributor

@serithemage serithemage commented Apr 19, 2026

Summary

Karpathy LLM Wiki 패턴을 구현한 llm-wiki 스킬을 documentation 플러그인에 추가합니다.

  • 8개 서브커맨드: init, ingest, query, lint, sync, export, qmd-index, lancedb-sync
  • qmd 감지 시 하이브리드 검색 자동 활성, 미감지 시 INDEX.md 라우팅으로 graceful degrade
  • LanceDB + Embedding Atlas 선택적 벡터 인덱스 (Phase 3)
  • wjtb-cmc/.claude/skills/llm-wiki/ 포팅 + 일반화 (LEP-특수 제거, .wiki/ → wiki/)
  • 워크스페이스 CLAUDE.md "LLM Wiki 활용 규칙"과 통합

Changes

  • 새 스킬 plugins/documentation/skills/llm-wiki/
    • SKILL.md (186 lines, ≤300 ceiling)
    • references/ 6개 (page-templates, ingest-workflow, claude-md-block, qmd-integration, lancedb-integration, karpathy-pattern)
    • scripts/ 5개 (init.sh, sync_index.py, lint_wiki.py, qmd_index.sh, lancedb_sync.py)
  • .claude-plugin/marketplace.json 등록
  • root README, plugins/documentation/README.md, CHANGELOG 업데이트
  • 설계 문서: issues/8-llm-wiki/SPEC.md, PLAN.md, TASKS.md

Validation

  • npm test 203/203 green
  • E2E: init → sync → lint 라운드트립 통과 (clean 상태 exit 0, 끊어진 링크 주입 시 exit 1)
  • qmd/LanceDB graceful degrade 동작 (없을 때 설치 안내 + exit 1)
  • LEP/wjtb-cmc 특수 예시 전부 일반화 (Rate Limiter, User Authentication 등)
  • wiki/ 노출형 디렉토리 (워크스페이스 CLAUDE.md "LLM Wiki 활용 규칙" 정렬)

Closes

Test plan (PR 머지 후 수동 검증)

  • 로컬 설치: /plugin install documentation@roboco-plugins
  • 실제 프로젝트에서 init → ingest 워크플로 확인
  • qmd 설치 환경에서 하이브리드 검색 동작 확인
  • Obsidian vault로 wiki/ 열어 그래프 뷰 확인

🤖 Generated with Claude Code

serithemage and others added 21 commits April 19, 2026 15:28
@serithemage @claude
docs(issues/8): add SPEC for llm-wiki skill (Karpathy + qmd + LanceDB) (
76ba697 
#8)

Phase 2 scope: qmd 필수 통합 + LanceDB 선택. 단일 스킬에 8개 서브커맨드.
wiki/ 노출형 디렉토리, wjtb-cmc 스킬 포팅 + 일반화, graceful degrade UX.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
docs(issues/8): add TASKS bite-sized implementation plan (#8)
5f935e5 
Stage A (PLAN overview) → B (scaffold) → C (scripts) → D (references) →
E (SKILL.md) → F (integration) → G (verification). 7 stages, 19 tasks.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
docs(issues/8): add PLAN for llm-wiki stage overview (#8)
cef2cf4 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
scaffold(llm-wiki): create skill + 6 reference stubs + 5 script stubs (…
600db34 
…#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
scaffold(llm-wiki): register in marketplace (#8)
a60f6b8 
Quote argument-hint value in SKILL.md frontmatter so YAML parser does
not read the `[...]` as a flow sequence.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
feat(llm-wiki): port init.sh with wiki/ convention and env detection (#8
a389fcb 
)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
feat(llm-wiki): port sync_index.py with zero-dep frontmatter parsing (#8
a226bf7 
)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
feat(llm-wiki): port lint_wiki.py with link/orphan/frontmatter checks (…
4b82801 
…#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
feat(llm-wiki): add qmd_index.sh wrapper with install guidance (#8)
44f51b6 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
feat(llm-wiki): add lancedb_sync.py with graceful dep fallback (#8)
dbc3177 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
docs(llm-wiki): port page-templates with generic domain examples (#8)
eed0e73 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
docs(llm-wiki): port ingest-workflow 5-step guide (#8)
9cd2a46 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
docs(llm-wiki): port claude-md-block adapted to wiki/ convention (#8)
740c463 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
docs(llm-wiki): add qmd-integration with install + MCP + search modes (…
a692bf6 
…#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
docs(llm-wiki): add lancedb-integration Phase 3 optional guide (#8)
4aaadeb 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
docs(llm-wiki): add karpathy-pattern origin and design decisions (#8)
a502859 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
feat(llm-wiki): write 8-command orchestrator SKILL.md (#8)
8ae61ef 
Preserves frontmatter from scaffold (Stage B). Body documents 8 commands,
graceful degrade, integration points with qa-merge/intent/korean-docs,
and anti-patterns. Progressive disclosure via 6 references/.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
docs(readme): list llm-wiki skill in Documentation section (#8)
13eb34a 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
docs(documentation): add llm-wiki to plugin README (#8)
5645ac8 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
docs(changelog): note llm-wiki skill (#8)
662a907 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage @claude
fix(llm-wiki): address PR #9 review issues — orphan detection, CLAUDE…
f6447c9 
….md H1, doc paths (#8)

- lint_wiki.py: exclude index.md/log.md from 'referenced' set so orphan
  detection actually works after sync (previously sync auto-linked every
  page from index.md, nullifying orphan detection).
- init.sh: prepend H1 "# CLAUDE.md" when creating a fresh CLAUDE.md.
- ingest-workflow.md: correct script invocation paths to relative form.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@serithemage serithemage merged commit c732651 into main Apr 19, 2026
1 check passed
@serithemage serithemage deleted the feat/issue-8-llm-wiki branch April 19, 2026 07:21
This was referenced Apr 19, 2026
Closed
Closed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@serithemage