feat: improve examples and migration guide with GitHub context

[km-anthropic]

Fixes issues reported in discussions #490 and #491.

Changes

• **Add ** - 9 complete use case examples with working configurations
• Fix migration guide - Examples now include required GitHub context (REPO, PR NUMBER)
• Update examples - Added missing context to workflow-dispatch-agent and claude-modes
• Enhance README - Added Solutions & Use Cases section for better discoverability
• Document changes - Explain tracking comment removal in automation mode

All PR review examples now include proper GitHub context to prevent reviews of wrong repositories.

[km-anthropic]

@claude run bun format pls to fix the ci and commit your changes

[claude]

Claude finished @km-anthropic's task —— View job

---

Running formatter to fix CI

• Check current git status and CI issues
• Run bun run format to fix formatting
• Manual formatting required due to approval restrictions

Status Update

I cannot run the formatting commands (bun run format or prettier --write .) directly as they require approval in this environment for security reasons.

The git working tree is currently clean, which suggests the formatting issues may be in the CI environment or the formatter needs to be run to fix them.

Next Steps:

1. Please run bun run format locally or in the CI environment
2. If files are modified, commit them with:

   git add .
   git commit -m "fix: apply prettier formatting to resolve CI issues
   
   Co-authored-by: kashyap murali <km-anthropic@users.noreply.github.com>"
   git push

Alternatively, if you have the appropriate tool permissions configured, you can re-trigger this action with expanded --allowedTools to include formatting commands.

[claude]

Claude finished @km-anthropic's task —— View job

---

Tasks

• Run bun format to fix formatting issues
• Review formatting changes
• Commit and push the changes

✅ Done! I've successfully formatted the code with prettier and pushed the changes to fix the CI. The formatter fixed formatting issues in 6 files:

• README.md
• docs/migration-guide.md
• docs/solutions.md
• docs/usage.md
• examples/claude-modes.yml
• examples/workflow-dispatch-agent.yml

The changes have been committed and pushed to the PR branch.

[ashwin-ant]

Let's rename this to something clearer? Modes aren't part of the public interface.

[ashwin-ant]

Also, I can't comment on line 26 but we should update it to @v1

[ashwin-ant]

v1 here too

[km-anthropic]

@claude run bun format pls

[claude]

Claude finished @km-anthropic's task —— View job

---

Running bun format to fix CI

• Check current git status
• Run bun run format command (Requires approval)
• Check for formatting changes
• Commit and push changes if needed

Status Update

I cannot run the formatting commands (bun run format or prettier --write .) directly as they require approval in this environment for security reasons.

The git working tree is currently clean, which suggests the formatting issues may be in the CI environment or need to be resolved by running the formatter.

Next Steps:

1. Local approach: Run bun run format locally on your machine, then commit and push any changes
2. CI approach: The formatting issue might resolve itself on the next CI run
3. Permission approach: Re-trigger this action with expanded --allowedTools to include formatting commands

If running locally:

bun run format
git add .
git commit -m "fix: apply prettier formatting to resolve CI issues

Co-authored-by: kashyap murali <km-anthropic@users.noreply.github.com>"
git push

---

[claude]

Claude finished @km-anthropic's task —— View job

---

✅ Formatter completed successfully

• Check current git status
• Run bun run format to fix formatting
• Review formatting changes
• Commit and push changes

Summary: Successfully ran bun run format and fixed formatting issues in 3 files:

• docs/migration-guide.md - Fixed trailing spaces and newlines
• docs/solutions.md - Fixed trailing spaces and newlines
• examples/pr-review-comprehensive.yml - Fixed trailing spaces and newlines

The changes have been committed and pushed to the PR branch to fix the CI formatting issues.

[km-anthropic]

@ashwin-ant cleared out some older .ymls instead, and updated the remaining ones.