andwati/zitadel
1
0
Fork 0
mirror of https://github.com/andwati/zitadel.git synced 2026-11-03 12:52:16 +00:00
Code Issues Packages Projects Releases Wiki Activity

chore(agents): add agents files (#11497)

Browse Source
This commit is contained in:
Florian Forster
2026-02-16 20:45:53 -08:00
committed by GitHub
parent 61756af7f7
commit db9ebbbb41
13 changed files with 263 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
internal/AGENTS.md
+20
View File
@@ -0,0 +1,20 @@
# ZITADEL Internal Backend Guide for AI Agents
## Context
`internal/` contains core backend domain logic for ZITADEL: commands, queries, repositories, eventstore integration, API service layers, and supporting infrastructure.
## Source of Truth
- **Go Toolchain**: Inspect root `go.mod` before Go work.
- **Architecture Pattern**: Relational data is the system of record; keep existing event writes that provide history/audit trails.
- **API Contract**: For API-facing schema decisions, follow `API_DESIGN.md` and `proto/AGENTS.md`.
## Boundary Rules
- Prefer implementing business behavior in command/query layers and repository packages, not in transport handlers.
- Avoid bypassing established event/repository flows with ad-hoc direct persistence patterns.
- Keep API/service adapters thin; place reusable domain behavior in internal domain packages.
## Validation Workflow
- Use API project targets to validate backend changes:
- `pnpm nx run @zitadel/api:lint`
- `pnpm nx run @zitadel/api:test-unit`
- `pnpm nx run @zitadel/api:test-integration`