Commit

/commit — Context-Enriched Committer

Create git commits that track AI context evolution alongside application changes. When AI-layer files are part of the commit, a Context: section is appended to the commit body — making git log long-term, queryable memory for future sessions and agents.

Current state

!git status

!git --no-pager diff --stat HEAD

Recent commits (style reference): !git log --oneline -5

> If the blocks above show errors or unexpanded variables, run the commands yourself with Bash.

Execution Flow

1. Parse arguments. If $ARGUMENTS starts with the standalone word push (case-insensitive): enable push-after-commit, use the remainder as the commit message (may be empty).

1. Check for committable changes in the state above. Nothing staged, unstaged, or untracked → report "Nothing to commit — working tree clean." and stop. Run git --no-pager diff HEAD for the full diff when the stat summary is not enough to write an accurate message.

1. Classify every changed and untracked file:

• Application code — stage normally
• AI context files (paths below) — stage normally; flag for the Context section
• Sensitive files (.env, *.key, *.pem, credentials.*, *secret*) — do not stage; warn the user
• Unrelated concerns — if changes span multiple unrelated concerns and $ARGUMENTS gives no hint, ask before bundling

1. Stage files individually (git add ). Never git add -A or git add ..

1. Detect AI context changes. Check git --no-pager diff --cached --name-only against the AI Context Paths below.

1. Draft the message.

• $ARGUMENTS provided: use it; prepend a conventional prefix (feat:, fix:, refactor:, docs:, test:, chore:) if missing, inferred from the changes.
• Empty: auto-generate from the staged diff — focus on why, not what.

1. Append the Context section when AI-layer files are staged (omit entirely otherwise):

``` Context:

• —

```

1. Commit via heredoc:

```bash git commit -m "$(cat :

Context:

• —

EOF )" ```

1. Verify and report: short hash, subject line, whether a Context section was included and how many AI-layer files it tracked.

1. Push (if requested). git push; no upstream → git push -u origin . On failure: report the error, never retry with --force.

AI Context Paths

• .wisci/** — WISCI context store (context files, handoffs, primer, index)
• CLAUDE.md, .claude/CLAUDE.md — project instructions
• .claude/rules/**, .claude/commands/**, .claude/skills/**, .claude/agents/**, .claude/hooks/** — Claude project config
• .claude/settings.json, .claude/plugins/** — Claude settings and plugins
• .mcp.json — MCP server config
• skills/**, .claude-plugin/**, hooks/** — plugin/skill definitions (when the repo is itself a plugin)
• .agents/** — cross-client agent skills
• .cursorrules, .cursor/rules/** — Cursor rules
• .github/copilot-instructions.md — Copilot instructions
• AGENTS.md, codex.md, .codex/** — Codex instructions
• GEMINI.md, .gemini/** — Gemini CLI instructions and config

A staged file matches if its path starts with a directory prefix above or exactly matches a filename entry.

Examples

Application + context changes:

feat: add token refresh to auth middleware

Automatic refresh when access token expires. One retry before 401.

Context:
- update .wisci/context/auth-research.md — added token refresh decision and rationale

Context-only changes:

docs: persist Stripe integration research

Context:
- create .wisci/context/stripe-integration.md — /isolate research results
- update .wisci/handoff/payments.md — Stripe added to in-progress work

Key Constraints

• Never --no-verify. Pre-commit hook fails → report and stop.
• Never force-push.
• Never git add -A / git add .. Stage by name.
• Never stage sensitive files.
• Context section is conditional — only when AI-layer files are actually staged.
• One logical commit — ask before bundling unrelated concerns.
• Respect user intent — a provided message is used as-is apart from prefix and Context additions.
• All diffs with --no-pager.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ph3on1x
• Source: ph3on1x/wisci
• License: MIT

Install and usage instructions live in the source repository linked above.