From 3897eabfbcf457d8d1d4391b6dfbd49ca0ebdb93 Mon Sep 17 00:00:00 2001
From: John Lancaster <32917998+jsl12@users.noreply.github.com>
Date: Sun, 26 Jul 2026 17:39:42 -0500
Subject: [PATCH] authoring reference

---
 .github/instructions/authoring.instructions.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 .github/instructions/authoring.instructions.md

diff --git a/.github/instructions/authoring.instructions.md b/.github/instructions/authoring.instructions.md
new file mode 100644
index 0000000..1acc8fd
--- /dev/null
+++ b/.github/instructions/authoring.instructions.md
@@ -0,0 +1,17 @@
+---
+name: Authoring Content
+description: "Use when editing Markdown under docs/. Routes authors to the canonical docs ownership, layout, and symlink guidance."
+applyTo: 'docs/**/*.md'
+---
+
+For edits under `docs/`, use the [Authoring Guide](../../docs/authoring.md) as the entry point for content placement and contracts.
+
+For source-tree ownership, symlink, packaging, or runtime questions, follow [Source Tree Ownership](../../docs/authoring.md). Treat that section as authoritative instead of restating its guidance here.
+
+
+Primary references:
+- [Skill contract](../../docs/contracts/skill_contract.md)
+- [Prompt contract](../../docs/contracts/prompt.md)
+- [Frontmatter contract](../../docs/contracts/frontmatter.md)
+- [URI contract](../../docs/contracts/uris.md)
+- [Zensical documentation authoring skill](../../docs/skills/zensical-docs/SKILL.md)