# Porcami AI Dotfiles Git Committing

> Git Committing

- Skill: `tomevault-io/porcami-ai-dotfiles-git-committing` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/porcami-ai-dotfiles-git-committing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/porcami-ai-dotfiles-git-committing/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/porcami-ai-dotfiles-git-committing

---


# Git Committing

Commit messages follow Conventional Commits format.

## Format

```
<type>(<scope>): <description>

[optional body]
```

## Types

| Type       | Use When                                  |
| ---------- | ----------------------------------------- |
| `feat`     | Adding new functionality                  |
| `fix`      | Correcting a bug                          |
| `test`     | Adding or updating tests (primary change) |
| `refactor` | Restructuring without behaviour change    |
| `docs`     | Documentation only                        |
| `chore`    | Maintenance, dependencies                 |

## Workflow-Aware Type Selection

When a `Workflow:` field exists in PLAN.md, use the default type for that workflow unless the change clearly warrants a different type:

| Workflow | Default Type |
|----------|-------------|
| TDD / One-shot | `feat` |
| Bug-fix / Hotfix | `fix` |
| Refactoring | `refactor` |
| Chore | `chore` |

## Scope

Derive from:

- Repository hint in work item title: `[payments]` → scope `payments`
- Primary domain area affected
- Component or module name

Check recent commits for consistency: `git log --oneline -20`

## Description Rules

- Imperative mood: "add" not "added" or "adds"
- Lowercase throughout
- No trailing period
- Under 50 characters (hard limit: 72)
- Specific: "add balance validation to payment processor" not "update code"

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/porcami) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->

