From 51762df8fa2447b66562203df4e95e3528c34ad0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Beno=C3=AEt=20CORTIER?= Date: Tue, 27 Oct 2026 23:39:38 +0900 Subject: [PATCH] chore(agents): include shared intent file guidance --- AGENTS.md | 2 +- docs/intent-files.md | 3 ++- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 52232a3f73..445730a53f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,7 +2,7 @@ Start a work session with `/contribute`, which picks the delivery flow by scale ## Intent files -`INTENT.md` and `*.intent.md` files contain human-owned intent for the software. +`INTENT*.md` and `*.intent*.md` files contain human-owned intent for the software. Read all applicable intent files before modifying code. Do not create, modify, or delete intent files. If a requested change conflicts with intent, stop and surface the conflict for human resolution. diff --git a/docs/intent-files.md b/docs/intent-files.md index ca9ee187f2..1ba128de28 100644 --- a/docs/intent-files.md +++ b/docs/intent-files.md @@ -101,7 +101,7 @@ It should not become a second design specification. For example: ```md -Read all applicable `INTENT.md` and `*.intent.md` files before modifying code. +Read all applicable `INTENT*.md` and `*.intent*.md` files before modifying code. Do not create, modify, delete, or rename intent files. @@ -179,6 +179,7 @@ service/ Do not create intent files mechanically for every source file. Their presence should reflect actual human design work. +Applicable files are `INTENT*.md` in the directory and its ancestors, plus `.intent*.md` beside the named module. Applicable intent files are cumulative. A more specific file does not silently override broader intent. Contradictions require human resolution.