Similar-sweep PR process
During active feature work, pause opening new similar-sweep PRs until the current batch is merged or rebased onto main.
Before opening
git fetch origin main && git rebase origin/main— do notgit merge main(merge commits clutter the graph; use rebase when syncing withmain).- Use the checklist in
.github/pull_request_template/similar_sweep.md - Run overlap check:
node .github/scripts/check-pr-file-overlap.mjs
Merge order (when many PRs are open)
- Mergeable sweep/fix PRs with green CI
- Feature stack: #1454 → #1455 → #1458 → #1453
- Rebase conflicting sweeps (port vector-db fixes to
vector-db-class.tsonly) - Paired PRs #1504 + #1505 together
- Dependabot lockfile PRs last, alone
File-split modules (collision reduction)
Large CLI/backend files are split into focused modules under cli/commands/manage/ and backends/facts-db/procedures/. Prefer adding commands to the smallest matching register-*.ts file rather than the orchestrator.