docs(agent-rules): require --bug-hunt on manual specfact code review runs

[djm81]

Updates the canonical manual specfact code review run examples in docs/agent-rules/50-quality-gates-and-review.md and docs/agent-rules/20-repository-context.md to include --bug-hunt, with short rationale (CrossHair bug-hunt budgets) and a note that pre-commit keeps its own faster invocation via scripts/pre_commit_code_review.py.

Bumps last_reviewed on the touched rule pages.

Made with Cursor

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

Documentation updates to agent rules clarifying SpecFact code review command invocation. Modified command examples to include the --bug-hunt flag and updated last_reviewed metadata to 2026-04-16 across both documentation files.

Changes

Cohort / File(s)	Summary
Agent Rules Documentation docs/agent-rules/20-repository-context.md, docs/agent-rules/50-quality-gates-and-review.md	Updated SpecFact clean-code review commands to include --bug-hunt flag for bug-hunt timeout behavior. Clarified that manual invocations must pass this flag. Refreshed last_reviewed dates and expanded documentation to specify --bug-hunt requirements when running reviews outside pre-commit helpers.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The pull request description is largely incomplete relative to the repository template. It lacks most required sections including Scope, Bundle Impact, Validation Evidence, CI checks, and signature integrity checklist.	Complete the standard PR template by filling in Scope (documentation changes), Bundle Impact assessment, and required validation evidence sections before merge.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title follows the Conventional Commits style with 'docs:' prefix and clearly describes the documentation change to require --bug-hunt flag on manual specfact code review runs.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/agent-rules-specfact-bug-hunt

---

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