Decouple AGENTS.md from specific tracks: keep only process, action and tracking guidance
This commit is contained in:
1 parent
13eb4e0c87
commit
6ca8bcf034
1 file changed
+16
-22
@@ -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:
|
||||||
|
|||||||
Reference in new issue
Block a user