Repository navigation
docs: refresh dx-stack guidance - #359
Conversation
…document-change skill docs/architecture.md in dx-stack is the design essay, not the port map or auth flows; those live in AGENTS.md and docs/auth.md. Also name the skill that replaced the deleted per-repo hook.
dg-coreylweathers
left a comment
There was a problem hiding this comment.
Content reviewed and verified; two fixes pushed to this branch in f794791. Approval is a separate click.
What I verified against a fresh clone of dx-stack main (4b5af9e), run in a throwaway container: every path in the table exists; AGENTS.md has the port map (L515), cross-service (L461) and deployment (L562) sections; docs/auth.md has the client table (L68) and schema sections (L354/376); hooks/check-cross-stack.sh was deleted in dx-stack 76b8bd7.
What f794791 changes:
- Rule 3 pointed at
docs/architecture.mdfor the port map, auth flows, service-to-service and environment matrix. That file is the neurosymbolic design essay and holds none of them; they live inAGENTS.md(port map, cross-service, environments) anddocs/auth.md(auth flows, L117). Now reads: ReadAGENTS.md(port map, cross-service architecture, environments, deployment) anddocs/auth.md(auth flows) in yourdx-stackcheckout for the full stack context. - Rule 2 never named what replaced the hook. dx-stack
AGENTS.md(L15-21) says docs are kept current by thedx-document-changeskill via the dx-stack MCP, and that skill describes itself as the replacement for the per-repocheck-cross-stack.shhook. Added one sentence saying so, with the table kept as the manual fallback.
Both original lines are already merged in dx-id's CLAUDE.md, so dx-id needs the same two edits.
Nit, not changed: bare seed.ts in the Redirect URI row is dx-id/apps/id/src/db/seed.ts, not a dx-stack file.
dg-coreylweathers
left a comment
There was a problem hiding this comment.
Approved. Verified against dx-stack main and the two should-fixes are on this branch; see the comment above.
Updates DX stack guidance to the current dx-stack files and structured registries.
Validation:
git diff --check.