Claude GitHub Actions

Author: vinniefalco

.github/workflows/claude.yml

@@ -0,0 +1,60 @@
+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 # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          additional_permissions: |
+            actions: read
+
+          # Optional: Customize the trigger phrase (default: @claude)
+          # trigger_phrase: "/claude"
+
+          # Optional: Trigger when specific user is assigned to an issue
+          # assignee_trigger: "claude-bot"
+
+          # Optional: Configure Claude's behavior with CLI arguments
+          # claude_args: |
+          #   --model claude-opus-4-1-20250805
+          #   --max-turns 10
+          #   --allowedTools "Bash(npm install),Bash(npm run build),Bash(npm run test:*),Bash(npm run lint:*)"
+          #   --system-prompt "Follow our coding standards. Ensure all new code has tests. Use TypeScript for new files."
+
+          # Optional: Advanced settings configuration
+          # settings: |
+          #   {
+          #     "env": {
+          #       "NODE_ENV": "test"
+          #     }
+          #   }

CLAUDE.md

@@ -0,0 +1,62 @@
+# CLAUDE.md
+
+## Code Style
+
+- C++11 unless otherwise specified
+- Boost C++ Libraries naming conventions (snake_case)
+- 4-space indentation, no tabs
+- Braces on their own line for classes/functions
+- Symbols in "detail" namespaces are never public
+- public headers in "include/"
+- library cpp files in "src/"
+
+## Javadoc Documentation
+
+Follow Boost C++ Libraries Javadoc style:
+
+- Brief descriptions on first line after `/**`
+- Functions returning values: brief starts with "Return"
+- Use `@param` for function parameters
+- Use `@tparam` for template parameters, except:
+  - Variadic args (`Args...`) — omit
+  - Types deduced from function parameters — omit (self-evident from `@param`)
+- Use `@return` for return value details
+- Use `@pre` for preconditions
+- Use `@post` for postconditions
+- Use `@throws` for exceptions
+- Use `@note` for important notes
+- Use `@see` for cross-references
+- Use `@code` / `@endcode` for examples
+
+## Examples
+
+```cpp
+/** Return the size of the buffer sequence.
+
+    @param buffers The buffer sequence to measure.
+
+    @return The total byte count.
+*/
+template<class BufferSequence>
+std::size_t
+buffer_size(BufferSequence const& buffers);
+```
+
+No `@tparam` needed—`BufferSequence` is evident from `@param buffers`.
+
+```cpp
+/** Return the default value.
+
+    @tparam T The value type.
+*/
+template<class T>
+T default_value();
+```
+
+`@tparam` needed—`T` has no corresponding function parameter.
+
+## Preferences
+
+- Concise, dry answers
+- Full files, not diffs
+- Accurate, compiling C++ code