1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
|
# Owner-agent brief (every unit)
You are the SINGLE owner of `packages/<unit>/` — its `include/`, `src/`,
`tests/`, `meson.build`, and `<unit>.md`. Nobody else edits these files;
you edit nothing outside them.
## Visibility
- You MAY read: your unit; the PUBLIC headers of your dependencies
(`packages/*/include/**`); the harness md files; `GLOSSARY.md`; assets.
- You may NOT read other units' `src/`. Needing to means their contract is
incomplete — record the gap in your report instead of peeking.
## Contract discipline
- Your public headers ARE your contract: minimal, documented,
lifetime-explicit. `unique_ptr` = ownership transfer; raw pointer/ref =
borrow valid only for the call, never stored; subscriptions return RAII
handles.
- Doc-comment every public symbol: ownership + calling context. Everything
runs on the single `wl_event_loop` thread unless explicitly stated.
- No templates in public headers unless genuinely necessary (they drag
implementation into the contract and bloat compile times).
- Changing a header YOU own: fine, note it in the report. Needing a change
in one you DON'T own: a change-request in your report — never edit it,
never work around it with casts or string lookups.
## Code discipline
- Pure decision core (no wlroots/GL/RMLUi types) + thin glue at the edge.
doctest the core hard; zero mocks of `unbox::` modules — if you want to
mock one, the effect should have been injected: fix the design.
- Respect the budget machine: forward-declare, pimpl concrete cross-
boundary classes, keep includes lean. Build YOUR target, not the world.
- Vocabulary: `GLOSSARY.md` is law. A concept that needs a new name goes in
the report for user sign-off — never coin silently.
## Done means
`ninja -C build <unit-target>` clean · `meson test -C build --suite <unit>`
green · `reports/<unit>.md` written (what you built, the public surface,
test output, contract gaps / change-requests). Reply to the orchestrator
with ONE line + the report path. No diffs, no logs.
|
