atomic-commits

Enforce one-commit-per-task discipline across execute, phase-execute, quick, and tdd workflows.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/tuanldas/superteam --skill atomic-commits-tuanldas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atomic-commits
Source: https://github.com/tuanldas/superteam/tree/main/skills/atomic-commits
Command: npx skills add https://github.com/tuanldas/superteam --skill atomic-commits-tuanldas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Atomic Commits ensures every commit is a single, complete, independently revertable unit of work. It prevents mega-commits, partial commits, and broken commit history.

Core Features & Use Cases

  • Granularity modes across workflows: execute, phase-execute, quick, and tdd, with lifecycle commits for phase status.
  • Enforced Commit Message Format: conventional, lowercase, under 72 characters, and descriptive.
  • Pre-Commit Verification: builds and tests must pass, with task-scoped changes only.
  • Parallel Execution Safety: coordinated commits without rebases or force-pushes to keep history safe.
  • Rollback Protocols: single-task revert and wave-level recovery to preserve history.

Quick Start

Enable task-oriented commits by starting a task with /st:execute and let Atomic Commits automatically enforce one-commit-per-task discipline.

Frequently Asked Questions about atomic-commits

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

FAQPage Schema
How do I enforce one commit per task in git?

Atomic commits enforce one-commit-per-task discipline across execute, phase-execute, quick, and tdd workflows. This prevents mega-commits and broken history by ensuring every commit is a single, independently revertable unit of work.

What is the best way to format pre-commit messages for atomic commits?

The best way to format pre-commit messages for atomic commits is using a conventional, lowercase, descriptive format under 72 characters. This ensures traceability and consistency across task-scoped changes in your version history.

How do I run parallel execution safely without git rebases or force-pushes?

Parallel execution safety coordinates commits without rebases or force-pushes by enforcing task-scoped changes and pre-commit verification. This keeps your git history safe while executing multiple tasks concurrently across workflows.

Can I use atomic commits with TDD workflows?

Yes, atomic commits apply across tdd workflows alongside execute, phase-execute, and quick modes. They cover multiple task scenarios and lifecycle commits, ensuring one complete, revertable commit per test-driven development task.

How do I rollback a task-scoped commit without breaking project history?

Rollback protocols support single-task revert and wave-level recovery to preserve history. Because atomic commits ensure every commit is an independently revertable unit of work, you can safely rollback task-scoped changes without breaking project history.