diff --git a/AGENTS.md b/AGENTS.md index 52232a3f7..445730a53 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 ca9ee187f..1ba128de2 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.