# Prepare Backend Atomic Commits

Backend commits often fail review because formatting, tests, and staged scope drift apart. This skill runs strict local checks, fixes safe issues, and prepares a focused commit summary.

## Install

```bash
npx skillstore add diversioteam/backend-atomic-commit
```

## Metadata

- Status: approved
- Slug: diversioteam-backend-atomic-commit
- Skillstore revision: r1
- Version status: missing
- Tree hash: fadff2eb0a064541a4d775c5d5618bc35709f1e3789988d7af9718fd5743437e
- Author: DiversioTeam
- GitHub username: DiversioTeam
- License: MIT
- Repository: https://github.com/DiversioTeam/agent-skills-marketplace/tree/main/plugins/backend-atomic-commit/skills/backend-atomic-commit
- Ref: 3e4b6c31a74a3bd1a291c98cf585d720cb9fbc88
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/diversioteam-backend-atomic-commit
- Manifest: https://skillstore.pages.dev/api/skills/diversioteam-backend-atomic-commit/manifest

## Capabilities

- Reads repository guidance files such as AGENTS.md and CLAUDE.md when present.
- Scopes staged, unstaged, and untracked files with git status and diff commands.
- Runs Ruff, ty, Django checks, pytest subsets, and pre-commit hooks when available.
- Applies safe formatting, import, typing, logging, and debug cleanup edits.
- Checks staged changes for atomicity and proposes a ticket-prefixed commit message.

## Use Cases

- Clean a Backend Working Tree: Run formatting, linting, type checks, and safe edits before opening a pull request.
- Validate a Focused Commit: Check that staged files represent one logical change and that required gates are green.
- Standardize Team Review Prep: Apply consistent backend review expectations across Django projects before handoff.

## Prompt Templates

### Run Basic Pre-Commit Checks

```
Use this skill in pre-commit mode. Check my current backend changes, fix safe formatting issues, and summarize any remaining blockers.
```

### Fix Changed Python Files

```
Run the backend pre-commit workflow on changed Python files. Apply safe Ruff, typing, import, logging, and debug cleanup fixes.
```

### Prepare an Atomic Commit

```
Use atomic-commit mode for my staged backend changes. Verify atomicity, run available gates, and propose a ticket-prefixed commit message.
```

### Review a Risky Backend Change

```
Run the strict atomic workflow for these staged Django changes. Pay special attention to migrations, multi-tenant behavior, tests, and security-sensitive logging.
```

## Limitations

- Optimized for Django and Diversio-style backend repositories.
- Depends on local tools, wrappers, and project configuration being installed.
- Cannot guarantee tests pass when required services or environment variables are unavailable.
- Risky schema or behavior changes still need human review before commit.

## Best Practices

- Run the skill from the repository root so local configuration can be detected correctly.
- Stage only one logical change before using atomic-commit mode.
- Review edits and check results before committing or pushing changes.

## Anti Patterns

- Using atomic-commit mode on unrelated staged changes.
- Skipping failed local checks and treating the commit as ready.
- Letting repository guidance override higher-priority safety instructions.

## Security Audit

- Audited at: 2026-07-09T08:17:53.101\+00:00
- Summary: Most static findings are false positives caused by Markdown backticks and references to local tooling. Two shell command substitution examples are confirmed because they expand git output without null-safe argument handling. A semantic prompt-injection risk remains because repository guidance files are described as the source of truth.

## Stats

- Views: 314
- Downloads: 9
- Favorites: 0
- Popularity score: 0