docs: Update documentation for v1.0 release (#476)

* docs: Update documentation for v1.0 release

- Integrate breaking changes naturally without alarming users
- Replace deprecated inputs (direct_prompt, custom_instructions, mode) with new unified approach
- Update all examples to use prompt and claude_args instead of deprecated inputs
- Add migration guides to help users transition from v0.x to v1.0
- Emphasize automatic mode detection as a key feature
- Update all workflow examples to @v1 from @beta
- Document how claude_args provides direct CLI control
- Update FAQ with automatic mode detection explanation
- Convert all tool configuration to use claude_args format

* fix: Apply prettier formatting to documentation files

* fix: Update all Claude model versions to latest and improve documentation accuracy

- Update all model references to claude-4-0-sonnet-20250805 (latest Sonnet 4)
- Update Bedrock models to anthropic.claude-4-0-sonnet-20250805-v1:0
- Update Vertex models to claude-4-0-sonnet@20250805
- Fix cloud-providers.md to use claude_args instead of deprecated model input
- Ensure all examples use @v1 instead of @beta
- Keep claude-opus-4-1-20250805 in examples where Opus is demonstrated
- Align all documentation with v1.0 patterns consistently

* feat: Add dedicated migration guide as requested in PR feedback

- Create comprehensive migration-guide.md with step-by-step instructions
- Add prominent links to migration guide in README.md
- Update usage.md to reference the separate migration guide
- Include before/after examples for all common scenarios
- Add checklist for systematic migration
- Address Ashwin's feedback about having a separate, clearly linked migration guide

examples/claude-args-example.yml

@@ -17,13 +17,11 @@ jobs:
       - name: Run Claude with custom arguments
         uses: anthropics/claude-code-action@v1
         with:
-          mode: agent
           prompt: ${{ github.event.inputs.prompt }}
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
 
-          # New claudeArgs input allows direct CLI argument control
-          # Order: -p [claudeArgs] [legacy options] [BASE_ARGS]
-          # Note: BASE_ARGS (--verbose --output-format stream-json) cannot be overridden
+          # claude_args provides direct CLI argument control
+          # This allows full customization of Claude's behavior
           claude_args: |
             --max-turns 15
             --model claude-opus-4-1-20250805

examples/claude-auto-review.yml

@@ -35,4 +35,7 @@ jobs:
 
             Provide constructive feedback with specific suggestions for improvement.
             Use inline comments to highlight specific areas of concern.
-          # allowed_tools: "mcp__github__create_pending_pull_request_review,mcp__github__add_comment_to_pending_review,mcp__github__submit_pending_pull_request_review,mcp__github__get_pull_request_diff"
+
+          # Optional: Configure specific tools for review operations
+          # claude_args: |
+          #   --allowedTools "mcp__github__create_pending_pull_request_review,mcp__github__add_comment_to_pending_review,mcp__github__submit_pending_pull_request_review,mcp__github__get_pull_request_diff"

examples/claude-modes.yml

@@ -1,21 +1,21 @@
-name: Claude Mode Examples
+name: Claude Automatic Mode Detection Examples
 
 on:
-  # Events for tag mode
+  # Events for interactive mode (responds to @claude mentions)
   issue_comment:
     types: [created]
   issues:
     types: [opened, labeled]
   pull_request:
     types: [opened]
-  # Events for agent mode (only these work with agent mode)
+  # Events for automation mode (runs with explicit prompt)
   workflow_dispatch:
   schedule:
     - cron: "0 0 * * 0" # Weekly on Sunday
 
 jobs:
-  # Tag Mode (Default) - Traditional implementation
-  tag-mode-example:
+  # Interactive Mode - Activated automatically when no prompt is provided
+  interactive-mode-example:
     runs-on: ubuntu-latest
     permissions:
       contents: write
@@ -23,18 +23,17 @@ jobs:
       issues: write
       id-token: write
     steps:
-      - uses: anthropics/claude-code-action@beta
+      - uses: anthropics/claude-code-action@v1
         with:
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
-          # Tag mode (default) behavior:
+          # Interactive mode (auto-detected when no prompt):
           # - Scans for @claude mentions in comments, issues, and PRs
           # - Only acts when trigger phrase is found
           # - Creates tracking comments with progress checkboxes
           # - Perfect for: Interactive Q&A, on-demand code changes
 
-  # Agent Mode - Automation for workflow_dispatch and schedule events
-  agent-mode-scheduled-task:
-    # Only works with workflow_dispatch or schedule events
+  # Automation Mode - Activated automatically when prompt is provided
+  automation-mode-scheduled-task:
     runs-on: ubuntu-latest
     permissions:
       contents: write
@@ -42,15 +41,14 @@ jobs:
       issues: write
       id-token: write
     steps:
-      - uses: anthropics/claude-code-action@beta
+      - uses: anthropics/claude-code-action@v1
         with:
-          mode: agent
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
-          override_prompt: |
+          prompt: |
             Check for outdated dependencies and security vulnerabilities.
             Create an issue if any critical problems are found.
-          # Agent mode behavior:
-          # - ONLY works with workflow_dispatch and schedule events
-          # - Does NOT work with pull_request, issues, or issue_comment events
-          # - No @claude mention needed for supported events
-          # - Perfect for: scheduled maintenance, manual automation runs
+          # Automation mode (auto-detected when prompt provided):
+          # - Works with any GitHub event
+          # - Executes immediately without waiting for @claude mentions
+          # - No tracking comments created
+          # - Perfect for: scheduled maintenance, automated reviews, CI/CD tasks

examples/claude.yml

@@ -32,7 +32,7 @@ jobs:
 
       - name: Run Claude Code
         id: claude
-        uses: anthropics/claude-code-action@beta
+        uses: anthropics/claude-code-action@v1
         with:
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
 
@@ -40,24 +40,23 @@ jobs:
           additional_permissions: |
             actions: read
 
-          # Optional: Specify model (defaults to Claude Sonnet 4, uncomment for Claude Opus 4.1)
-          # model: "claude-opus-4-1-20250805"
-
           # 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: Allow Claude to run specific commands
-          # allowed_tools: "Bash(npm install),Bash(npm run build),Bash(npm run test:*),Bash(npm run lint:*)"
+          # 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: Add custom instructions for Claude to customize its behavior for your project
-          # custom_instructions: |
-          #   Follow our coding standards
-          #   Ensure all new code has tests
-          #   Use TypeScript for new files
-
-          # Optional: Custom environment variables for Claude
-          # claude_env: |
-          #   NODE_ENV: test
+          # Optional: Advanced settings configuration
+          # settings: |
+          #   {
+          #     "env": {
+          #       "NODE_ENV": "test"
+          #     }
+          #   }

examples/workflow-dispatch-agent.yml

@@ -28,11 +28,10 @@ jobs:
           fetch-depth: 2 # Need at least 2 commits to analyze the latest
 
       - name: Run Claude Analysis
-        uses: anthropics/claude-code-action@beta
+        uses: anthropics/claude-code-action@v1
         with:
-          mode: agent
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
-          override_prompt: |
+          prompt: |
             Analyze the latest commit in this repository.
 
             ${{ github.event.inputs.analysis_type == 'summarize-commit' && 'Task: Provide a clear, concise summary of what changed in the latest commit. Include the commit message, files changed, and the purpose of the changes.' || '' }}