DocuForge menganalisis project secara otomatis, mengubah struktur menjadi intermediate representation framework-agnostic, menyelesaikan hubungan antar komponen, dan menghasilkan dokumentasi teknis yang human-friendly.
DocuForge bukan sekadar Laravel documentation generator. Laravel hanyalah salah satu plugin. Target akhirnya adalah engine universal yang mendukung berbagai framework dan bahasa:
Laravel, Express, NestJS, FastAPI, Django, Spring Boot
TypeScript, JavaScript, Python, PHP, Java, Go, Rust
Markdown, HTML, VS Code, OpenAPI, Mermaid, Static Site
Scan once, understand everywhere.
Memilih scanner dengan confidence tertinggi. Specialized scanner always wins over generic scanner.
interface Scanner {
metadata(): PluginMetadata;
detect(rootPath: string): Promise<DetectionResult> | DetectionResult;
scan(ctx: ScanContext): Promise<DFIRDocument> | DFIRDocument;
}
Contoh package: @docuforge/plugin-laravel, @docuforge/plugin-generic, @docuforge/plugin-express, dll.
Metadata, package manager, dependencies, directory structure, source files
Classes, interfaces, functions, methods, imports, exports, types, enums, decorators
Routes, controllers, models, middleware, services, jobs, events (per framework)
DFIR adalah bahasa universal antara scanner dan generator. Scanner boleh framework-specific, tapi output-nya harus framework-agnostic.
Route, Controller, Service, Model, Database, Dependencies, Relationships
CurrentFile, Module, Class, Interface, Function, Method, Import, Export, Type, Enum
NextComponent, Package, Module, Dependency, Relationship, External System
Universal documentation model yang stabil
Fitur inti. Contoh resolving:
Dari relationship ini DocuForge dapat menghasilkan architecture graph (Mermaid-ready).
docuforge generate .
Options: --output, --format, --watch, --verbose
init · detect · scan · generate · serve · watch · diff · check
Incremental analysis: hanya file yang berubah di-scan ulang, relationship & docs di-update.
Membandingkan source vs documentation (missing route, signature mismatch, dll).
Workspace, package, internal & external dependency (penting karena DocuForge sendiri monorepo).
.docuforge.json + .docuforgeignore
Generate docs, open source location, explain file/function, show architecture.
Dashboard, architecture graph, API explorer, dependency graph, search.
Opt-in. AI membaca DFIR + relationships untuk explain architecture, generate onboarding, summary.
Default: local analysis only. Source code tidak di-upload. AI bersifat opt-in.
docuforge/
├── packages/
│ ├── core/ (dfir, plugin, analyzer, relationship)
│ ├── generator/ (markdown, html, json)
│ └── cli/
├── plugins/
│ ├── generic/
│ ├── laravel/
│ ├── node / express /
│ ├── python / fastapi / django
│ └── spring /
├── apps/
│ └── docs-web/
└── extensions/
└── vscode/
DFIR, Plugin Interface, Registry, CLI, Markdown Generator, Laravel Scanner
DoneGeneric Scanner, Detection, Dependency Scan, TypeScript Analyzer, Monorepo
CurrentAST Parser → Classes, Functions, Interfaces, Imports/Exports + Relationship Engine
Express, NestJS, FastAPI, Django, Spring Boot
docuforge serve — Dashboard, graphs, explorers
Extension + AI Assistant (explain, onboarding, drift detection)
Karena Generic Scanner sudah berhasil jalan, jangan loncat ke VS Code atau AI dulu.
Dengan milestone yang baru tercapai, DocuForge sudah resmi berubah dari “Laravel documentation tool” menjadi “universal documentation engine” secara arsitektur. Generic fallback adalah fondasi penting untuk itu.