Repository navigation
docs: repository-maintenance - Align branch cleanup runbooks #1245
Description
Create comprehensive, permanent documentation for branch cleanup and repository maintenance procedures.
Deliverables
-
✅ docs/BRANCH_CLEANUP.md (330 lines)
- Quick start guide
- How it works (4 subsections)
- Command reference
- Workflow integration
- Troubleshooting (6 issues)
- FAQ (11 entries)
-
✅ docs/MAINTENANCE.md (330 lines)
- Monthly maintenance calendar
- 5 core procedures
- Automated task registry
- Health checks
- Escalation guidelines
Related Files
- docs/BRANCH_CLEANUP.md
- docs/MAINTENANCE.md
- BRANCHING_STRATEGY.md (updated)
Project Reference
Parent Epic: #1243
Project: projects/active/repository-maintenance-infrastructure/
Definition of Ready (DoR)
- Problem statement and outcome defined
- Acceptance criteria written (Given/When/Then)
- Designs/specs/references attached (if relevant)
- Dependencies mapped
- Estimate added
- Stakeholders/approvers listed
- Milestone/iteration assigned (if applicable)
Definition of Done (DoD)
- All acceptance criteria met
- Tests added/updated; CI green
- Accessibility: WCAG 2.2 AA compliance verified (semantic HTML, keyboard support, colour contrast)
- Security: input validated, output escaped, no OWASP Top 10 vulnerabilities
- Performance: no measurable regression introduced
- Docs/changelog updated
- Feature toggles/rollout considered
- QA verified/UAT approved (if applicable)
- Release notes prepared; monitoring/alerts set
Metadata
Metadata
Assignees
Type
Fields
Priority
None yet
Activity
linear-code commentedon Jul 24, 2026
LS-1792
github-actions commentedon Jul 24, 2026
Missing required section(s): Definition of Ready (DoR), Definition of Done (DoD)
The issue will remain open and flagged until the body is corrected.
Please update the issue with one of the official templates:
If this was opened by automation, update the automation to preserve the template sections before creating the issue.
docs(projects): add complete repository maintenance infrastructure pr…
github-actions commentedon Jul 24, 2026
⏱️ Aging and SLA annotation
Maintained by project-meta-sync workflow.
docs(projects): add complete repository maintenance infrastructure pr…
12 remaining items
[-]Create permanent maintenance documentation (BRANCH_CLEANUP.md + MAINTENANCE.md)[/-][+]docs: repository-maintenance - Align branch cleanup runbooks[/+]