feat: Claude Code (#749)

* docs: CLAUDE.md

* feat: devcontainer claude-code

* docs: update

* docs: agent hooks update

* feat: sync-readme-versions

* docs: AGENTS.md learnings

* feat: sync-readme-versions run locally

* chore: build

* feat: agent stop review update agents.md

* chore: skills cli

* feat: claude skill github-actions-docs

* feat: skill typescript-advances-types

* chore: ignore folders from formatting

* feat: sync-readme-version support workflow_dispatch

* refactor: stricter tsconfig

* chore: tooling ignore agent folders

* chore: build

* tooling

* docs: skill create pull request

* delete skill

Author: andykenward

.agents/skills/typescript-advanced-types/SKILL.md

@@ -0,0 +1 @@
+../../.agents/skills/github-actions-docs

.claude/skills/github-actions-docs

@@ -0,0 +1 @@
+../../.agents/skills/typescript-advanced-types

.claude/skills/typescript-advanced-types

@@ -1,5 +1,10 @@
 {
   "features": {
+    "ghcr.io/anthropics/devcontainer-features/claude-code:1.0": {
+      "version": "1.0.5",
+      "resolved": "ghcr.io/anthropics/devcontainer-features/claude-code@sha256:cfc2e7d3e9fd3b9b01f8d5cb158508a884c8c0ede2e23ed10f32dea5d4ffe69a",
+      "integrity": "sha256:cfc2e7d3e9fd3b9b01f8d5cb158508a884c8c0ede2e23ed10f32dea5d4ffe69a"
+    },
     "ghcr.io/devcontainers-extra/features/act:1": {
       "version": "1.0.15",
       "resolved": "ghcr.io/devcontainers-extra/features/act@sha256:db4a2194930d1f7ec62822d4f600dd2fa4aff3c33b98cdb0b578b64ffb10924c",

.devcontainer/devcontainer-lock.json

@@ -27,9 +27,12 @@
       "pnpmVersion": "11.0.8"
     },
     "ghcr.io/devcontainers/features/github-cli:1": {},
-    "ghcr.io/devcontainers-extra/features/pre-commit:2": {}
-  }
-
+    "ghcr.io/devcontainers-extra/features/pre-commit:2": {},
+    "ghcr.io/anthropics/devcontainer-features/claude-code:1.0": {}
+  },
+  "mounts": [
+    "source=claude-code-config-${devcontainerId},target=/home/node/.claude,type=volume"
+  ]
   // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
   // "remoteUser": "root"
 }

.devcontainer/devcontainer.json

@@ -0,0 +1,11 @@
+{
+  "hooks": {
+    "Stop": [
+      {
+        "type": "command",
+        "command": "bash ./.github/hooks/scripts/stop-review-agents.sh",
+        "timeout": 10
+      }
+    ]
+  }
+}

.github/HOOKS.md

@@ -3,7 +3,7 @@ set -euo pipefail
 
 # Shared formatter/linter entrypoint used by:
 # - .pre-commit-config.yaml (local hook: oxc-format-and-lint)
-# - .github/hooks/format-and-lint-after-edit.json (Copilot PostToolUse)
+# - .github/hooks/format-and-lint-after-edit.json (PostToolUse)
 # AI agents: keep both wiring points and this usage list in sync when behavior or paths change.
 
 # pre-commit passes staged file paths as positional arguments.
@@ -14,7 +14,7 @@ fi
 
 # Step 1: Format every matched file first.
 # If formatting fails, the script exits immediately because of `set -e`.
-pnpm exec oxfmt --write "$@"
+pnpm exec oxfmt --write --no-error-on-unmatched-pattern "$@"
 
 # Step 2: Build a list of files oxlint can analyze.
 # We intentionally keep this separate from formatting so unsupported

.github/hooks/review-agents-at-stop.json

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Stop hook: prompts the agent to review AGENTS.md for any learnings from this session.
+# Only triggers when there are uncommitted changes — skips read-only sessions.
+#
+# Used by:
+# - .github/hooks/review-agents-at-stop.json (Stop)
+
+if ! command -v git >/dev/null 2>&1; then
+  exit 0
+fi
+
+# Skip if no working-tree changes (read-only session or everything already committed).
+if git diff --quiet 2>/dev/null && git diff --cached --quiet 2>/dev/null; then
+  exit 0
+fi
+
+cat <<'EOF'
+{
+  "hookSpecificOutput": {
+    "hookEventName": "Stop",
+    "decision": "block",
+    "reason": "Before finishing: review AGENTS.md for any learnings from this session worth capturing.\n\nConsider:\n- New patterns, conventions, or gotchas discovered\n- Corrections to stale or inaccurate information\n- Non-obvious constraints or workflow steps that needed clarification\n- Anything that would have saved time if it had been documented at the start\n\nIf AGENTS.md is already up to date, output a brief confirmation and the session can end."
+  }
+}
+EOF
+
+exit 0