ci: add Claude code review and auto-docs workflows

Author: erlendellefsen

.github/prompts/code-review.md

@@ -0,0 +1,20 @@
+REPO: $REPO
+PR: $PR_NUMBER
+
+Review PR #$PR_NUMBER in $REPO. This is a .NET NuGet library for JSON:API query parsing and mapping.
+
+Read all CLAUDE.md files in the repo first. They document conventions and non-obvious behaviors.
+
+Pay attention to breaking changes, API surface correctness, and query parsing edge cases.
+
+Post exactly one `gh pr comment`. Be brief. Only flag real problems — skip anything minor or stylistic.
+
+Format:
+
+```
+One sentence: what this PR does.
+
+- `file:line` - issue (only include if genuinely problematic)
+```
+
+No sections, no headers, no praise, no "looks good". If there are no issues, just write the one-sentence summary.

.github/prompts/docs-system-prompt.md

@@ -0,0 +1,11 @@
+You are updating documentation for $SOURCE_REPO, PR #$SOURCE_PR_ID.
+
+The repo is checked out at `./docs-repo/`. Documentation articles are in `./docs-repo/docs/docs/`. Table of contents is in `./docs-repo/docs/toc.yml`.
+
+Skip entirely if the PR is a refactor, CI change, dependency update, or bug fix with no behavior change.
+
+Only document genuinely new or changed user-facing behavior. Write as little as possible — a sentence or two is better than a paragraph. No intro sections, no summaries, no restating what is obvious. Match the style of existing docs.
+
+Write in GitHub Flavored Markdown. No em dashes.
+
+Only write to `./docs-repo/docs/docs/` and `./docs-repo/docs/toc.yml`. Nothing else.

.github/release-please-config.json

@@ -6,14 +6,16 @@
       "package-name": "Intility.JsonApiToolkit",
       "include-component-in-tag": false,
       "changelog-sections": [
-        { "type": "feat", "section": "Features", "hidden": false },
-        { "type": "fix", "section": "Bug Fixes", "hidden": false },
-        { "type": "perf", "section": "Performance", "hidden": false },
-        { "type": "refactor", "section": "Refactoring", "hidden": false },
-        { "type": "docs", "section": "Documentation", "hidden": false },
-        { "type": "test", "section": "Tests", "hidden": true },
-        { "type": "chore", "section": "Maintenance", "hidden": true },
-        { "type": "deps", "section": "Dependencies", "hidden": false }
+        { "type": "feat", "section": "Features" },
+        { "type": "fix", "section": "Bug Fixes" },
+        { "type": "perf", "section": "Performance Improvements" },
+        { "type": "refactor", "section": "Code Refactoring" },
+        { "type": "docs", "section": "Documentation" },
+        { "type": "build", "section": "Build System" },
+        { "type": "ci", "section": "CI" },
+        { "type": "style", "section": "Styles" },
+        { "type": "test", "section": "Tests" },
+        { "type": "chore", "section": "Miscellaneous", "hidden": true }
       ],
       "extra-files": [
         {

.github/workflows/claude-docs.yml

@@ -0,0 +1,24 @@
+name: "Claude: Auto Docs"
+
+on:
+  pull_request:
+    types: [closed]
+    branches: [main]
+    paths:
+      - "JsonApiToolkit/**"
+
+jobs:
+  generate-docs:
+    if: github.event.pull_request.merged == true
+    permissions:
+      contents: write
+      pull-requests: write
+      id-token: write
+    uses: intility/reusable-claude/.github/workflows/claude-auto-docs.yml@58c3c5cad89379ba2154fd9e2e17cbba5a7f093d # v1.1.1
+    with:
+      source_repo: ${{ github.repository }}
+      source_pr_id: ${{ github.event.pull_request.number }}
+      docs_repo: ${{ github.repository }}
+      system_prompt_path: ".github/prompts/docs-system-prompt.md"
+      docs_pr_title_prefix: "docs:"
+    secrets: inherit

.github/workflows/claude-review.yml

@@ -0,0 +1,20 @@
+name: "Claude: Code Review"
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+
+jobs:
+  claude-review:
+    permissions:
+      contents: write
+      pull-requests: write
+      issues: read
+      id-token: write
+      actions: read
+    uses: intility/reusable-claude/.github/workflows/claude-code-review.yaml@58c3c5cad89379ba2154fd9e2e17cbba5a7f093d # v1.1.1
+    with:
+      prompt_file: ".github/prompts/code-review.md"
+    secrets: inherit

.github/workflows/codeql.yml

@@ -1,11 +1,6 @@
 name: CodeQL
 
 on:
-  push:
-    branches: [main]
-    paths:
-      - "**.cs"
-      - "**.csproj"
   schedule:
     - cron: "0 6 * * 1" # Monday 6am UTC