How stuinfla/repo-explainer works
explainmyrepo turns a GitHub repository into a quality-gated explainer page, an editable GitHub repository, and an AI knowledge pack. Its principal workflow runs from repository submission through cloning, source understanding, creative direction, authoring, visualization, assembly, grading, and deployment. The README documents this sequence and the major capabilities; sampled source supports the shared build context, knowledge-base query path, and diagram generation, but does not expose every station’s implementation.
Main entry points: orchestrator.mjs Station orchestrator · build-kb.mjs Knowledge-base builder · deploy.mjs Deploy gate · brain.mjs Explainer authoring
Components 20
Build orchestration
- Build runner
bin/agentic-runner.mjs - Station orchestrator
src/orchestrator.mjs - Build context
src/build-context.mjs
Repository understanding
- Repository clone
tools/clone-repo.mjs - Knowledge-base builder
kb/build-kb.mjs - Source analysis
kb - Grounded primer
kb/index-primer.mjs
Explainer creation
- Concept tournament
tools/concept-tournament.mjs - Explainer authoring
src/brain.mjs - Visual generation
tools/make-diagrams.mjs - Page and pack
tools/assemble-page.mjs
Quality and delivery
- Quality grading
tools/quality-grade.mjs - Refinement loop
src/orchestrator.mjs - Deploy gate
tools/deploy.mjs - Repo publishing
tools/publish-repo.mjs - Three build artifacts
Other components
- Repository submitter
- Target repository
- Model services
- Hosting service
Connections 26
- Repository submitter → Build runner: submits repo
- Build runner → Station orchestrator: starts build
- Station orchestrator → Build context: updates slots
- Station orchestrator → Repository clone: dispatches clone
- Repository clone → Target repository: clones source
- Station orchestrator → Knowledge-base builder: dispatches build
- Knowledge-base builder → Source analysis: extracts structure
- Knowledge-base builder → Grounded primer: authors primer
- Station orchestrator → Concept tournament: dispatches contest
- Concept tournament → Model services: requests pitches
- Station orchestrator → Explainer authoring: dispatches authoring
- Explainer authoring → Model services: generates content
- Station orchestrator → Visual generation: dispatches visuals
- Visual generation → Model services: generates imagery
- Station orchestrator → Page and pack: dispatches assembly
- Page and pack → Three build artifacts: writes page and pack
- Station orchestrator → Quality grading: dispatches grading
- Station orchestrator → Refinement loop: runs refine loop
- Refinement loop → Explainer authoring: re-authors weak copy
- Refinement loop → Page and pack: reassembles page
- Refinement loop → Quality grading: regrades build
- Station orchestrator → Deploy gate: dispatches deploy
- Deploy gate → Hosting service: deploys and verifies
- Station orchestrator → Repo publishing: dispatches publishing
- Repo publishing → Three build artifacts: publishes explainer repo
- Deploy gate → Three build artifacts: returns live page