commit-plan

Sequence a mixed-change working tree into atomic commits with tests.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Elijah-J/InfoScraper --skill commit-plan-elijah-j
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit-plan
Source: https://github.com/Elijah-J/InfoScraper/tree/main/.agents/skills/commit-plan
Command: npx skills add https://github.com/Elijah-J/InfoScraper --skill commit-plan-elijah-j

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sequence the current working tree into atomic commits, providing a coherent history when changes span multiple concerns.

Core Features & Use Cases

  • Phase-gated workflow: enforces a strict six-phase process with a single human-in-the-loop checkpoint between Propose and Execute.
  • Plan to commit: clusters changes by theme and chronology, stitches them into atomic commits with explicit file paths, and runs targeted tests prior to committing.
  • End-to-end verification: performs a full-suite validation to ensure parity with the baseline after execution.

Quick Start

Organize a mixed-change working tree into a sequence of atomic commits.

Frequently Asked Questions about commit-plan

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

FAQPage Schema
How do I split a mixed-change working tree into atomic commits?

To split a mixed-change working tree into atomic commits, this process clusters changes by theme and chronology, then stitches them into targeted commits with explicit file paths. It enforces a six-phase workflow with per-commit staging and targeted tests to ensure a coherent history.

What is the best way to organize multi-concern git changes into a coherent history?

Organizing multi-concern git changes into a coherent history requires sequencing the working tree into atomic commits. This approach uses a gated human-in-the-loop checkpoint between the Propose and Execute phases to validate commit hygiene and maintain code quality.

Can I run targeted tests before staging each atomic commit?

Yes, you can run targeted tests before staging each atomic commit. The workflow explicitly runs targeted tests prior to committing during its execution phase, followed by a full-suite validation to ensure parity with the baseline after all commits are applied.

Does the atomic commit workflow require manual approval before execution?

Yes, the atomic commit workflow requires manual approval. It enforces a strict six-phase process with a single human-in-the-loop checkpoint between the Propose and Execute phases to review the commit plan before changes are staged and committed.

How does version control handle documentation and code changes mixed in the same working tree?

Version control handles mixed documentation and code changes by targeting multi-concern changes across both file types. The process sequences them into separate atomic commits, applying strict commit-hygiene checks to maintain a clean and coherent project history.