HWLAB Code Queue
68 lines
2.3 KiB
Markdown
68 lines
2.3 KiB
Markdown
# HWLAB Commander Collaboration Reference
|
|
|
|
This reference defines stable commander, runner, branch, and prompt handoff
|
|
rules.
|
|
|
|
## Worktree Rules
|
|
|
|
- Use `/workspace/hwlab` as the normal runner and commander worktree.
|
|
- Start by checking the branch and working tree status.
|
|
- Keep D601 publishing and rollout work in `/home/ubuntu/workspace/hwlab`.
|
|
- Do not clean, reset, or reuse unrelated runner worktrees for publishing.
|
|
|
|
## Branch And PR Workflow
|
|
|
|
- Create a short branch from latest `origin/main`.
|
|
- Do not push directly to `main`.
|
|
- Do not change PROD.
|
|
- Do not restart services unless a task explicitly authorizes it.
|
|
- Open a PR against `pikasTech/HWLAB:main`.
|
|
- Do not merge the PR from the runner.
|
|
- Let the commander review complex conflicts; runners should not perform broad
|
|
conflict surgery unless explicitly assigned.
|
|
|
|
## Prompt Contract
|
|
|
|
Every HWLAB runner task should be self-contained. Include:
|
|
|
|
- repository and worktree path;
|
|
- branch base and target PR branch;
|
|
- objective and linked issue context;
|
|
- current stable constraints, especially `DC-DCSN-P0-2026-003` when relevant;
|
|
- forbidden actions;
|
|
- acceptance criteria;
|
|
- exact validation commands;
|
|
- final response requirements.
|
|
|
|
Do not assume the runner can read issue comments. When issue/PR visibility is
|
|
needed, run:
|
|
|
|
```sh
|
|
node scripts/runner-issue-visibility-preflight.mjs
|
|
```
|
|
|
|
Use [runner-issue-visibility-handoff.md](runner-issue-visibility-handoff.md)
|
|
as the detailed prompt handoff contract.
|
|
|
|
## Review Guardrails
|
|
|
|
During review, reject outputs that:
|
|
|
|
- use SOURCE, LOCAL, DRY-RUN, fixtures, edge-only health, or front-end state as
|
|
DEV-LIVE;
|
|
- bypass `hwlab-patch-panel` for M3;
|
|
- use UniDesk runtime as a substitute for HWLAB runtime;
|
|
- put Gate or diagnostics back as the default Cloud Web homepage;
|
|
- use legacy public `:6666` or `:6667` as current DEV entry points.
|
|
|
|
## Stable Sources
|
|
|
|
- [pikasTech/HWLAB#7](https://github.com/pikasTech/HWLAB/issues/7): current
|
|
commander board.
|
|
- [pikasTech/HWLAB#78](https://github.com/pikasTech/HWLAB/issues/78): M3
|
|
prompt and review constraints.
|
|
- [pikasTech/HWLAB#109](https://github.com/pikasTech/HWLAB/issues/109):
|
|
documentation governance task.
|
|
- [runner-issue-visibility-handoff.md](runner-issue-visibility-handoff.md):
|
|
detailed runner visibility and prompt handoff.
|