rewrite-pipeline

Automate sequential implementation of rewrite plans into branches and pull requests.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/andreasasprou/polaris --skill rewrite-pipeline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rewrite-pipeline
Source: https://github.com/andreasasprou/polaris/tree/main/.agents/skills/rewrite-pipeline
Command: npx skills add https://github.com/andreasasprou/polaris --skill rewrite-pipeline

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill orchestrates the end-to-end, sequential implementation of a multi-plan repository rewrite by turning each plan into a focused branch and PR, ensuring each change is typechecked, tested, reviewed, and merged before proceeding while preserving progress across session compaction.

Core Features & Use Cases

  • Sequential plan execution: Implements Plans 48 through 55 one at a time, creating branches named rewrite/plan-{NUMBER}-{SLUG} and pushing safe, targeted commits.
  • Checkpointed persistence: Stores pipeline progress in a JSON state file to resume after compaction or interruptions.
  • Safe PR workflow: Runs typechecks and tests, stages specific files, creates PRs with verification checklists, runs automated reviews, and babysits CI and review feedback until merge.
  • Error handling & recovery: Provides rebase/merge conflict guidance, CI failure diagnosis and retry logic, and escalation rules for stalled or blocked PRs.
  • Use case: Automating a large refactor across multiple coordinated plans so human attention is only required for true blockers or ambiguous reviews.

Quick Start

Invoke ralph: /rewrite-pipeline with no argument or resume to start or continue the sequential PR pipeline for Plans 48-55.

Frequently Asked Questions about rewrite-pipeline

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate sequential git branch creation and pull request merging for a large refactor?

Sequential plan execution automates creating individual branches, running typechecks, staging targeted commits, opening PRs, and babysitting CI until merge. It turns each plan into a focused branch and PR, ensuring changes are tested and reviewed before proceeding.

What is a JSON checkpoint file in a CI pipeline and how does it help with context compaction?

A JSON checkpoint in a CI pipeline stores progress state to resume execution after context compaction or interruptions. It maintains pipeline progress so sequential tasks can continue from the exact step where execution was previously halted.

How do I handle git staging conflicts and failing tests during an automated PR workflow?

Automated PR workflows handle git staging conflicts and failing tests by providing rebase and merge conflict guidance, diagnosing CI failures, and applying retry logic. They also include escalation rules for stalled or blocked reviews to ensure recovery.

Does this automated pipeline approach work for multi-plan repository rewrites?

Yes, this automated pipeline approach works for multi-plan repository rewrites by implementing plans sequentially. It creates branches, runs verification checklists, and runs automated reviews so human attention is only required for true blockers or ambiguous reviews.

What's the best way to maintain pipeline progress across session interruptions when opening pull requests?

The best way to maintain pipeline progress across session interruptions when opening pull requests is to use a persistent JSON state file. This checkpointed persistence enforces safe git staging and supports resumption after context compaction.

Why does my automated pull request pipeline stall during CI babysitting?

An automated pull request pipeline stalls during CI babysitting when reviews are stalled or blocked. The pipeline provides escalation rules for these true blockers, ensuring human attention is only required for ambiguous reviews or unresolved conflicts.