Install Claude code factory pattern

Add Claude Code Action workflows:
- claude.yml: responds to @claude mentions on issues/PRs
- claude-auto-assign.yml: auto-tags @claude on new org-member issues
- claude-code-review.yml: automated PR review via code-review plugin

Add CLAUDE.md with repo-specific instructions for Claude.

Author: jonathanpopham

.github/workflows/claude-auto-assign.yml

@@ -0,0 +1,52 @@
+name: Auto-assign Claude on new issues
+
+on:
+  issues:
+    types: [opened]
+
+jobs:
+  tag-claude:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      members: read
+    steps:
+      - name: Check org membership and tag Claude
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const author = context.payload.issue.user.login;
+            const org = context.repo.owner;
+            const body = context.payload.issue.body || '';
+
+            // Already has @claude — no need to add it
+            if (body.includes('@claude')) {
+              console.log('Issue body already contains @claude, skipping.');
+              return;
+            }
+
+            // Always trigger for the Claude bot itself
+            const isClaudeBot = author === 'claude[bot]';
+
+            let isMember = false;
+            if (!isClaudeBot) {
+              try {
+                await github.rest.orgs.checkMembershipForUser({ org, username: author });
+                isMember = true;
+              } catch (e) {
+                isMember = false;
+              }
+            }
+
+            if (!isClaudeBot && !isMember) {
+              console.log(`Skipping: ${author} is not a member of ${org}`);
+              return;
+            }
+
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: '@claude please implement this issue'
+            });

.github/workflows/claude-code-review.yml

@@ -0,0 +1,30 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, ready_for_review, reopened]
+
+jobs:
+  claude-review:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          allowed_bots: '*'
+          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
+          plugins: 'code-review@claude-code-plugins'
+          prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}'

.github/workflows/claude.yml

@@ -0,0 +1,41 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      issues: write
+      id-token: write
+      actions: read
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          allowed_bots: "claude[bot]"
+          additional_permissions: |
+            actions: read
+          claude_args: '--allowedTools "Bash(gh pr create:*),Bash(gh pr list:*),Bash(gh pr view:*),Bash(gh issue:*),Bash(gh api:*),Bash(git fetch:*),Bash(git checkout:*),Bash(git add:*),Bash(git commit:*),Bash(git push:*),Bash(git rebase:*),Bash(git log:*),Bash(git diff:*),Bash(git status:*),Bash(go run:*),Bash(go build:*),Bash(go mod tidy:*),Edit,Write,Read,Glob,Grep"'

CLAUDE.md

@@ -0,0 +1,48 @@
+# supermodeltools.github.io — Claude Instructions
+
+## What this repo is
+
+This is the homepage for Supermodel's open-source architecture documentation index, deployed to GitHub Pages at `repos.supermodeltools.com`. It lists repos that have architecture docs generated by [supermodeltools/arch-docs](https://github.com/supermodeltools/arch-docs).
+
+## Project structure
+
+- `repos.yaml` — source of truth for all listed repos (categories, names, descriptions, pills)
+- `generate-index.go` — Go static site generator that reads `repos.yaml` and produces `site/index.html`
+- `site/` — build output directory (gitignored)
+- `.github/workflows/build-index.yml` — builds and deploys to GitHub Pages on push
+
+## Development
+
+- Language: Go 1.24
+- Build: `go run generate-index.go`
+- The generator uses `text/template` and embeds all HTML/CSS/JS inline
+- No external dependencies beyond `gopkg.in/yaml.v3`
+
+## Pull Requests
+
+When asked to implement something and raise a PR, always create the PR using `gh pr create`:
+
+```
+gh pr create \
+  --repo supermodeltools/supermodeltools.github.io \
+  --title "..." \
+  --body "..." \
+  --base main \
+  --head <branch>
+```
+
+## Issues
+
+When creating a GitHub issue, always include `@claude` at the end of the body so the workflow auto-triggers.
+
+## Branch naming
+
+`claude/issue-{number}-{YYYYMMDD}-{HHMM}`
+
+## Commits
+
+Keep commit messages concise and descriptive. Include:
+
+```
+Co-Authored-By: Claude <noreply@anthropic.com>
+```