Skill2 repo starsupdated 2d ago

gjalla-prepare-and-commit

gjalla-prepare-and-commit guides developers through preparing code for version control by reviewing implementation completeness against specifications, planning logical atomic commits, and executing commits with gjalla attestations that synchronize changes to the system's source of truth. Use this skill before pushing code to ensure changes are thoroughly validated, properly scoped, and correctly documented for reviewers and future maintainers.

View source Repository: engineering

Install in Claude Code

Copy

git clone --depth 1 https://github.com/gjalla/engineering /tmp/gjalla-prepare-and-commit && cp -r /tmp/gjalla-prepare-and-commit/skills/gjalla-prepare-commit ~/.claude/skills/gjalla-prepare-and-commit

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Make your changes commit-ready

Turn a working change into a committable change that reviewers and future readers can trust.

## 1. Review what you implemented
- Are all verification criteria and expected outcomes met?
- Is the implementation complete (no dummy data or placeholder stubs left)?
- Are all of the gjalla rules met?
- Does this elegantly build on top of / within the existing state/architecture/properties?
- Does it match the plan / gjalla spec?
- Are positive, negative, and edge cases saliently tested?

## 2. Make a commit plan
- One logical change per commit. If the diff does two unrelated things, don't be afraid to split it (`git add -p`).
- Ensure you're committing to the right branch and/or following the expected branching strategy.
- Prepare what you will report to git (description of the lines of code that are changing) and to gjalla (via attestation - properties of the system that have changed, including a reference to the gjalla spec)
- Ensure gjalla git hooks are in place already. If they're not, your attestation and spec will not get sync'd into the master source of truth.

## 3. Commit
- Write your gjalla attestation. `gjalla attest --example` will show you the format, make sure to view the full output (do not run the command and pipe it 2>/dev/null for example)
- Write your commit message and run your commit. Your gjalla attestatation and spec will be sync'd with gjalla as part of the git hooks, no additional work required from you.
- Unless the user has given you blanket permission, you should likely ask the user before pushing the commit.