AGENTS.md still describes the repo as a Unity/C# migration baseline #85

New issue

Closed

opened 2026-08-06 22:57:27 +00:00 by coilyco-ops · 0 comments

coilyco-ops commented

2026-08-06 22:57:27 +00:00

Member

Problem

AGENTS.md describes a repo that no longer exists. Its opening line says "The current surface is still Unity/C#, but the end state is Rust/Bevy", and the rest follows from that premise. Verified against d890441:

Zero .cs files are tracked. git ls-files '*.cs' returns nothing, and no .csproj is tracked either. The C# decommission is recorded in docs/csharp-decommission.md.
tests.csproj does not exist, but AGENTS.md still describes it as "a retained Unity-era reference project".
Assets/ holds no source. It retains art only: materials, scenes, textures, TextMesh Pro, resources. AGENTS.md calls it "the retained Unity-era source, scenes, materials, plugins".
The LFS migration landed. AGENTS.md says not to touch .gitattributes "unless the work explicitly includes the LFS migration from issue #4", but #4 closed on 2026-07-09 and .gitattributes now carries both the LFS rules and the narrow sprite exception. The instruction guards work that is finished.
crates/ is the product, not "the active Rust workspace for the first migration slices".
ward exec test is not "the current repo verb". .ward/ward.yaml declares ten, including shell-run, shell-serve, shell-build-web, image-build, and v2-liveness.
"Do not route work through bare dotnet" is vestigial. There is no .NET surface left to route around.

Why it matters

AGENTS.md is the first thing an agent reads. Every one of these lines aims attention at a migration that finished, and two of them describe files that are gone. An agent following it treats the Rust workspace as provisional and the Unity tree as the real product, which is backwards. README.md and docs/FEATURES.md are both already accurate, so this is the odd file out in the trifecta.

Acceptance

AGENTS.md describes the current repo: a Rust/Bevy factory game with a retained inert Unity art library.
Claims about files match what is tracked. No reference to tests.csproj, Unity source under Assets/, or a pending LFS migration.
The commands section reflects the real verb surface rather than naming one verb.
The Assets/ retention constraint survives in some form, since keeping that tree inert is still a real boundary.
The simulation-owns-logic rule from #84 is preserved.
README.md and docs/FEATURES.md stay consistent.
Full Ward gate passes.
Land through direct-to-main.

## Problem `AGENTS.md` describes a repo that no longer exists. Its opening line says "The current surface is still Unity/C#, but the end state is Rust/Bevy", and the rest follows from that premise. Verified against `d890441`: - **Zero `.cs` files are tracked.** `git ls-files '*.cs'` returns nothing, and no `.csproj` is tracked either. The C# decommission is recorded in `docs/csharp-decommission.md`. - **`tests.csproj` does not exist**, but `AGENTS.md` still describes it as "a retained Unity-era reference project". - **`Assets/` holds no source.** It retains art only: materials, scenes, textures, TextMesh Pro, resources. `AGENTS.md` calls it "the retained Unity-era source, scenes, materials, plugins". - **The LFS migration landed.** `AGENTS.md` says not to touch `.gitattributes` "unless the work explicitly includes the LFS migration from issue #4", but #4 closed on 2026-07-09 and `.gitattributes` now carries both the LFS rules and the narrow sprite exception. The instruction guards work that is finished. - **`crates/` is the product**, not "the active Rust workspace for the first migration slices". - **`ward exec test` is not "the current repo verb".** `.ward/ward.yaml` declares ten, including `shell-run`, `shell-serve`, `shell-build-web`, `image-build`, and `v2-liveness`. - **"Do not route work through bare `dotnet`"** is vestigial. There is no .NET surface left to route around. ## Why it matters `AGENTS.md` is the first thing an agent reads. Every one of these lines aims attention at a migration that finished, and two of them describe files that are gone. An agent following it treats the Rust workspace as provisional and the Unity tree as the real product, which is backwards. `README.md` and `docs/FEATURES.md` are both already accurate, so this is the odd file out in the trifecta. ## Acceptance - `AGENTS.md` describes the current repo: a Rust/Bevy factory game with a retained inert Unity art library. - Claims about files match what is tracked. No reference to `tests.csproj`, Unity source under `Assets/`, or a pending LFS migration. - The commands section reflects the real verb surface rather than naming one verb. - The `Assets/` retention constraint survives in some form, since keeping that tree inert is still a real boundary. - The simulation-owns-logic rule from #84 is preserved. - `README.md` and `docs/FEATURES.md` stay consistent. - Full Ward gate passes. - Land through direct-to-main.

coilyco-ops added the

priority

autonomy

headless

labels

2026-08-06 22:57:33 +00:00

coilyco-ops referenced this issue from a commit

2026-08-06 22:58:53 +00:00

docs: describe the repo as it is, not as a migration (closes #85)

coilyco-ops closed this issue

2026-08-06 22:58:53 +00:00