forked from newren/git-filter-repo
-
Notifications
You must be signed in to change notification settings - Fork 0
chore: Create upstream sync skill #9
Copy link
Copy link
Open
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or request
Description
Problem
Need documented, repeatable process for syncing upstream git-filter-repo updates from newren/git-filter-repo into local main branch, then selectively promoting to development branch.
Proposed Solution
Create .agents/skills/sync-upstream-main/ with:
SKILL.md - Agent skill file containing:
- When to use: Upstream release detected or scheduled check (3-6 month intervals)
- Process steps:
- Fetch upstream remote
- Rebase or merge into local main branch
- Run upstream tests on main to verify
- Identify files needing copy to development (primarily git_filter_repo.py)
- Copy and test on development branch
- Update CHANGELOG or commit noting upstream version
- Error handling: Breaking API changes, merge conflicts
- Validation: Test both branches independently
README.md - Skill directory overview:
- Purpose of skill
- When to invoke
- Manual workflow if skill unavailable
Parked in design-parked.md as "Revisit when: first upstream update needed or 3-6 months post-launch."
Alternatives Considered
Manual sync documentation in CONTRIBUTING.md, but dedicated skill provides agent-executable workflow and reduces maintainer cognitive load.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or request