# HWLAB Long-Term Reference

`docs/reference/` is the stable reference entry for HWLAB agents, commanders,
and runners. It records reusable rules, boundaries, commands, and acceptance
criteria. Process issues and reports remain sources; they are not copied here
as run logs.

## Reference Index

| Topic | Reference |
| --- | --- |
| Documentation governance | [documentation-governance.md](documentation-governance.md) |
| Architecture and M3 decision line | [architecture.md](architecture.md) |
| DEV runtime, ports, k3s, and environment boundary | [dev-runtime-boundary.md](dev-runtime-boundary.md) |
| Deployment regularization, artifact publish, rollback, and Cloud Web rollout | [deployment-publish.md](deployment-publish.md) |
| Cloud Workbench default UI and UX boundary | [cloud-workbench.md](cloud-workbench.md) |
| Commander, runner, PR, and prompt handoff | [commander-collaboration.md](commander-collaboration.md) |
| M3 loop rollout runbook | [m3-loop-rollout-runbook.md](m3-loop-rollout-runbook.md) |
| Runner issue visibility handoff | [runner-issue-visibility-handoff.md](runner-issue-visibility-handoff.md) |

## Current Stable Sources

- [pikasTech/HWLAB#7](https://github.com/pikasTech/HWLAB/issues/7):
  commander board, priority ordering, and current issue state.
- [pikasTech/HWLAB#78](https://github.com/pikasTech/HWLAB/issues/78):
  `DC-DCSN-P0-2026-003` M3 virtual hardware trusted-loop direction.
- [pikasTech/HWLAB#99](https://github.com/pikasTech/HWLAB/issues/99):
  Cloud Workbench default frontend direction.
- [pikasTech/HWLAB#108](https://github.com/pikasTech/HWLAB/issues/108):
  no outer page scroll, Chinese UI, and internal Markdown help page.
- [pikasTech/HWLAB#61](https://github.com/pikasTech/HWLAB/issues/61):
  DEV manual rollout review and the path toward CLI plus `deploy/deploy.json`
  automation.
- [pikasTech/HWLAB#109](https://github.com/pikasTech/HWLAB/issues/109):
  documentation governance and this reference system.
- [pikasTech/HWLAB#116](https://github.com/pikasTech/HWLAB/issues/116):
  service deployment regularization in three stages: long-term reference,
  controlled CLI/script entrypoints, and UniDesk CI/CD plus imageized delivery.

When an issue, report, or old document conflicts with a reference file here,
update the reference file first and keep `AGENTS.md` as a short index.