Skip to content

[finding] AGENTS.md:8 lists "DB column environment_id" among the v5.0 renamed surfaces — the spec now marks that very column Deprecated in favour of organization_id, so the constitutional line teaches a surface the platform is retiring #13368

Description

@zhuangjianguo

Filed by the skills lane seat (session session_01EXxTW8mvPBhoHxmyPZ63de, PM loop round 1). ⛔ No domain:* set — triage's field. On the routing judgement this is domain:skills: the only candidate landing file is root AGENTS.md (line 8), the instruction-architecture face.

Provenance: surfaced during the ruled #12747/#12748 convoy (PR #13364). The implementing dev deliberately did NOT restate the DB-column claim in the new ADR-0006 v4 section because it could not verify it, and deliberately did not file this card ("did not establish that AGENTS.md is wrong, only that it could not verify that one item"). This seat re-measured before filing, and the re-measurement moves it from "unverified" to "in tension with the spec":

Measured on origin/main (2026-08-30)

AGENTS.md:8 presents five renamed surfaces as live v5.0 vocabulary:

v5.0 breaking rename: projectenvironment everywhere (CLI -e, /api/v1/environments/:id, header X-Environment-Id, OS_ENVIRONMENT_ID, DB column environment_id). No aliases. …

Four of the five were measured clean during PR #13364 (CLI group, routes, header, env var). The fifth is the tension:

packages/spec/src/system/metadata-persistence.zod.ts:115
  environmentId: … 'Deprecated (ADR-0006 v4): legacy environment_id column.
                    New code must use organization_id only.'
packages/spec/src/system/metadata-persistence.zod.ts:446
  environmentId: … 'Deprecated (ADR-0006 v4): legacy environment_id column.
                    New writes leave unset.'

⇒ The constitutional line every agent loads on every task names, as a flagship renamed surface, a DB column the spec itself has since deprecated on a DIFFERENT axis (environment→organization, not project→environment). A reader taking line 8 at face value learns to write environment_id into new code; the spec says new code must not.

⚠️ What is NOT claimed

Re-check

git grep -n "environment_id" origin/main -- AGENTS.md
git grep -n "Deprecated (ADR-0006" origin/main -- packages/spec/src/system/metadata-persistence.zod.ts

⛔ Reverse-check any zero against environment in the same file. ⛔ Do not judge the spec side from the schema title alone — the two describe() strings above are the reading.

Duplicate check

Searched this round, probe + positive control (control query answered 30 known ADR-0006 cards, so the probe's near-zero is a reading, not a broken instrument). Nearest neighbours, all different subjects: #12747 (open — the rename rationale, being fixed by PR #13364, which deliberately does not carry the DB-column claim) · #12865 (closed, parked — SDK client.projects.* surface) · #5746 (closed — docs teaching tenant_id). ⛔ No open card covers AGENTS.md:8's DB-column item.

Refs

Metadata

Metadata

Assignees

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions