Skip to content

Commit 22edd5f

Browse files
committed
chore: simplify Nova agent policy
1 parent da58039 commit 22edd5f

6 files changed

Lines changed: 44 additions & 68 deletions

File tree

.agent-protocols.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,6 @@
9797
],
9898
"exceptions": [],
9999
"overlay": {
100-
"sha256": "bc9259b39146436878e6a5ad0c0678ff9e79a84dbbb9b73503427821f420a835"
100+
"sha256": "81d378f1e1c94abe00de964c34985bd4187a94583985e5ce0fdead8a2251b002"
101101
}
102102
}

.agent-protocols.local.md

Lines changed: 19 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,8 @@ fewest practical lines of code and the simplest ownership model.
55

66
### Nova Boundary
77

8-
Use contract-driven, check-backed development rather than mechanically porting
9-
main Yazelix. Review the current Yazelix sources of truth and decide explicitly
10-
what survives.
8+
Do not mechanically port main Yazelix. Review the current Yazelix sources of
9+
truth and decide explicitly what survives.
1110

1211
Current runtime chain:
1312

@@ -16,10 +15,8 @@ yzx -> Mars -> Yazelix Zellij fork
1615
```
1716

1817
The project interface is a Nix/Lix-compatible flake. `yzx` is the installed
19-
command name. Avoid local compatibility shims and generated fixtures unless a
20-
chosen contract requires them. Do not broaden Home Manager, layouts, config
21-
generation, plugins, pane policy, or legacy compatibility unless the user
22-
chooses that scope.
18+
command name. Do not broaden Home Manager, layouts, config generation, plugins,
19+
pane policy, or legacy compatibility unless the user chooses that scope.
2320

2421
### Git Channels
2522

@@ -40,8 +37,6 @@ accepted and verified for `main`, advance `main` to that exact revision with:
4037
git push origin <sha>:main
4138
```
4239

43-
Never promote `stable` directly from `edge`.
44-
4540
`stable` is the promotion-only user channel. Advance it only when the user
4641
explicitly requests promotion. A candidate must be a fast-forward from the
4742
current `stable`, belong to `main`, pass the protected Linux and cache checks,
@@ -53,25 +48,12 @@ known P0 or P1 regression. Promote the exact verified revision with:
5348
git push origin <sha>:stable
5449
```
5550

56-
Never force-push or delete `stable`.
57-
58-
Rollbacks use a new revert commit on `edge`, followed by normal verification and
59-
fast-forward promotion through `main` and then `stable`.
60-
61-
### Runtime Delivery
62-
63-
After changing the flake runtime, keep the user's installed runtime current:
64-
65-
```sh
66-
nix profile upgrade --refresh yazelix
67-
```
68-
69-
Do not launch GUI sessions unless the user asks or reports manual dogfooding.
51+
Never delete `stable`.
7052

7153
### Beads
7254

73-
Use `br` for all issue work and never edit `.beads/` files directly. Serialize
74-
`br` writes and finish with `br sync --flush-only`.
55+
Use `br` for all issue work. Serialize writes and finish with
56+
`br sync --flush-only`.
7557

7658
Use `bv --robot-triage` as the graph-aware planning entry point. Use only
7759
`bv --robot-*` commands; bare `bv` opens an interactive TUI. `bv` decides what
@@ -84,19 +66,25 @@ Update the README LOC scorecard whenever project files change. Update
8466
`CHANGELOG.md` when user-visible runtime behavior, commands, keymaps, packaged
8567
tools, or runtime contracts change.
8668

87-
Prefer deleting scope, avoiding abstractions, and reusing existing package
88-
outputs over adding local wrappers. If LOC grows, make the added behavior
89-
visible in the scorecard and justify it. Formatting rules outrank LOC pressure;
90-
for Rust, keep `rustfmt` output rather than compressing code manually.
69+
If LOC grows, make the added behavior visible in the scorecard and justify it.
70+
Formatting rules outrank LOC pressure; for Rust, keep `rustfmt` output rather
71+
than compressing code manually.
9172

9273
### Nova Verification
9374

94-
Run the cheapest exact checks for the changed surface. For runtime flake
95-
changes, normally verify:
75+
For runtime flake changes, normally verify:
9676

9777
```sh
9878
nix flake check
9979
nix flake show --all-systems
10080
nix build .#yazelix --no-link --print-build-logs
10181
nix profile add --refresh /home/lucca/pjs/yazelix-dir/yazelix --profile <tmp>
10282
```
83+
84+
After changing the flake runtime, keep the user's installed runtime current:
85+
86+
```sh
87+
nix profile upgrade --refresh yazelix
88+
```
89+
90+
Do not launch GUI sessions unless the user asks or reports manual dogfooding.

.beads/issues.jsonl

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

AGENTS.md

Lines changed: 19 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -367,9 +367,8 @@ fewest practical lines of code and the simplest ownership model.
367367

368368
### Nova Boundary
369369

370-
Use contract-driven, check-backed development rather than mechanically porting
371-
main Yazelix. Review the current Yazelix sources of truth and decide explicitly
372-
what survives.
370+
Do not mechanically port main Yazelix. Review the current Yazelix sources of
371+
truth and decide explicitly what survives.
373372

374373
Current runtime chain:
375374

@@ -378,10 +377,8 @@ yzx -> Mars -> Yazelix Zellij fork
378377
```
379378

