Motivation
Git exposes excellent low-level primitives, but many common maintenance tasks
still require humans and coding agents to assemble fragile command sequences.
The desired outcome is often simple; the implementation is not.
Git Intent should capture those operations once as deterministic,
recovery-aware tools reusable by developers, automation systems, and agent
ecosystems.
Project thesis
Express the Git intent, not the surgery.
An operation belongs in Git Intent when:
- its intent is common;
- its raw Git implementation is non-trivial or risky; and
- it can be given explicit safety and recovery semantics.
Git Intent should build on mature Git tooling rather than reproduce it merely
for ownership.
Initial reference operation
Introduce git-fix-author, based on an author-history repair workflow that has
already exposed real failure modes around pagers, committer identity, merge
topology, empty commits, ref movement, and recovery.
The operation rewrites author and committer attribution across an inclusive
commit range while preserving its documented history invariants and creating a
native Git recovery ref before mutation.
Git discovers the installed git-fix-author executable as:
Operation lifecycle
The first implementation establishes the repository-wide lifecycle:
- preflight;
- resolve;
- preview;
- checkpoint;
- execute;
- verify; and
- recovery and publishing guidance.
Agent integration
Package the operation as an Agent Skill with:
- precise trigger metadata;
- explicit exclusion cases;
- the canonical executable;
- a focused Git-semantics reference; and
- a dry-run-first workflow.
The skill should select and invoke a reviewed operation rather than teach an
agent to improvise equivalent history surgery.
The agent chooses the operation. The operation owns the surgery.
Deliverables
Required git-fix-author invariants
Non-goals
- Replacing Git or creating another VCS
- Wrapping ordinary Git commands
- Building a generic Git agent or prompt pack
- Building a skills marketplace
- Building a plugin or engine-adapter framework before real operations require
one
- Implementing backup lifecycle management inside the initial rewrite path
Motivation
Git exposes excellent low-level primitives, but many common maintenance tasks
still require humans and coding agents to assemble fragile command sequences.
The desired outcome is often simple; the implementation is not.
Git Intent should capture those operations once as deterministic,
recovery-aware tools reusable by developers, automation systems, and agent
ecosystems.
Project thesis
An operation belongs in Git Intent when:
Git Intent should build on mature Git tooling rather than reproduce it merely
for ownership.
Initial reference operation
Introduce
git-fix-author, based on an author-history repair workflow that hasalready exposed real failure modes around pagers, committer identity, merge
topology, empty commits, ref movement, and recovery.
The operation rewrites author and committer attribution across an inclusive
commit range while preserving its documented history invariants and creating a
native Git recovery ref before mutation.
Git discovers the installed
git-fix-authorexecutable as:git fix-authorOperation lifecycle
The first implementation establishes the repository-wide lifecycle:
Agent integration
Package the operation as an Agent Skill with:
The skill should select and invoke a reviewed operation rather than teach an
agent to improvise equivalent history surgery.
Deliverables
git-fix-authorRequired
git-fix-authorinvariantsrefs/backup/author-rewrite-*unless--no-backupis explicit.Non-goals
one