research-dashboardlisted
Install: claude install-skill JasonCodeMaker/Agentic-Research-Control-Panel
# Research Dashboard
Build and serve the human research interface without turning HTML into a second
state store. The interface is a disposable projection of the managed research
root. It must remain useful to people while staying irrelevant to agent
authority.
Read [references/dashboard-contract.md](references/dashboard-contract.md)
before changing the projection or its tests.
## Boundary
Resolve one `ResearchPaths` instance from:
1. `--research-root`, when supplied.
2. `RESEARCH_ROOT`, when set.
3. `<workspace>/.research`, otherwise.
The managed root has four distinct responsibilities:
```text
.research/
├── VERSION
├── state/ # authoritative management state and content-addressed notes
├── audit/ # authoritative command audit
├── experiments/ # durable experiment runs and outputs
└── interface/ # generated, read-only human projection
```
Treat `.research/state/` and `.research/experiments/` as inputs.
Treat `.research/interface/` as output. Agents must never recover facts from the
interface, edit it as state, or place experiment outputs inside it. Deleting the
entire interface must be safe because a build can recreate it from authority.
The projection contains HTML, CSS, JavaScript, and generated data files. It
must not contain Python files or a `scripts/` directory.
## Build
From the pipeline checkout, rebuild an existing versioned store:
```bash
python3 skills/research-dashboard/scripts/ensure_dashboard.py \
--workspace . \
build