# `flow:git-practices` — a repository's commit-and-push discipline, as a family {#root}

<status stage="doc" state="done" audience="user"/>

@fact:AGG-ROLE The **git-practices** family aggregates the distinct disciplines a repository applies to its
Git history. @status:impl/done

@fact:AGG-CLOSURE-PULLS-THE-WHOLE-FAMILY Each is its own installable `flow` package — adoptable alone — and this umbrella
names a tested set of them; requiring `flow:git-practices` pulls the whole family through the
dependency closure, each member contributing its own boot snippet. @status:impl/done

@fact:deliberately-separate-packages-lead They are deliberately **separate packages** because they are different things: @status:impl/done

- @fact:AGG-MEMBER-CONVENTIONAL-COMMITS **`git-conventional-commits`** — the message *format*: `type(scope): subject`, a why-not-what body,
  the allowed-type set, scope convention, worked examples, anti-patterns. @status:impl/done
- @fact:AGG-MEMBER-ATOMIC-COMMITS **`git-atomic-commits`** — the *atomicity* discipline: one commit = one logical idea; when to split
  a mixed working tree, when to batch, why it matters more in a human-AI team. @status:impl/done
- @fact:AGG-MEMBER-ATTRIBUTION-POLICY **`git-attribution-policy`** — the deliberate *authorship posture*: a human-authored surface on
  every artifact by default, one always-loaded statement of it, and the open-disclosure alternative a
  project may adopt instead. @status:impl/done
- @fact:AGG-MEMBER-AUTONOMY **`git-autonomy`** — the *commit autonomy* posture: routine work proceeds without a handshake; the
  red lines (history rewrites, force-push, large blobs, CI/signing/secrets) stop and ask. @status:impl/done

@fact:EACH-IS-ADOPTABLE-ON-ITS-OWN A message can be valid Conventional Commits and non-atomic (`feat: add foo, bar, baz`), or atomic
without the format — so each is adoptable on its own, and the family is how a project takes the
whole posture at once. @status:impl/done

@fact:THE-FAMILY-GROWS-TO-INCLUDE-ATTRIBUTION-AND-AUTONOMY The family is complete at four members:
**human-authored attribution** and **commit autonomy** landed alongside the message format and the
atomicity discipline, and all four are pinned in this package's `vibe.toml`. @status:impl/done

@fact:CONTENT-MINIMAL-NO-BOOT-SNIPPET-OF-ITS-OWN Content-minimal by design (PROP-028): no boot snippet of its own — the members ship theirs. @status:impl/done

## Install {#install}

```bash
vibe install flow:git-practices
```

## License {#license}

@fact:license-line UPL-1.0 — see `LICENSE`. @status:impl/done