disinto/knowledge/review-agent.md
Claude f299bae77b
All checks were successful
ci/woodpecker/push/ci Pipeline was successful
ci/woodpecker/pr/ci Pipeline was successful
fix: bug: supervisor hardcodes ops repo expectation — fails silently on deployments without one (#544)
Add OPS repo presence detection in supervisor-run.sh with degraded mode support:
- Detect if OPS_REPO_ROOT is missing and log WARNING message
- Set OPS_REPO_DEGRADED=1 flag and configure fallback paths
- Bundle minimal knowledge files as fallback for degraded mode
- Update formula to use OPS_KNOWLEDGE_ROOT, OPS_JOURNAL_ROOT, OPS_VAULT_ROOT
- Support local vault destination and journal fallback when ops repo absent

Knowledge files bundled: disk.md, memory.md, ci.md, git.md, dev-agent.md,
review-agent.md, forge.md

The supervisor now runs with full functionality when ops repo is available,
or gracefully degrades to local paths when absent, making the failure mode
explicit rather than silent.
2026-04-10 08:16:03 +00:00

712 B

Review Agent — Best Practices

Review Agent Issues

When review agent encounters issues with PRs:

Stale PR Handling

  • PRs stale >20min (CI done, no push since) → file vault item for dev-agent
  • Do NOT push branches or attempt merges directly
  • File vault item with:
    • What: Stale PR requiring push
    • Why: Factory degraded
    • Unblocks: dev-agent will push the branch

Circular Dependencies

  • Check backlog for issues with circular Depends on refs
  • Use lib/parse-deps.sh to analyze dependency graph
  • Report to planner for resolution

Prevention

  • Review agent only reads PRs, never modifies
  • Use vault items for actions requiring dev-agent
  • Monitor for PRs stuck in review state