---
title: "@cleepi/git"
status: shipped
created: 2026-05-28
owner: Honza
related:
  - ../../docs/DRAFT-001-cleepi-git-v0.1.0/spec.md
---

# `@cleepi/git`

## What this package is

A pi package that ships Cleepi's git conventions as durable
instructions. Install it in any repo and pi sessions there know
how to write commits the cleepi way.

Two things ship in v0.1.0:

- **Skill** (`skills/git-commit/SKILL.md`) — the canonical
  commit-message convention. Loaded on demand or with
  `/skill:git-commit`.
- **Prompt** — `/commit <type> <message>`. Resolves domain
  (from cwd) and ticket-id (from cwd → branch → ask), assembles
  the message, strips any AI-tooling-injected `Co-authored-by:`,
  and runs `git commit`.

The convention itself is documented in the skill, not here.
Read [`skills/git-commit/SKILL.md`](skills/git-commit/SKILL.md)
for the canonical version.

## What this package is not

- **Not a lint or hook enforcer.** The skill instructs; it
  doesn't police. No `commit-msg` hook ships. Enforcement is
  deferred until friction shows up.
- **Not a branch / PR / rebase toolkit.** v0.1.0 ships *only*
  the commit-message convention. Branch naming, PR templates,
  and rebase discipline are v0.2.0+ candidates.
- **Not a changelog generator.** Commits don't auto-write
  changelog entries. That's `@cleepi/sdd`'s `/changelog`.
  The link between commit and changelog is the ticket-id,
  read by humans.
- **Not configurable.** The Angular type set is fixed
  (`feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`,
  `chore`, `build`, `ci`, `revert`). Teams wanting extra types
  edit a project-scope copy of the skill.
- **Not opinionated about ticket trackers.** Ticket-id can be
  `AC-NNN`, `LIN-NNN`, `gh-NN`, `DRAFT-NNN`, anything matching
  `[A-Z]+-[0-9]+`. The skill doesn't validate.
- **Not a hard dependency on `@cleepi/sdd`.** Soft-aware: when
  sdd is loaded, the ticket-folder resolution chain matches
  `/journal`'s. When sdd isn't loaded, the branch-name and
  ask-user fallbacks still work.

## Design at a glance

```
packages/git/
  package.json
  README.md
  SPEC.md                        ← this file
  CHANGELOG.md
  skills/git-commit/SKILL.md     ← the canonical convention
  prompts/commit.md              ← /commit
```

## The format (one-line summary)

```
<type>(<domain>): [<ticket-id> ]<message>
```

Subject line only. No body. No footers. **No `Co-authored-by:`.**
See the skill for the full discipline.

## Versioning

Per-package SemVer. Pre-`1.0.0`, minor bumps may include
breaking changes (per SemVer §4).

## Related

- [`skills/git-commit/SKILL.md`](./skills/git-commit/SKILL.md) —
  canonical convention.
- [CHANGELOG.md](./CHANGELOG.md) — release history.
- Root cleepi [spec DRAFT-001](../../docs/DRAFT-001-cleepi-git-v0.1.0/spec.md) —
  the v0.1.0 design rationale.
- [`@cleepi/sdd`](../sdd/) — soft-aware sibling; `/commit`
  shares ticket-resolution logic with `/journal`.