Name: better-comments
Author: a3lem

a3lem's Claude Code Plugins

Personal collection of Claude Code plugins, published as a marketplace.

spec-driven-dev - Spec-driven development with Gherkin scenarios, reference/changes separation, and structured archive flow.
basedpyright-lsp - Enables the basedpyright LSP server for Python type checking.
python-rules - Python rules. Injected via hook.
theo-calvin-testing - Differential testing with tc: input.json to output.json, diffed against expected.json.
session-setup - Runs Session Setup steps from CLAUDE.md on session start.
ticket-cli - Integration for tk, a git-backed issue tracker for AI agents.
auto-memory - Clone of Claude's built-in auto-memory, but stores memories in the project directory instead of ~/.claude/.
frontmatter - Use frontmatter in code files to track human review and set (soft) access controls for AI.
better-comments - Comment blocks that state their AI origin and focus on context, intent, and assumptions -- the "why", not the "what".
project-notes - Working knowledge in notes/, structured decision log, and timestamped journal entries.
project-knowledge - Routes knowledge to the right store based on contract strength.

Three plugins work together to manage project knowledge:

Store	Plugin	Contract	Purpose
`specs/`	spec-driven-dev	Strongest	Behavioral truth — Gherkin scenarios, verified before shipping
`docs/`	(none needed)	Strong	Durable reference — maintained, authoritative
`notes/DECISIONS.md`	project-notes	Medium	What was decided — concise `dcn-xxxx` entries
`notes/`	project-notes	Weak	Working knowledge — may go stale
`notes/journal/`	project-notes	Weakest	Timestamped snapshots — decay over time

project-knowledge provides routing rules for deciding where information should live and where to look for it.

better-comments