🪴 [claude] Add Claude Code GitHub Workflow

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

@@ -0,0 +1,60 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+# global permissions
+permissions: {}
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      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 }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Please review this pull request and provide feedback on:
+            - Code quality and best practices
+            - Potential bugs or issues
+            - Performance considerations
+            - Security concerns
+            - Test coverage
+
+            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
+
+            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/sdk#command-line for available options
+          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'
+

.github/workflows/claude.yml

@@ -0,0 +1,53 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+# global permissions
+permissions: {}
+
+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: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    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 }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/sdk#command-line for available options
+          # claude_args: '--model claude-opus-4-1-20250805 --allowed-tools Bash(gh pr:*)'
+

CLAUDE.md

@@ -0,0 +1,68 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Repository Purpose
+
+This is a **meta-repository for project ideas and planning**. It contains no application code - only GitHub Issues for potential projects. Each issue should eventually get its own dedicated repository when work begins.
+
+**Important**: Pull requests to this repo should be rare. Think twice before modifying anything here.
+
+## Build System
+
+This project uses [`just`](https://github.com/casey/just) as its task runner.
+
+### Common Commands
+
+```bash
+just list              # List all available recipes
+just compliance_check  # Run Chicks' repo compliance checks
+just clean_readme      # Generate a clean README from template
+```
+
+### Git Workflow Commands
+
+```bash
+just branch <name>     # Create new branch with timestamp prefix (format: $USER/YYYY-MM-DD-<name>)
+just pr                # Create PR with last commit message as title
+just prweb             # Open current PR in browser
+just merge             # Merge PR, delete branch, sync back to main
+just sync              # Return to main branch and pull latest
+```
+
+The workflow expects:
+
+- Main branch is `main`
+- Branch naming: `$USER/YYYY-MM-DD-description`
+- PR body auto-generated from last commit message
+- After PR creation, watches checks if `.github/workflows` exists
+
+## Repository Standards
+
+The compliance check (`just compliance_check`) enforces these standards:
+
+- `README.md`, `LICENSE`, `.gitignore`, `.gitattributes`, `.editorconfig`
+- `.github/CODE_OF_CONDUCT.md`, `.github/CONTRIBUTING.md`, `.github/SECURITY.md`
+- `.github/pull_request_template.md`, `.github/ISSUE_TEMPLATE/`
+- `.github/CODEOWNERS`
+- `justfile` (this build system itself)
+- GitHub repo description (>16 chars)
+
+## Language Preferences for New Projects
+
+When projects spin off from issues here, preferred languages are:
+
+**Definitely acceptable**: Go, Rust, Perl, Bash
+
+**Possibly acceptable**: Python, C/C++, Lua, JavaScript
+
+**Strongly discouraged**: PHP, Java, BASIC/VB, C#, Pascal, Matlab
+
+## Justfile Architecture
+
+The main `justfile` imports two modules:
+
+- `.just/compliance.just` - Repository compliance checks with colorful output
+- `.just/gh-process.just` - GitHub workflow automation (branch, PR, merge)
+
+Color variables (e.g., `{{BLUE}}`, `{{GREEN}}`, `{{RED}}`, `{{NORMAL}}`) are used for terminal output formatting.