From e5b54c24afdd569765b215732884bd0a8f2758a9 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Fri, 24 Apr 2026 19:11:41 -0500 Subject: docs: split Linear vs PR structure; propagate content-scope rule to Tier 1 skills Linear ticket bodies are now Problem + Fix only. PR descriptions keep the four-section format (Problem, Fix, Why this fixes it, How it was tested). Linear's GitHub integration handles the cross-link via the PR body's Linear: line. Cross-ref to the content-scope rule appended at the end of each Tier 1 skill that produces public artifacts: testing.md, arch-document, arch-decide, arch-design, review-code, respond-to-review, brainstorm, codify. Single-source the rule in commits.md, point at it from each output-producing skill. --- arch-design/SKILL.md | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'arch-design') diff --git a/arch-design/SKILL.md b/arch-design/SKILL.md index 90b58cf..744b8d0 100644 --- a/arch-design/SKILL.md +++ b/arch-design/SKILL.md @@ -243,3 +243,7 @@ After the brief is Accepted: - `arch-decide` — record each Open Decision as an ADR under `docs/adr/` - `arch-document` — expand into a full arc42-structured document under `docs/architecture/` with C4 diagrams - `arch-evaluate` — once code exists, audit it against this brief + +## Content scope + +Output this skill produces that gets committed or shared with the team must follow the *Content scope for public artifacts* rule in [`commits.md`](../claude-rules/commits.md): no local paths, no private repo names, no personal tooling references. -- cgit v1.2.3