atomic-execution

Create atomic commits with per-file staging and TDD verification.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/derickdsouza/dd-claude --skill atomic-execution
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atomic-execution
Source: https://github.com/derickdsouza/dd-claude/tree/main/skills/atomic-execution
Command: npx skills add https://github.com/derickdsouza/dd-claude --skill atomic-execution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Disciplined atomic execution eliminates the inefficiency and risk of bulk commits by enforcing one logical unit of work per commit, paired with a self-verification flow.

Core Features & Use Cases

  • Per-task commits: after each task, commit immediately with verification.
  • Granular staging: stage files individually rather than using git add . or git add -A.
  • Clear commit taxonomy: use feat, fix, test, refactor, or chore for each commit.
  • TDD-driven workflow: write tests, observe red, green, and refactor steps with recorded outcomes.
  • Audit-ready logs: record commit hashes and verification results for traceability.

Quick Start

Follow the workflow to complete a task, stage changes by file, and commit a single logical unit after verification.

Frequently Asked Questions about atomic-execution

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

FAQPage Schema
How do I enforce atomic commits in my git workflow?

Atomic commits require staging files individually and committing one logical unit per task. You must verify each change using a TDD flow before committing with deterministic types like feat, fix, test, refactor, or chore.

What is the best way to track TDD verification results for audit trails?

Tracking TDD verification results involves recording red, green, and refactor outcomes alongside commit hashes. This creates audit-ready logs that map each verifiable change to its specific task and recorded test status.

How do I stop using bulk commits and stage files individually in git?

To stop bulk commits, avoid using git add . or git add -A. Instead, stage files individually using per-file staging commands, ensuring each commit represents a single logical unit of work.

Does atomic execution work with standard commit types like feat and fix?

Atomic execution enforces deterministic commit types including feat, fix, test, refactor, and chore. Each task must be classified under one of these categories before committing the logical unit.

Why should I commit one logical unit per task instead of batching changes?

Committing one logical unit per task eliminates the risk of half-done work by ensuring every change is traceable and verifiable. This disciplined approach replaces bulk commits with audit-ready records of individual features or fixes.

Can I apply atomic commits to refactoring tasks?

Atomic commits apply to refactoring tasks by isolating the refactor as a single logical unit. You stage the modified files individually, run TDD verification, and commit using the refactor type to maintain traceability.