380379
The project interface is a Nix/Lix-compatible flake. `yzx` is the installed
381-
command name. Avoid local compatibility shims and generated fixtures unless a
382-
chosen contract requires them. Do not broaden Home Manager, layouts, config
383-
generation, plugins, pane policy, or legacy compatibility unless the user
384-
chooses that scope.
380+
command name. Do not broaden Home Manager, layouts, config generation, plugins,
381+
pane policy, or legacy compatibility unless the user chooses that scope.
385382

386383
### Git Channels
387384

@@ -402,8 +399,6 @@ accepted and verified for `main`, advance `main` to that exact revision with:
402399
git push origin <sha>:main
403400
```
404401

405-
Never promote `stable` directly from `edge`.
406-
407402
`stable` is the promotion-only user channel. Advance it only when the user
408403
explicitly requests promotion. A candidate must be a fast-forward from the
409404
current `stable`, belong to `main`, pass the protected Linux and cache checks,
@@ -415,25 +410,12 @@ known P0 or P1 regression. Promote the exact verified revision with:
415410
git push origin <sha>:stable
416411
```
417412

418-
Never force-push or delete `stable`.
419-
420-
Rollbacks use a new revert commit on `edge`, followed by normal verification and
421-
fast-forward promotion through `main` and then `stable`.
422-
423-
### Runtime Delivery
424-
425-
After changing the flake runtime, keep the user's installed runtime current:
426-
427-
```sh
428-
nix profile upgrade --refresh yazelix
429-
```
430-
431-
Do not launch GUI sessions unless the user asks or reports manual dogfooding.
413+
Never delete `stable`.
432414

433415
### Beads
434416

435-
Use `br` for all issue work and never edit `.beads/` files directly. Serialize
436-
`br` writes and finish with `br sync --flush-only`.
417+
Use `br` for all issue work. Serialize writes and finish with
418+
`br sync --flush-only`.
437419

438420
Use `bv --robot-triage` as the graph-aware planning entry point. Use only
439421
`bv --robot-*` commands; bare `bv` opens an interactive TUI. `bv` decides what
@@ -446,19 +428,25 @@ Update the README LOC scorecard whenever project files change. Update
446428
`CHANGELOG.md` when user-visible runtime behavior, commands, keymaps, packaged
447429
tools, or runtime contracts change.
448430

449-
Prefer deleting scope, avoiding abstractions, and reusing existing package
450-
outputs over adding local wrappers. If LOC grows, make the added behavior
451-
visible in the scorecard and justify it. Formatting rules outrank LOC pressure;
452-
for Rust, keep `rustfmt` output rather than compressing code manually.
431+
If LOC grows, make the added behavior visible in the scorecard and justify it.
432+
Formatting rules outrank LOC pressure; for Rust, keep `rustfmt` output rather
433+
than compressing code manually.
453434

454435
### Nova Verification
455436

456-
Run the cheapest exact checks for the changed surface. For runtime flake
457-
changes, normally verify:
437+
For runtime flake changes, normally verify:
458438

459439
```sh
460440
nix flake check
461441
nix flake show --all-systems
462442
nix build .#yazelix --no-link --print-build-logs
463443
nix profile add --refresh /home/lucca/pjs/yazelix-dir/yazelix --profile <tmp>
464444
```
445+
446+
After changing the flake runtime, keep the user's installed runtime current:
447+
448+
```sh
449+
nix profile upgrade --refresh yazelix
450+
```
451+
452+
Do not launch GUI sessions unless the user asks or reports manual dogfooding.

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -359,6 +359,6 @@ See [Development](docs/development.md) for CI and local checks,
359359

360360
## LOC Scorecard
361361

362-
Yazelix owns **26,364 lines** of tracked text project files. The
362+
Yazelix owns **26,340 lines** of tracked text project files. The
363363
[reproducible scorecard](docs/development.md#loc-scorecard) excludes Beads,
364364
lockfiles, and binary assets.

docs/development.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ contain no Linux desktop entry. The flake advertises the optional Yazelix
1717
Cachix cache, while source builds remain valid without it. Use Version Gate
1818
before publishing a release
1919

20-
## Main, stable, and edge
20+
## Edge, main, and stable
2121

2222
All development commits land on `edge`, including fixes, reverts,
2323
documentation, and Beads updates. CI runs there, and users who select `edge`
@@ -109,7 +109,7 @@ git ls-files | grep -Ev '^\.beads/|\.lock$|^assets/' | xargs wc -l
109109
| --- | ---: |
110110
| Ignore (`.gitignore`) | 19 |
111111
| License | 201 |
112-
| Markdown | 3339 |
112+
| Markdown | 3315 |
113113
| JSON | 106 |
114114
| Nix | 1606 |
115115
| Shell | 84 |
@@ -120,4 +120,4 @@ git ls-files | grep -Ev '^\.beads/|\.lock$|^assets/' | xargs wc -l
120120
| Lua | 245 |
121121
| Rust | 19540 |
122122
| Text | 41 |
123-
| Total | 26364 |
123+
| Total | 26340 |

0 commit comments

Comments
 (0)