From 79c66d2c112b7880817bc41e18a5dce4920906bf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jan=20Doubravsk=C3=BD?= Date: Fri, 9 Oct 2026 08:58:50 +0200 Subject: [PATCH] sync guidelines to AGENTS v9 --- AGENTS.md | 25 +++++++++++-------------- 1 file changed, 11 insertions(+), 14 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 933fa33..d7639f6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,24 +1,21 @@ # AI Agents - Project Rules -**Document Version:** v8 (independent, incremented on structural changes) +**Document Version:** v9 (independent, incremented on structural changes) Language-agnostic rules for AI assistants (Claude Code, Cursor, Copilot, etc.). -Everything language-specific — package manager, formatter, linter, test framework, -logging library, line length, project layout — lives in the matching design document: +Everything specific — package manager, formatter, linter, test framework, logging library, +line length, project layout, interface conventions — lives in the design documents. -| Project type | Design document | -|--------------------|------------------------------------| -| Python application | `DESIGN_DOCUMENT_PYTHON.md` | -| Python library | `DESIGN_DOCUMENT_PYTHON_MODULE.md` | -| Rust application | `DESIGN_DOCUMENT_RUST.md` | -| Rust library | `DESIGN_DOCUMENT_RUST_LIB.md` | -| Godot | `DESIGN_DOCUMENT_GODOT.md` | +**Find them, do not look them up in a list:** every file matching `DESIGN_DOCUMENT*.md` in the +project root applies to this project. The suffix says what it covers — the language +(`DESIGN_DOCUMENT_PYTHON.md`), whether it is an application or a library +(`..._PYTHON_MODULE.md`), or a part of the system that has conventions of its own +(`..._WEBAPP.md`). A project carries as many as it needs and nothing collides, so no list here +needs maintaining and none can go stale. -The language is part of the file name, so a project that mixes languages carries one design document -per language and nothing collides. - -Where this file and a design document disagree, **the design document wins**. +Where this file and a design document disagree, **the design document wins**. Where two design +documents disagree, the more specific one wins for what it covers. ## First-time setup