release: v0.5.0 — pin skill version to anc CLI version

.github/ISSUE_TEMPLATE/00-blank.yml

@@ -0,0 +1,35 @@
+name: "Blank issue"
+description: "Open an issue that doesn't fit any of the structured templates below."
+body:
+  - type: textarea
+    id: body
+    attributes:
+      label: Issue
+      description: "Describe what's going on. Include the bundle file (`SKILL.md`, `getting-started.md`, `templates/<file>`, `references/<file>`), the host runtime (Claude Code / Cursor / Codex / OpenCode), and any specific invocation or content that the issue touches."
+    validations:
+      required: true
+  - type: textarea
+    id: ai-disclosure
+    attributes:
+      label: AI disclosure
+      description: "One sentence: what part of this issue was AI-written, what was human-written?"
+      placeholder: "Entirely human-written."
+    validations:
+      required: true
+  - type: textarea
+    id: agent-instructions
+    attributes:
+      label: For agents
+      description: "Agents: expand this section before filing."
+      value: |
+        <details>
+        <summary>Agent filing instructions</summary>
+
+        1. **Pick a structured template first.** Bundle bugs and bundle proposals have dedicated forms — use them when they fit.
+        2. **Search first.** Run `gh search issues --repo brettdavies/agentnative-skill "<keywords>"` to check for duplicates.
+        3. **AI disclosure is required.** Fill the field above honestly.
+        4. **Wrong repo?** Spec questions, principle edits, and grading findings live on [brettdavies/agentnative](https://github.com/brettdavies/agentnative). `anc` auditor bugs and tool-registry submissions live on [brettdavies/agentnative-cli](https://github.com/brettdavies/agentnative-cli). Site bugs live on [brettdavies/agentnative-site](https://github.com/brettdavies/agentnative-site).
+        5. See [CONTRIBUTING.md](https://github.com/brettdavies/agentnative-skill/blob/main/CONTRIBUTING.md) for full guidelines.
+        </details>
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,95 @@
+name: "Bundle bug"
+description: "Report a bug in the skill bundle (stale example, broken link, contradiction with the spec, drift in `getting-started.md`)."
+title: "bug: <short description>"
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **Route check before filing:**
+
+        - For bugs in `anc` (the auditor itself — wrong scorecard, missing check, false positive), file on the
+          [linter repo](https://github.com/brettdavies/agentnative-cli/issues/new/choose).
+        - For substantive principle changes (new principles, MUST/SHOULD/MAY tier changes), file on the
+          [spec repo](https://github.com/brettdavies/agentnative/issues/new/choose).
+        - This tracker is for skill-bundle bugs: stale templates, broken links, wrong invocations in
+          `getting-started.md`, drift between vendored spec and other bundle docs, etc.
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened
+      description: "One or two sentences. Include the file, the cited example, and the unexpected behavior."
+    validations:
+      required: true
+  - type: textarea
+    id: what-expected
+    attributes:
+      label: What you expected
+      description: "One sentence — what should the bundle have said or done instead?"
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: How to reproduce
+      description: "Numbered steps + exact commands or quoted bundle content. Redact paths and credentials."
+      placeholder: |
+        1.
+        2.
+        3.
+
+        ```bash
+        # exact commands
+        ```
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: "Bundle version, pinned spec version, host runtime, `anc --version` if relevant, OS and shell."
+      placeholder: |
+        - Bundle version (`cat VERSION` if cloned, or the tag you installed): vX.Y.Z
+        - Pinned spec version (`cat spec/VERSION`): vX.Y.Z
+        - Host (Claude Code / Cursor / Codex / OpenCode / other):
+        - `anc --version` (if a workflow involving anc is at issue):
+        - OS and shell:
+    validations:
+      required: true
+  - type: textarea
+    id: why-bundle-bug
+    attributes:
+      label: Why this is a bundle bug (not spec or anc)
+      description: |
+        Optional but useful. If a getting-started flow doesn't work, explain whether the breakage is in this bundle's
+        prose (fixable here) vs. in `anc`'s behavior (file in agentnative-cli) vs. in the principle text itself
+        (file in agentnative-spec).
+    validations:
+      required: false
+  - type: textarea
+    id: ai-disclosure
+    attributes:
+      label: AI disclosure
+      description: "One sentence: what part of this report was AI-written, what was human-written?"
+      placeholder: "Reproduction observed by hand; analysis section was AI-assisted."
+    validations:
+      required: true
+  - type: textarea
+    id: agent-instructions
+    attributes:
+      label: For agents
+      description: "Agents: expand this section before filing."
+      value: |
+        <details>
+        <summary>Agent filing instructions</summary>
+
+        1. **Search first.** Run `gh search issues --repo brettdavies/agentnative-skill "<keywords>"` to check for
+           duplicates.
+        2. **Route check.** Verify this is a skill-bundle bug, not an `anc` auditor bug (file in agentnative-cli) or
+           a spec issue (file in agentnative).
+        3. **AI disclosure is required.** Fill the field above honestly.
+        4. See [CONTRIBUTING.md](https://github.com/brettdavies/agentnative-skill/blob/main/CONTRIBUTING.md) for full
+           guidelines.
+        </details>
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/bundle-proposal.yml

@@ -0,0 +1,108 @@
+name: "Bundle proposal"
+description: "Propose a new template, reference doc, getting-started flow, or other change to the skill bundle."
+title: "proposal: <short description>"
+labels: ["proposal"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **Route check before filing:**
+
+        - New principle, MUST/SHOULD/MAY tier change, or any substantive change to the standard itself → file on
+          the [spec repo](https://github.com/brettdavies/agentnative/issues/new/choose). This skill bundle vendors
+          the spec; principle changes happen there first, then arrive here via `scripts/sync-spec.sh`.
+        - New compliance audit, change to scorecard semantics, or anything `anc audit` does → file on the
+          [linter repo](https://github.com/brettdavies/agentnative-cli/issues/new/choose).
+        - New starter template, reference doc, getting-started flow, idiom for a new language/framework, or any
+          change to how this bundle teaches the existing principles → keep filing here.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement
+      description: |
+        What is the problem this proposal addresses? Be specific about which agent's workflow it would improve.
+        Cite real tools, real PRs, or real `anc` findings where relevant.
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposal
+      description: |
+        One paragraph: what should the bundle do that it does not do today? Frame as a concrete change to one or
+        more of: `SKILL.md`, `getting-started.md`, `references/<file>`, `templates/<file>`.
+    validations:
+      required: true
+  - type: checkboxes
+    id: change-type
+    attributes:
+      label: Type of change
+      options:
+        - label: "New starter template under `templates/`"
+        - label: "New reference doc under `references/`"
+        - label: "Update to `SKILL.md` (entry-point structure or routing)"
+        - label: "Update to `getting-started.md` (new flow, new invocation)"
+        - label: "Idioms for a new language/framework in `references/framework-idioms-other-languages.md`"
+        - label: "Other (describe in the Proposal section)"
+  - type: textarea
+    id: prior-art
+    attributes:
+      label: Prior art
+      description: "Existing tools, docs, or articles that demonstrate the problem or the proposed solution. Two or three is fine."
+    validations:
+      required: false
+  - type: textarea
+    id: draft
+    attributes:
+      label: Draft of the change
+      description: |
+        Sketch what the relevant bundle file(s) would look like after the change. A diff against the current state
+        is ideal; an outline is acceptable for early-stage proposals.
+      placeholder: |
+        ```diff
+        <!-- <file> -->
+        ```
+    validations:
+      required: false
+  - type: checkboxes
+    id: compatibility
+    attributes:
+      label: Compatibility
+      options:
+        - label: "Additive — no existing bundle content needs to change"
+        - label: "Replaces existing content (list what gets removed/superseded in the Open questions section)"
+        - label: "Coordinated with a spec or anc change (link the upstream issue/PR in the Open questions section)"
+  - type: textarea
+    id: open-questions
+    attributes:
+      label: Open questions
+      description: "Anything you're unsure about. Decisions to make in the issue thread before any PR."
+    validations:
+      required: false
+  - type: textarea
+    id: ai-disclosure
+    attributes:
+      label: AI disclosure
+      description: "One sentence: what part of this proposal was AI-written, what was human-written?"
+      placeholder: "Problem statement drafted by hand; example diff sketch was AI-assisted."
+    validations:
+      required: true
+  - type: textarea
+    id: agent-instructions
+    attributes:
+      label: For agents
+      description: "Agents: expand this section before filing."
+      value: |
+        <details>
+        <summary>Agent filing instructions</summary>
+
+        1. **Search first.** Run `gh search issues --repo brettdavies/agentnative-skill "<keywords>"` to check for
+           duplicates.
+        2. **Route check.** Verify this is a bundle proposal, not a spec change (file in agentnative) or an
+           `anc` feature request (file in agentnative-cli).
+        3. **AI disclosure is required.** Fill the field above honestly.
+        4. See [CONTRIBUTING.md](https://github.com/brettdavies/agentnative-skill/blob/main/CONTRIBUTING.md) for full
+           guidelines.
+        </details>
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: "Spec questions, principle edits, or grading findings"
+    url: "https://github.com/brettdavies/agentnative/issues/new/choose"
+    about: "For anything about the standard itself — propose changes, submit a grading finding, ask questions — file on the spec repo."
+  - name: "Auditor bugs, features, or tool-registry submissions"
+    url: "https://github.com/brettdavies/agentnative-cli/issues/new/choose"
+    about: "For bugs in the `anc` auditor, feature requests, or proposing a tool for the leaderboard, file on the linter repo."
+  - name: "Site bugs (rendering, performance, deployment)"
+    url: "https://github.com/brettdavies/agentnative-site/issues/new/choose"
+    about: "For bugs on anc.dev, file on the site repo."

.github/pull_request_template.md

@@ -1,6 +1,20 @@
 ## Summary
 
-<!-- Provide a brief overview of the changes in this PR. What feature/fix/improvement does this introduce? -->
+<!-- Provide a brief overview of the changes in this PR. What feature/fix/improvement does this introduce?
+
+     SCOPE: Describe the net diff only — what the merged result looks
+     like compared to the base branch. NOT commit history, intermediate
+     state, or how the cherry-picks were assembled.
+
+     EXCLUDE all verification artifacts:
+- Triple-diff output / stats (A, B, C blocks)
+- Leak-check output ("no guarded paths leaked", "guard-main-docs runs clean")
+- Patch-id cherry-check counts
+- Pre-push gate results, CI status, prose-scrub findings
+- Any "I ran X and it returned Y" narration
+
+     Anomalies get fixed before push, not audit-trailed in the body.
+-->
 
 ## Changelog
 

.github/workflows/guard-main-docs.yml

@@ -15,3 +15,5 @@ permissions:
 jobs:
   guard-docs:
     uses: brettdavies/.github/.github/workflows/guard-main-docs.yml@main
+    with:
+      extra_paths: 'scripts/sync-prose-tooling.sh'