flygard/flygard-core
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
flygard-core/.agents/docs
History
sudlud 86d4871491
chore(copilot-config): reduce review noise (#27084)
2026-08-10 12:51:44 +02:00
..
build.md feat(Agents): structure agents docs with progressive disclosure (#26946) 2026-08-04 09:25:52 +02:00
code-review.md chore(copilot-config): reduce review noise (#27084) 2026-08-10 12:51:44 +02:00
cpp-guidelines.md docs(Agents): add script, SQL and config conventions (#27045) 2026-08-08 16:28:19 -03:00
cpp-scripts.md docs(Agents): add script, SQL and config conventions (#27045) 2026-08-08 16:28:19 -03:00
README.md feat(Agents): structure agents docs with progressive disclosure (#26946) 2026-08-04 09:25:52 +02:00
self-review-rules.md docs(Agents): add code review guidance (#27053) 2026-08-09 17:00:20 +02:00
sql-guidelines.md docs(Agents): add script, SQL and config conventions (#27045) 2026-08-08 16:28:19 -03:00

README.md

.agents/docs

Task-scoped agent guidance, routed from AGENTS.md's "Mandatory reading per task". Keep every doc compact and agent-agnostic.

Taxonomy

  • Root — task-type docs (build.md, cpp-guidelines.md, sql-guidelines.md, …), kebab-case. <lang>-<topic>.md is reserved for language-scoped specializations (e.g. cpp-scripts.md).
  • systems/ — cross-language subsystem docs, plain kebab-case subsystem names (e.g. battleground.md).

Placing new guidance

  • The most specific applicable doc wins.
  • Generic language lesson → the language doc (e.g. generic C++ → cpp-guidelines.md).
  • Subsystem-specific lesson → systems/<subsystem>.md; create it if missing.
  • Extend an existing doc before creating a new one.
  • A new doc REQUIRES adding its routing bullet to AGENTS.md's "Mandatory reading per task" in the same change.