Codebase Analysis β DocKit Master
Codebase Analysis
Section titled βCodebase AnalysisβQuick Reference
- Project: DocKit Master
- Type: AI Skill Engine / Static Landing Site
- Languages: Markdown (skills), Bash (CLI), HTML/CSS/JS (landing pages)
- Frameworks: Astro Starlight (docs output)
- Files: ~96 (excluding node_modules, dist)
- Lines of Code: ~12,000+
Architecture
Section titled βArchitectureβgraph TB
subgraph Core["Knowledge Engine"]
SKILL["Skills - 11 files\nAnalysis, Personas, JTBD\nFlows, Tech, SOP, API\nSEO, Content, LLM"]
WORKFLOW["Workflows - 5 files\nExport Markdown\nSetup Astro\nGenerate Sitemap"]
end
subgraph Integration["Multi-IDE Integration"]
ADAPTERS["Adapters - 6 IDEs\nCursor, Claude, Gemini\nOpenCode, Windsurf, AGENTS"]
SCRIPTS["Scripts\ndockit-master.sh\ninstall.sh"]
end
subgraph Presentation["Landing Site"]
PAGES["Pages\nHome, Features, Use Cases\nClaw Platforms"]
end
subgraph Output["Generated Output"]
OUTPUT["docs/ Markdown\nastro-site/ Starlight"]
end
SKILL --> WORKFLOW
WORKFLOW --> OUTPUT
SCRIPTS --> SKILL
ADAPTERS --> SKILL
Architecture summary: DocKit Master is a skill-based AI documentation engine. The core consists of 11 Markdown skill files that instruct AI agents to analyze codebases and generate structured documentation. Workflows orchestrate the export process. Scripts provide CLI interaction, and adapters enable cross-IDE compatibility.
Directory Structure
Section titled βDirectory StructureβDocKit Master/βββ SKILL.md # Main orchestrator (295 lines)βββ README.md # Project overviewβββ index.html # Landing page (59K)βββ skills/ # 11 skill files β core engineβ βββ analyze-codebase.mdβ βββ persona-builder.mdβ βββ jtbd-analyzer.mdβ βββ flow-mapper.mdβ βββ tech-docs.mdβ βββ sop-guide.mdβ βββ api-reference.mdβ βββ content-guidelines.mdβ βββ content-writing.mdβ βββ llm-optimization.mdβ βββ seo-checklist.mdβββ workflows/ # 5 workflow filesβ βββ export-markdown.mdβ βββ setup-astro.mdβ βββ generate-sitemap.mdβ βββ generate-docs.mdβ βββ setup-docusaurus.mdβββ scripts/ # 2 CLI scriptsβ βββ dockit-master.shβ βββ install.shβββ adapters/ # 6 IDE adaptersβ βββ cursor.mdcβ βββ claude.mdβ βββ gemini.mdβ βββ opencode.mdβ βββ windsurf.mdβ βββ agents.mdβββ templates/ # 3 template setsβ βββ astro-premium/β βββ docusaurus-premium/β βββ markdown/βββ pages/ # Landing site sub-pagesβ βββ features/β βββ use-cases/β βββ claw/β βββ css/β βββ js/βββ docs/ # Generated documentation (this)βββ astro-site/ # Generated Astro Starlight siteCore Components
Section titled βCore Componentsβ| Component | Description | Key Files |
|---|---|---|
| Skill Engine | 11 instruction files guiding AI agents | skills/*.md |
| Orchestrator | Main entry point routing to skills | SKILL.md |
| CLI | Interactive Bash prompt generator | scripts/dockit-master.sh |
| Installer | Multi-IDE installer | scripts/install.sh |
| IDE Adapters | Entry points for 6 AI IDEs | adapters/* |
| Astro Template | Premium Starlight config | templates/astro-premium/ |
| Landing Site | Multi-page showcase (vi/en/zh/ja) | index.html, pages/ |
Skill Pipeline
Section titled βSkill PipelineβsequenceDiagram
autonumber
actor User
participant CLI as CLI / IDE
participant SK as SKILL.md
participant AN as Analyze
participant KN as Knowledge
participant TD as Tech Docs
participant SP as SOP
participant AP as API Ref
participant EX as Export
User->>CLI: Run dockit-master.sh
CLI->>SK: Config params
SK->>AN: Scan codebase
AN-->>SK: analysis.md
SK->>KN: Personas + JTBD + Flows
KN-->>SK: personas/ jtbd/ flows/
SK->>TD: Architecture + DB + Deploy
TD-->>SK: tech docs
SK->>SP: User Guides
SP-->>SK: sop/
SK->>AP: Endpoint Reference
AP-->>SK: api/
SK->>EX: Astro or Markdown
EX-->>User: Final site
Pipeline summary: User triggers the CLI, SKILL.md orchestrates: Analyze β Knowledge β Tech β SOP β API β Export. Each step reads previous output and enriches it.
Key Files
Section titled βKey Filesβ| File | Role | Size |
|---|---|---|
SKILL.md | Main orchestrator | 13.2 KB |
skills/flow-mapper.md | 4 flow type generator | 11.5 KB |
skills/persona-builder.md | Buyer & User Personas | 8.6 KB |
skills/content-guidelines.md | Content structure rules | 8.5 KB |
scripts/install.sh | Multi-IDE installer | 8.5 KB |
scripts/dockit-master.sh | Interactive CLI | 7.7 KB |
index.html | Landing page | 59.4 KB |
Architecture Decisions
Section titled βArchitecture Decisionsβ| # | Decision | Rationale | Status |
|---|---|---|---|
| 1 | Markdown-based skills | Portable, IDE-agnostic, version-controllable | Accepted |
| 2 | Astro Starlight over Docusaurus | 50MB vs 1.5GB, auto-sidebar, native Markdown | Accepted |
| 3 | Knowledge layer first | Personas + JTBD + Flows enrich all downstream docs | Accepted |
| 4 | Multi-IDE adapters | Lightweight references to SKILL.md, no duplication | Accepted |
| 5 | SEO + LLM dual optimization | Every page serves both search engines and AI | Accepted |