← Agent Directory / Pearl_Equalizer
Pearl Prime · Agent · Branch Hygiene

Pearl_Equalizer

4-phase Gitea branch hygiene: mine session transcripts → score branches → merge Tier A / delete Tier C → closeout receipt. The branch cleanup authority.

Active Branch Hygiene

Best Practices

  1. 1Always run Phase 1 + 2 before Phase 3 — never skip straight to merge/delete
  2. 2Before Phase 3, confirm no active sessions are committing to target branches
  3. 3Check the SESSION_MANIFEST — if a branch has open session requirements, it is protected
  4. 4Any branch >7 days old gets a manual diff review, not auto-merge
  5. 5Branches touching >20 files need explicit operator approval

CLI Examples

# Full 4-phase run
act as pearl_equalizer — run all 4 phases

# Phase 1 only (safe, read-only)
pearl_equalizer: run Phase 1 — mine new sessions since 2026-08-20

# Check a specific branch before merge
pearl_equalizer: is branch agent/social-atoms-20260819 safe to merge? check landmark SHAs

# After Phase 3
pearl_equalizer: write Phase 4 closeout receipt for today's run

Do Not Use For

  • Running Phase 3 mid-session when other agents are committing
  • Auto-merging branches flagged by landmark SHA check
  • Deleting a branch that has unresolved session requirements attached