lora-sys Dashboard
Visual web dashboard for any project managed by ai-engineering-harness. Dark theme, zero dependencies.
Trigger
Keywords: show dashboard, project health, evidence completeness, kanban, chaos score, quick scan, vibe signs, takeover audit, what's wrong with this repo.
Run
# First time (scaffold into project):
bash workflows/00-bootstrap.md # creates .dashboard/ + scripts/dashboard.sh
# Every time:
bash scripts/dashboard.sh # starts parser + opens :4321
Or from the main skill: Coordinator auto-starts dashboard before each workflow phase (see §10 in parent SKILL.md).
Taking over an existing repo
When you bootstrap onto a repo that already has code, run Quick Scan without
being asked and name the vibe residue out loud — specific categories and
the worst location, not just a grade. See workflows/00-bootstrap.md §"Taking
over an existing repo".
curl -s http://localhost:4321/api/quick-scan # scan
bash scripts/scan-to-issues.sh # dry-run Issue drafts
bash scripts/scan-to-issues.sh --create # file them (ask first)
Architecture
Zero external deps: Node.js http + fs + path (parser.js) + single self-contained HTML (dashboard.html).
| Component | File | Role |
|---|---|---|
| Parser + Server | templates/parser.js |
Scans project, serves JSON API |
| Dashboard UI | templates/dashboard.html |
Single HTML file, 5 views |
| Wrapper | scripts/dashboard.sh |
Starts server + opens browser |
| Scan → Issues | scripts/scan-to-issues.sh |
Groups findings into gh Issues (dry run by default) |
API endpoints
| Route | Data |
|---|---|
GET /api/health |
Project health summary |
GET /api/project-status |
PROJECT_STATUS.md parsed |
GET /api/evidence |
Evidence pack summaries |
GET /api/evidence/:id |
Full detail for one pack |
GET /api/kanban |
Issues by closed-loop stage |
GET /api/takeover-audit |
Chaos Score + issues |
GET /api/quick-scan |
Vibe-signs scan (10 detectors) |
GET / |
Serves dashboard.html |
Views
| View | Hash | Content |
|---|---|---|
| Project Dashboard | #/dashboard |
Health cards, evidence, progress |
| Evidence Detail | #/evidence/:id |
Screenshots, code blocks, reviewers |
| Kanban | #/kanban |
Now / Backlog / Blocked / Merged |
| Takeover Audit | #/takeover |
Chaos Score 0-100, categorized issues |
| Quick Scan | button on Takeover | 10 vibe-signs detectors → chaos score + top-5 |
Hand-off
After dashboard deployed, resume with $ai-engineering-harness for Issue-driven development.
Read on demand
workflows/00-bootstrap.md— scaffold into projectworkflows/01-generate.md— regenerate artifactsworkflows/02-customize.md— theme / brandingworkflows/03-quick-scan.md— one-click vibe-signs scanreferences/data-sources.md— parser file catalogreferences/parser-spec.md— API JSON contractsreferences/chaos-score-algorithm.md— 0-100 scoringtemplates/parser.js— zero-dep Node.js servertemplates/dashboard.html— single-file UI$ai-engineering-harness— sibling skill for engineering orchestration$frontend-creative— sibling for Awwwards-grade UI (this skill is NOT for creative design)