document git add requirement for untracked files in commit pathspec

[bborbe]

Problem

/coding:commit § 2d mandates git commit -m "msg" -- <paths> and warns that git add alone is insufficient. Both true — but a commit pathspec matches only paths git already tracks, so a brand-new file is rejected outright:

error: pathspec 'commands/and.md' did not match any file(s) known to git

The whole commit fails. This hits every commit that introduces a new file, which is most feature work.

Fix

Documents the add-then-pathspec sequence, and explicitly reconciles it with the existing "git add alone is NOT sufficient" line so the two do not read as contradictory. Includes a pre-check that the index holds nothing staged by a sibling session.

Found while committing a rewritten command in bborbe/claude.

[ben-s-pull-request-reviewer]

The diff is small and purely documentation: CHANGELOG.md (4 lines added) and commands/commit.md (11 lines added). The mechanical funnel confirmed 0 findings. This is a docs-only change — no code, no security-sensitive content, no toolchain needed.

Reviewing the changes:

• CHANGELOG.md — Unreleased entry correctly formatted, describes the bug fix.
• commands/commit.md — New section documents a real git behavior: a commit pathspec only matches tracked files, so untracked (new) files must be git add-ed first. The sequence example is correct and includes a pre-flight git diff --cached --name-only check to avoid sibling-session collisions.

No issues found. The documentation accurately describes git behavior and the changelog follows the project's format.

{
  "verdict": "approve",
  "summary": "Docs-only change adding a CHANGELOG entry and documenting the requirement to git add untracked files before using a pathspec in git commit. Accurate, well-formed, no concerns.",
  "comments": [],
  "concerns_addressed": []
}