Skip to content

Releases: srdjan/structured-git-commits

v1.0.0

10 Feb 15:03

Choose a tag to compare

First Release

Structured git commits as a queryable agent memory layer - no external infrastructure required.

Skills

  • git-structure-commits: Write commits with structured trailers (Intent, Scope, Decided-Against, Session) from a controlled vocabulary
  • git-query-commits: Query commit history to reconstruct context, understand past decisions, and avoid repeating work

CLI Tools

  • deno task validate - Commit message validation with the commit-msg hook
  • deno task parse - Composable query CLI with intent, scope, session, and decision filtering
  • deno task retrofit - LLM-powered retrofit of existing unstructured commits with --apply for history rewriting
  • deno task context - Git memory context summary (also used by the auto-context hook)

Performance Optimizations

  • deno task graph:write - Commit-graph with changed-paths Bloom filters for path-based query acceleration
  • deno task index:build - Trailer index for O(1) intent/scope/session/decision lookups
  • deno task optimize - Run both at once

Auto-Context Hook (RLM Pattern)

A UserPromptSubmit hook automatically injects recent git history context before every Claude Code prompt. Recent commits, decided-against entries, and session info are surfaced without the agent needing to actively query. See .claude/settings.json and CLAUDE.md for setup.

Composable Query Library

Pure functions for filtering structured commits by intent, scope, session, and decisions - usable programmatically from MCP tools, agent sandboxes, or any Deno/TypeScript environment. See scripts/lib/query.ts.

User Guide

Comprehensive walkthrough for adopting the system: GUIDE.md