🛠️ Update various documentation, scripts, and configuration templates to enhance clarity, functionality, and maintainability across the project

docs/authoring.md

@@ -10,6 +10,18 @@
 - Use an agent for a reusable persona with tool restrictions or handoffs.
 - Use a hook only when the behavior must be deterministic and enforced in code.
 
+## Keep Shared Resources Cheap
+
+- Reuse an existing shared resource before creating a new one.
+- Choose the cheapest sufficient primitive for the job instead of defaulting to
+  a long prompt.
+- Keep frontmatter, descriptions, and embedded examples concise.
+- Prefer targeted inputs such as a file, symbol, or command over broad repo
+  scans.
+- State the default output budget when the resource is meant to stay brief.
+- Say when the resource should not be used so it does not become a generic,
+  expensive fallback.
+
 ## Supported Creation Paths
 
 ### Repo-first