git-structure-commits

Create structured git commit messages with typed trailers for intent and scope.

1|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/srdjan/structured-git-commits --skill git-structure-commits
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-structure-commits
Source: https://github.com/srdjan/structured-git-commits/tree/main/skills/git-structure-commits
Command: npx skills add https://github.com/srdjan/structured-git-commits --skill git-structure-commits

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Structured git commits provide a machine-readable memory of decisions and intent by enforcing trailers in commits, enabling agents to reconstruct context from history.

Core Features & Use Cases

  • Enforced Conventional Commits with typed trailers to capture intent and scope
  • Trailers like Intent, Scope, Decided-Against, Session, Refs, and Context enable rich archival of reasoning
  • Use cases include agent-assisted coding sessions and querying history to avoid repeating work

Quick Start

Instruct your AI to format the next commit following the structured trailer rules to capture intent and decisions.

Frequently Asked Questions about git-structure-commits

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

FAQPage Schema
How do I write structured git commits for machine memory?

Structured git commits use typed trailers like Intent, Scope, and Decided-Against to encode rationale alongside changes. This machine-readable format enables agents to reconstruct context and filter history by decisions and session.

What is decision archaeology in conventional commits?

Decision archaeology uses structured commit trailers to capture reasoning and intent. By applying typed trailers such as Decided-Against and Context, you create a searchable history that prevents repeating past work.

How do I capture agent intent and scope in git commit messages?

You capture agent intent by enforcing conventional commit messages with specific trailers. Trailers like Intent, Scope, and Session are appended to commits, providing a structured memory of decisions during agent-assisted coding.

Does this structured commit approach work with standard git workflows?

Yes, structured commits integrate into standard development workflows. The format relies on reference files to validate trailers, ensuring consistency without breaking existing git processes for standard or agent-assisted sessions.

What's the best way to filter git history by decided-against decisions?

Filtering git history by rejected options requires structured commit trailers. By enforcing a Decided-Against trailer in your conventional commits, you create a queryable archive of discarded alternatives and rationale.

When do I need structured commit trailers for my repository?

You need structured commit trailers when managing agent-assisted coding sessions or rebuilding context from history. They provide a machine-readable memory of intent and decisions, enabling agents to avoid repeating work.