From 18bc4f22d38ec95f4ed5e2c746f37b5b0f6f371a Mon Sep 17 00:00:00 2001 From: alexsoyes Date: Thu, 1 Oct 2026 06:52:59 +0800 Subject: [PATCH] docs(aidd-context): shorten repeated file citations --- .../skills/04-skill-generate/references/skill-authoring.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugins/aidd-context/skills/04-skill-generate/references/skill-authoring.md b/plugins/aidd-context/skills/04-skill-generate/references/skill-authoring.md index 9170aefa1..6072deba5 100644 --- a/plugins/aidd-context/skills/04-skill-generate/references/skill-authoring.md +++ b/plugins/aidd-context/skills/04-skill-generate/references/skill-authoring.md @@ -36,5 +36,5 @@ The contract every generated skill satisfies. `skill-generate` obeys it too. ## Across all of them - **R17.** One fact, one home. An action acts within a router rule and cites a shared reference, never restating either. -- **R18.** A citation is a relative markdown link, `[name](path)`, never an `@` include: nothing resolves those. It sits in the sentence that uses it, a `## Process` step to read the file, an `## Output` or `## Test` line to conform to it. Never a block or a line of its own. +- **R18.** The first citation of a file in each authoring file is a relative Markdown link, `[name](path)`, except for sibling references under R14. Repeat mentions within the same file use only the filename in backticks when unambiguous; retain the link when ambiguous. Never an `@` include: nothing resolves those. A citation sits in the sentence that uses it, a `## Process` step to read the file, an `## Output` or `## Test` line to conform to it. Never a block or a line of its own. - **R19.** One file, one artifact. Split two apart only when a path needs one without the other.