wiki-onboarding

Wiki Onboarding Guide Generator

Generate two complementary onboarding documents that together give any engineer — from newcomer to principal — a complete understanding of a codebase.

When to Use

• User asks for onboarding docs or getting-started guides
• User runs /deep-wiki:onboard command
• User wants to help new team members understand a codebase

Language Detection

Scan the repository for build files to determine the primary language for code examples:

• package.json / tsconfig.json → TypeScript/JavaScript
• .csproj / .sln → C# / .NET
• Cargo.toml → Rust
• pyproject.toml / setup.py / requirements.txt → Python
• go.mod → Go
• pom.xml / build.gradle → Java

Guide 1: Principal-Level Onboarding

Audience: Senior/staff+ engineers who need the "why" behind decisions.

Required Sections

1. System Philosophy & Design Principles — What invariants does the system maintain? What were the key design choices and why?
2. Architecture Overview — Component map with Mermaid diagram. What owns what, communication patterns.
3. Key Abstractions & Interfaces — The load-bearing abstractions everything depends on
4. Decision Log — Major architectural decisions with context, alternatives considered, trade-offs
5. Dependency Rationale — Why each major dependency was chosen, what it replaced
6. Data Flow & State — How data mov