Decouple AGENTS.md from specific tracks: keep only process, action and tracking guidance
Full build / Import + headless tests (push) Successful in 46s
Full build / Full desktop build + optional release (push) Skipped

This commit is contained in:
zwitschi committed 2026-11-03 19:16:57 +01:00
1 parent 13eb4e0c87
commit 6ca8bcf034
1 file changed
+16 -22
+16 -22
View File
@@ -28,8 +28,7 @@ The project should be developed in small, reviewable steps. Agents must keep pla
`TODO.md` is the priority source. The active order is: `TODO.md` is the priority source. The active order is:
1. unversioned development tracks (currently 3D model and local map re-evaluation, and 1. unversioned development tracks;
character development);
2. versioned release milestones, in version order; 2. versioned release milestones, in version order;
3. future/unversioned candidates and deferred work. 3. future/unversioned candidates and deferred work.
@@ -74,9 +73,6 @@ specialists the task needs:
| Style direction (stylized / low-poly / realistic) | `stylized-style`, `lowpoly-style`, `realistic-style` | | Style direction (stylized / low-poly / realistic) | `stylized-style`, `lowpoly-style`, `realistic-style` |
| Ship/no-ship review | `qa-review` | | Ship/no-ship review | `qa-review` |
The same skills cover the local map track (procedural geometry, facade kits, OSM massing,
splat reference renders) and the NPC roster work.
### Project rules that override a skill ### Project rules that override a skill
1. **The project contract wins.** `npc_base` mesh node, the 13 contract bones at their rest 1. **The project contract wins.** `npc_base` mesh node, the 13 contract bones at their rest
@@ -124,8 +120,8 @@ All planned implementation work must be represented in `TODO.md`.
- Order level-2 sections by current priority: unversioned development tracks first, then - Order level-2 sections by current priority: unversioned development tracks first, then
versioned release milestones in version order, then future/deferred work. Do not assign a versioned release milestones in version order, then future/deferred work. Do not assign a
version number to an unversioned track until it is scheduled for a release. version number to an unversioned track until it is scheduled for a release.
- Use level-3 headings (`###`) for workstreams inside a milestone (for example, `0.8.1 - Use level-3 headings (`###`) for workstreams inside a milestone. Keep the hierarchy to three
First-shift tutorial`). Keep the hierarchy to three levels: milestone → workstream → checkbox. levels: milestone → workstream → checkbox.
- Use checkbox items for each concrete task, normally under a level-3 workstream. Direct - Use checkbox items for each concrete task, normally under a level-3 workstream. Direct
checkboxes under a level-2 section are acceptable for small, single-workstream sections. checkboxes under a level-2 section are acceptable for small, single-workstream sections.
- Keep tasks small enough to complete and review independently. - Keep tasks small enough to complete and review independently.
@@ -144,32 +140,30 @@ Recommended format:
```md ```md
# TODO # TODO
## Milestone 0.8.0 — First hour and content depth ## Milestone X.Y.Z — goal and exit criterion
### 0.8.1 First-shift tutorial ### Workstream A
- [x] Write the tutorial beat sheet. - [x] Completed task.
- [-] Implement the tutorial state machine. (claimed; implementation/verification in progress) - [-] Task in progress. (claimed; implementation/verification in progress)
- [ ] Add the tutorial smoke test. - [ ] Open task.
### 0.8.2 Campaign shell ### Workstream B
- [ ] Define campaign data. - [ ] Another task.
- [ ] Persist campaign progress.
**Exit:** a first-time player completes a shift without external documentation. **Exit:** a verifiable statement of what "done" means for the milestone.
## Documentation ## Theme
- [ ] Document the test procedure in `README.md`. - [ ] A small housekeeping task with no milestone.
``` ```
Recommended `DONE.md` format: a `# DONE` heading, followed by each moved level-2 section Recommended `DONE.md` format: a `# DONE` heading, followed by each moved level-2 section
unchanged, with a completion date line under each section heading. unchanged, with a completion date line under each section heading.
Order the actual file as described in "Priority and Versioning": unversioned development tracks Order the actual file as described in "Priority and Versioning": unversioned development tracks
first (for example character and local-map development), then versioned milestones in version first, then versioned milestones in version order, then future/deferred work.
order, then future/deferred work.
### 3. Move Completed Sections to `DONE.md` ### 3. Move Completed Sections to `DONE.md`
@@ -305,8 +299,8 @@ Avoid unrelated refactors unless they are required for the task or explicitly ap
below; a changelog entry alone is not a release. below; a changelog entry alone is not a release.
- **CI is a second gate, not a substitute.** Tag builds remain automated, but the local build is - **CI is a second gate, not a substitute.** Tag builds remain automated, but the local build is
the required pre-tag check for every version. the required pre-tag check for every version.
- **Unversioned tracks stay unversioned.** Character, map and other development tracks do not get - **Unversioned tracks stay unversioned.** A development track does not get a placeholder
a placeholder version; the version is assigned when the work is scoped into a release. version; the version is assigned when the work is scoped into a release.
**Release Procedure** — follow these steps in order for every major, minor, or patch version **Release Procedure** — follow these steps in order for every major, minor, or patch version
increment: increment: