diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 55fe7c0..d1d9fc7 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,6 +1,7 @@ # AyCode.Core — Domain Rules @repo { + name = "AyCode.Core" type = "framework" layer = 0 own-dep-repos = [] @@ -8,6 +9,7 @@ > This is the **single source of truth** for domain rules. Do not duplicate these elsewhere. > For detailed docs see: `README.md` → `docs/` +> External repos in `own-dep-repos` are fully accessible — read their source code, docs, and `.github/copilot-instructions.md` freely when you need type definitions, base classes, or context. Do not limit yourself to the current workspace. ## Key Abstractions 1. **IId** is the foundation interface — almost every entity implements it. Always preserve ID integrity. @@ -37,3 +39,4 @@ 17. **No redundant code** — before writing new logic, check whether similar methods already exist in the current context. Reuse or extract shared logic into smaller methods rather than duplicating. If an existing method does most of what you need, split it into composable parts. 18. **Keep all .md files in sync** — when you modify code and you know which .md file documents it, update that .md file too. If you notice a contradiction between code and an .md file, automatically update the .md to match the code (code is the source of truth). When fixing a reference, check other .md files that may share the same broken reference. If the root cause is at a lower layer, fix it there first. During code review, if you find useful behavior or conventions not yet documented, briefly suggest what to document and where — but do not add new content without approval. 19. **Documentation layering** — write `.md` documentation at the **defining layer** (where the code lives). Higher-layer `.md` files reference the base docs (e.g. `see AyCode.Core/docs/SIGNALR.md`) and document only project-specific overrides or extensions. Never duplicate base-layer descriptions in consumer-level docs. +20. **Do not re-read .md files** already in your context window. They only change if you modify them yourself (new content is already in context) or if the developer tells you they changed — in that case re-read them once. diff --git a/CLAUDE.md b/CLAUDE.md index b5aaf0b..6667677 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,8 +1 @@ -# AyCode.Core — Claude Code Instructions - -Before writing any code, read these files: -1. `.github/copilot-instructions.md` — Domain rules and key pitfalls (single source of truth) -2. `docs/GLOSSARY.md` — Core abstractions and terminology -3. The relevant project's `README.md` for folder-specific context - -When modifying code, update the corresponding README.md if it becomes out of sync with the code. +Always read `.github/copilot-instructions.md` first — it is the single source of truth for this repo.