docs(branch-hygiene): rescue §9 SPARK work — naming convention, PR check, restore safety, ROADMAP CHIT columns

[POWERFULMOVES]

Summary

Rescues SPARK-authored work from orphan branches fix/branch-lifecycle-chit-wiring (no PR, 4 days old) and partially fix/agnote4482-section9-recovery (PR #1382 CLOSED, 4 days old).

The stale-branch-sweep.yml CI workflow from these branches already landed on main via 9b6eee7af. This PR delivers the companion documentation that was left stranded.

What's Included

AGNOTE4482_SITREP.md

• Branch Naming Convention table (feat/, fix/, infra/, docs/, refactor/) with workstream ID guidance and forbidden prefixes
• PR check block in Fastest Health Check — warns if working on un-PR'd branch
• Restore Safety section — incident note from 2026-04-23 backup-restore that silently overwrote 7 checkmarks; rule: always git diff HEAD -- <file> before restoring from backup

AGNOTE4482_ROADMAP_W1-W5.md

• Active Claim Register table gains PR and CHIT Trail columns — makes branch→PR→trail linkage visible per §9 hygiene requirements

AGNOTE4482.md

• 3-line additive update (no rewrites)

What Was NOT Rescued

fix/agnote4482-section9-recovery AGNOTE4482.md hunk (193-line delta from a backup restore) had 2 merge conflicts with current main and was a file-level restore that replaced content already superseded on main. Skipped intentionally — the §9 + §6.4 changes from that branch are already on main via the branch-lifecycle cherry-pick.

Orphan branch disposition

After merge:

• fix/branch-lifecycle-chit-wiring → safe to delete (all content rescued here)
• fix/agnote4482-section9-recovery → safe to delete (§9/§6.4 already on main; conflicted AGNOTE hunk is stale)

Village Rule

One scope: stranded SPARK docs rescue. No new features.

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Added branch naming convention guidelines with required prefixes and validation rules
  • Introduced runtime check to monitor pull request status across active branches
  • Restructured agent roadmap table with dedicated columns for PR references and activity tracking
  • Enhanced restore operation procedures with mandatory safety verification steps

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 536f7401-2df2-4c59-bfe5-1813748a2161

📥 Commits

Reviewing files that changed from the base of the PR and between a280759 and ba70637.

📒 Files selected for processing (3)

• pmoves/docs/AGENTS/AGNOTE4482.md
• pmoves/docs/AGENTS/AGNOTE4482_ROADMAP_W1-W5.md
• pmoves/docs/AGENTS/AGNOTE4482_SITREP.md

---

📝 Walkthrough

Walkthrough

This pull request updates three agent documentation files in the AGNOTE4482 series. Changes include appending branch cleanup confirmation lines to ACK sections, restructuring the Agent Claim Register table with explicit PR and CHIT Trail columns, and adding documentation for branch naming conventions, orientation checks, and restore safety procedures.

Changes

Cohort / File(s)	Summary
AGNOTE4482 ACK Sections pmoves/docs/AGENTS/AGNOTE4482.md	Appends Branch Cleanup: none line to three agent ACK sections (PHASE-9C-INFRA-HARDENING, RUNNER-RESTART-LOOP-FIX, LAUNCH-PREP-AUDIT) without modifying other content, ordering, or signatures.
Agent Claim Register Roadmap pmoves/docs/AGENTS/AGNOTE4482_ROADMAP_W1-W5.md	Restructures table to add explicit PR and CHIT Trail columns, moving PR/commit references from Status field and CHIT activity from Status into dedicated columns. Adds new "ORPHANED" claim state rule based on elapsed time since CLAIMED and absence of PRs/CHIT activity, triggering branch deletion.
Branch Guidance & Restore Procedures pmoves/docs/AGENTS/AGNOTE4482_SITREP.md	Introduces branch naming conventions with required prefixes/workstream IDs and forbidden patterns. Adds runtime orientation check to warn when non-main branch has no open PRs. Adds restore procedure safety section documenting a prior incident and mandating git diff verification to prevent overwriting committed checklist items.

Possibly related PRs

• docs(agnote4482): add codex creator publishing follow-up #1117: Modifies the same AGNOTE4482_ROADMAP_W1-W5.md roadmap table structure and columns.
• fix: A2A activation + transcribe-and-fetch gitlink rewind #1371: Updates AGNOTE4482 documentation with audit records and related AGNOTE modifications.
• docs(agents): AGNOTE4482 self-review audit — 2 gaps resolved, counts refreshed, SITREP created #1177: Extends branch cleanup procedures and orientation guidance added in this PR to the AGNOTE4482 documentation set.

Poem

🐰 A rabbit hops through docs with glee,
Adding cleanup notes and PR decree,
Tables restructured, orphans found,
Branch wisdom scattered all around!
With guidance clear and checks so neat,
Our documentation is complete! 📋✨

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	❓ Inconclusive	The description provides a comprehensive summary of changes and rationale, but lacks required Testing section documentation and explicit checkbox confirmations for Required Checks items.	Add a Testing section documenting validation commands/steps and confirm status of Required Checks (CHIT Contract Check, contract updates, documentation updates) and Review Coordination items.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main changes: rescuing §9 SPARK documentation related to branch hygiene, including naming conventions, PR checks, restore safety procedures, and ROADMAP CHIT column additions.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ 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 fix/section9-branch-hygiene-docs

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ba70637627

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Correct ORPHANED criteria to match sweep behavior

This new rule says a claim becomes ORPHANED when CLAIMED >7 days, but .github/workflows/stale-branch-sweep.yml actually deletes based on branch last commit date (LAST_COMMIT_DATE < CUTOFF) plus no open PR/CHIT activity (lines 64-83). That mismatch can cause teams to believe a recently re-claimed branch is safe when it can still be swept if its last commit is old, so the documentation should describe commit-age-based orphaning instead of claim-age-based orphaning.

Useful? React with 👍 / 👎.