feat: use opus 4.6 and restructure review skill

[russellhaering]

Summary

• Switch to claude-opus-4-6 for better prompt compliance (was defaulting to Sonnet)
• Increase max-turns from 15 to 100
• Restructure the review skill to be more resilient to structural shortcuts

What changed in the skill

• Step checklist at the top with explicit deliverables per step — agent knows upfront what's expected
• Docs staleness promoted to Agent 4 — runs in parallel with code review agents instead of being a post-processing sub-item that gets skipped
• Required summary template with a mandatory Documentation section — forces the agent to report on docs staleness
• File classification table updated to include docs/connector.mdx → docs-reviewer

Why

The previous run on baton-twingate#16 had the docs staleness skill on disk but didn't flag the missing docs update (PR adds provisioning for roles without updating the Capabilities table). Root causes:

1. Sonnet was taking shortcuts and skipping the multi-step orchestration
2. The docs check was buried as item 6 in a validation step — easy to skip

[coderabbitai]

Important

Review skipped

Review was skipped due to path filters

⛔ Files ignored due to path filters (2)

• .github/workflows/pr-review.yaml is excluded by none and included by none
• skills/pr-review.md is excluded by none and included by none

CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including **/dist/** will override the default block on the dist directory, by removing the pattern from both the lists.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch review-skill-improvements

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}