v1.4.0

Removed

• Superpowers autoseeding — SessionStart no longer creates 8 superpowers-*.md decision files when the Superpowers plugin is detected. Manufactured decisions conflict with the zero-config, user-authored philosophy. Spec/plan extraction from docs/superpowers/ files is unchanged.

v1.3.0 — Superpowers integration

Features

• Superpowers integration — auto-detects the Superpowers plugin and seeds 8 methodology decisions (TDD, design-first, systematic debugging, subagent-driven development, git worktrees, verification-before-completion, detailed plans, spec-before-quality)
• Decision extraction from specs/plans — scans Superpowers spec and plan files (docs/superpowers/specs/, docs/superpowers/plans/) for trade-offs and approach choices, nudges the agent to capture them as decisions on first implementation edit
• General SeedRegistry pattern for plugin-aware decision seeding, extensible to other plugins

How it works

Install both plugins — no configuration needed. On first session, 8 methodology decisions are seeded and committed to git. When Superpowers writes a design spec or implementation plan, Code Decisions scans it for architectural choices and nudges the agent to capture them so they surface automatically for teammates editing affected files.

Full changelog: v1.2.1...v1.3.0

v1.2.1 — Rebuild rules index on session start

Fixes

• Rebuild rules index at SessionStart when stale — .claude/rules/decisions.md now regenerates automatically when decision files are newer than the index (#14). Previously the index only updated via PostToolUse when Claude Code wrote decision files, leaving it stale when decisions were created outside Claude Code (manual edits, git pull, other tools).

v1.2.0 — Assistant transcript scanning

New

• Assistant transcript scanning — At Stop time, the plugin now reads the session's JSONL transcript and scans assistant messages for decision language, closing the gap where only user messages were detected (#12)
  • Tail-reads last 64KB for performance
  • Same corroboration requirements as user-side detection
  • Deduplicates against phrases already caught by capture_nudge
  • Integrates as highest-priority secondary hint in stop_nudge

v1.1.1 — CLI aliases and Python 3.9+ support

Fixes

• CLI now accepts --tags, --stats, --coverage, --health, and --help flag aliases alongside subcommands
• Updated Python requirement from 3.11+ to 3.9+ for broader compatibility

v1.1.0 — Auto-capture and rules index

Features

• Auto-capture detects decision language and writes .claude/decisions/ files without prompting
• Rules index (.claude/rules/decisions.md) auto-regenerates on capture
• Search skill prefers Grep/Read over CLI to avoid permission prompts

v1.0.0 — Code Decisions

Claude Code plugin that captures decisions — automatically, during normal development, with zero workflow change. Every decision becomes searchable context for your team.

How it works

Capture — You or Claude explain a choice ("use raw SQL, ORM is too slow"). The plugin detects decision language and writes a markdown file. No forms, no commands.

Store — The decision commits to git with affects paths pointing to the files it governs. Teammates inherit on git pull. Shows up in PRs, reviewable like any code change.

Surface — When anyone edits an affected file, relevant decisions inject into Claude's context before it writes code. No one searches. It's just there.

Reinforce — Claude respects the constraint instead of re-debating it. New choices made in that context get captured too. Never blocks — always advisory.

Install

/plugin marketplace add zimalabs/code-decisions

/plugin install decisions@zimalabs

Zero config. Works immediately after restart.

What's included

• Auto-capture — detects decision language and writes markdown files automatically
• Proximity triggering — decisions auto-surface when editing affected files via the affects field
• FTS5 search — BM25-ranked full-text search with incremental sync
• Advise-only nudges — capture nudge, edit checkpoint, stop nudge — coach, never block
• /decision skill — search, capture, browse by tag, undo — when you want explicit control
• Shared via git — committed to the repo, inherited by every teammate's Claude

Links

• README
• CHANGELOG
• Contributing