docs: refresh agent guidance (async/Postgres) + add CLAUDE.md importers#32
Merged
Conversation
…UDE.md Update the generated project's AGENTS.md to match the current standard: async end-to-end (ADR 0017), PostgreSQL/pgvector default with SQLite optional (ADR 0018), and the unit+e2e coverage gate vs the separate Dockerized integration tier (ADR 0019), plus make cover/integration verification. Add a generated CLAUDE.md that imports AGENTS.md so Claude Code auto-loads the same guidance (per the official memory docs; Claude Code reads CLAUDE.md, not AGENTS.md), and a root CLAUDE.md that imports CONTRIBUTING.md for agents working on the template itself. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Brings the agent-facing docs in line with the async/Postgres/test-tier decisions and makes them discoverable by Claude Code.
template/AGENTS.mdrefreshed for ADR 0017 (async end-to-end; domain stays sync), ADR 0018 (PostgreSQL/asyncpg default, SQLite/aiosqlite optional, pgvector via migration), and ADR 0019 (100% gate from unit+e2e; integration is marked, Dockerized, excluded from coverage, separate CI). Verification now listsmake cover/make integration.template/CLAUDE.mdimportsAGENTS.mdvia@AGENTS.md— Claude Code auto-loads only CLAUDE.md (confirmed against the official memory docs), so this gives it the same guidance with no duplication while AGENTS.md stays canonical for other tools.CLAUDE.mdimportsCONTRIBUTING.mdfor agents working on the template itself (edit undertemplate/, use Copier vars, bake to validate).Bake matrix green (4 combos, 100% offline gate).
🤖 Generated with Claude Code