Repo Sync Steward
Scope
Keep the website repo aligned with the main FrankX content and site code without dragging in local tooling or internal docs.
Workflow
-
Fetch and inspect targets
-
Confirm remotes: origin (FrankX) and vercel-website (site repo).
-
Fetch the target branch before syncing.
-
Prepare clean source commits
-
Stage only website-relevant paths:
-
content/blog/**
-
public/rss.xml
-
lib/** and app/** links that reference blog slugs
-
next.config.js redirects (if slugs changed)
-
Avoid: .claude/ , .tina/ , .shared/ , docs/ , notes.md , task_plan.md .
-
Apply to target safely
-
Use a worktree for vercel-website/<branch> to avoid dirty state.
-
Cherry-pick the prepared commits; resolve conflicts minimally.
-
Validate
-
Run node scripts/validate-blog-frontmatter.js if available.
-
Regenerate RSS with node scripts/generate_feed.mjs .
-
Scan for old slugs: rg -n "/blog/0[0-9]-" and ensure redirects exist.
-
Push + record
-
Push to vercel-website/<branch> .
-
Log what was synced (commit IDs + key files) in a brief note.