docs(agents): rewrite package map and conventions for Veect

AGENTS.md now describes the Veect control plane (ADR-027/028/029,
docs/product/ authority table, glossary Veect-domain vocabulary), with
the package map, boundary tags, and per-package conventions verified
against the filesystem (auth + 11 core + 3 tooling packages;
web-next/cms/storybook apps) and code examples drawn from the real auth
feature. Adds warning notes for known generator staleness — the
release-please per-feature registration that would collide with the
root-only v* tag policy, the pre-shipped trace overwrite hazard (zod
incident, restored in e4a3b65), the trpc template's removed
@trpc/react-query dep — and records the accepted warn-severity lint
backlog (~93 findings).

Per story amendments, the same slice prunes the dead "web-tanstack"
member from core-shared's app-tag unions (bind-otel-instrumentation.ts,
sentry/init-client.ts; tests retargeted to "web-next") and fixes the
stale app/feature tag lists in docs/architecture/overview.md. A warning
comment mirrors the release-please note at the generator call site; no
functional generator changes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016j8z4VHjedXDTjEDNg7qHK
This commit is contained in:
2026-07-12 21:06:38 +02:00
parent d7534b9926
commit 46250c819f
8 changed files with 220 additions and 139 deletions

View File

@@ -328,6 +328,15 @@ export default function generator(plop: PlopTypes.NodePlopAPI): void {
// Adds an entry to .release-please-manifest.json and a per-package
// block to release-please-config.json. Idempotent + sorted so reruns
// are stable. Throws if either file is missing.
//
// WARNING (ADR-027 retrofit): this repo now tracks a SINGLE root
// product version with plain `v*` tags (see release-please-config.json
// — only "." is tracked). This step still registers the new feature as
// a per-package release-please component, whose component-prefixed tags
// would collide with the root-only `v*` policy. Until the generator is
// updated, revert the changes this step makes to
// release-please-config.json / .release-please-manifest.json after
// scaffolding. See AGENTS.md § "Adding a Feature".
function registerInReleasePlease(
answers: Record<string, unknown>,
): string {