chore: update chatd ARCHITECTURE.md guidance in AGENTS.md (#28103)

Update the guidance related to chatd's `ARCHITECTURE.md` to avoid
AI-slop in the document.
This commit is contained in:
Hugo Dutka
2026-08-13 13:19:41 +02:00
committed by GitHub
parent b2c70590db
commit bfa937a36a
+6 -3
View File
@@ -88,9 +88,12 @@ instructions focused on guardrails that agents should see immediately.
use RFC-compliant errors such as `writeOAuth2Error(...)`, and public
endpoints that need system access should use `dbauthz.AsSystemRestricted`.
- **Chatd**: consult [Chatd Architecture](coderd/x/chatd/ARCHITECTURE.md) to
understand the architecture of the chatd subsystem. If you update the
chatd subsystem in ways that affect the architecture, you must update the
architecture document.
understand the architecture of the chatd subsystem. If the chatd subsystem
is changed in ways that affect the architecture, the architecture document
must be updated. You must not do it yourself though: leave TODO items in
sections that need to be added or updated, but the actual changes must be
made by a human - the PR author. That ensures the architecture document
remains clear and readable to other humans.
- **API design**: Follow the API guardrails in
[Development Workflows and Guidelines](.claude/docs/WORKFLOWS.md),
including swagger annotations for new public HTTP endpoints.