Skip to content

feat(deep-wiki): source citations, llms.txt, 4 onboarding guides, MCP integration#127

Merged
thegovind merged 1 commit intomainfrom
deep-wiki-citations-llms-onboarding
Feb 13, 2026
Merged

feat(deep-wiki): source citations, llms.txt, 4 onboarding guides, MCP integration#127
thegovind merged 1 commit intomainfrom
deep-wiki-citations-llms-onboarding

Conversation

@thegovind
Copy link
Collaborator

Summary

Major enhancements to the deep-wiki plugin across 26 files (+1267/-195 lines).

Source-Linked Citations

  • All 22 content-generating files now require source repo URL resolution before proceeding
  • Citations use [file:line](REPO_URL/blob/BRANCH/file#Lline) for remote repos, (file:line) for local
  • Tables include "Source" columns with linked citations

Enhanced Diagrams & Tables

  • 3-5 Mermaid diagrams minimum per page using >=2 different types
  • Diagram Selection Guide added to wiki-writer agent
  • Table Formatting Standards: summary tables first, comparison tables, Source columns
  • Content Organization Rules: progressive disclosure, visual rhythm, section TL;DRs

ADO Wiki Improvements

  • Proper index.md landing page - never a placeholder
  • Citation/diagram preservation through ADO conversion
  • .order file generation for sidebar ordering

4 Audience-Tailored Onboarding Guides

Restructured from 2 guides to 4 in onboarding/ folder:

Guide Audience Length
contributor-guide.md New contributors (assumes Python/JS) 1000-2500 lines
staff-engineer-guide.md Staff/principal engineers 800-1200 lines
executive-guide.md VP/director-level leaders (NO code) 400-800 lines
product-manager-guide.md Product managers (ZERO jargon) 400-800 lines

New: /deep-wiki:llms Command + wiki-llms-txt Skill

  • Generates spec-compliant llms.txt at repo root (standard discovery path) and wiki/ directory
  • Generates llms-full.txt with full content inlined in <doc> blocks
  • Follows the llms.txt specification

GitHub MCP Integration

  • AGENTS.md template now includes Documentation section pointing to wiki/llms.txt
  • llms.txt at repo root - discoverable by get_file_contents
  • Wiki pages searchable via search_code
  • New "Agent & MCP Integration" section in README documenting the discovery flow

Updated Surfaces

  • Root README.md - plugin table updated with all 11 commands
  • docs-site/index.astro - Deep Wiki modal updated to v2.0.0 with all commands

Files Changed

  • New: commands/llms.md, skills/wiki-llms-txt/SKILL.md
  • Modified: 22 files across agents/, commands/, skills/, README.md, and docs-site/

… MCP integration

- Source-linked citations: all files require repo URL resolution before proceeding;
  citations use [file:line](REPO_URL/blob/BRANCH/file#Lline) for remote repos
- Enhanced diagrams: 3-5 minimum per page, dark-mode colors, variety enforced,
- Enhanced tables: Source columns, comparison tables, structured formatting standards
- ADO Wiki: proper index.md landing page (never placeholder), citation preservation,
  .order files for sidebar ordering
- Onboarding restructured: 4 audience-tailored guides in onboarding/ folder
  (Contributor, Staff Engineer, Executive, Product Manager)
- New /deep-wiki:llms command + wiki-llms-txt skill: generates llms.txt at repo root
  (standard discovery path) and wiki/ dir, plus llms-full.txt with inlined content
- AGENTS.md template: added Documentation section referencing wiki/llms.txt
- GitHub MCP integration: Agent & MCP Integration section in README documenting
  the discovery flow (get_file_contents → llms.txt → wiki pages → search_code)
- Updated root README and docs-site with all 11 commands
@thegovind thegovind merged commit 3331c5e into main Feb 13, 2026
3 checks passed
@thegovind thegovind deleted the deep-wiki-citations-llms-onboarding branch February 13, 2026 00:50
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