mays

dotfiles

Personal Claude Code configuration, packaged as an installable plugin (mays).

Install

From within Claude Code:

/plugin marketplace add stevenmays/dotfiles
/plugin install mays@dotfiles

Then sync personal settings (optional, overwrites ~/.claude/settings.json):

./sync.sh

Update

After new commits land in this repo, refresh the marketplace catalog — Claude Code re-pulls the source and upgrades the installed mays plugin in the same step:

/plugin marketplace update dotfiles

Then run /reload-plugins when prompted (or restart Claude Code) to load the new version. To make this automatic, enable auto-update for the marketplace under /plugin → Marketplaces → dotfiles.

Non-interactive equivalent:

claude plugin marketplace update dotfiles

What's in the Plugin

Commands

Command	Purpose
/distill-standards [N]	Mine the last N merged PRs (asks how many, default 50) for review patterns, distill into .claude/standards.md
/extreme-code-quality-review	Extremely strict maintainability audit of the current branch, standards-aware
/fix-merge-conflict	Resolve merge conflicts non-interactively
/learn-from-review [PR#]	Distill human review feedback on your PR into .claude/standards.md
/pre-review	Check the branch diff against distilled standards (with staleness warning), then offer to apply fixes
/security-audit	Audit home-directory dotfiles for security issues (read-only report)
/test-and-fix	Run tests and fix failures until green

Skills

Skill	Purpose
extreme-code-quality-review	Rubric for the strict maintainability audit (code-judo, 1k-line rule, spaghetti)
gemini-image-generator	Generate images via Gemini API
serverless-aws	AWS Lambda/DynamoDB/SQS patterns
writing-style	Personal writing voice for technical content

Agents

Agent	Purpose
extreme-code-quality-review	Runs the strict audit in a subagent to protect the main context

Hooks

Hook	Event	Purpose
block-destructive-git	PreToolUse (Bash)	Block force pushes, hard resets, and other destructive git ops
block-hardcoded-secrets	PreToolUse (Edit/Write)	Block edits that introduce hardcoded API keys/passwords
post-edit-format	PostToolUse (Edit/Write)	Auto-format edited files with Prettier when the project uses it

Standards Workflow

/distill-standards          # once per repo (asks how many PRs, default 50)
/pre-review                 # before every PR (warns when standards are stale)
/learn-from-review <PR#>    # after a human reviews your PR

distill-standards reads the repo's merged PR history via gh, extracts recurring review feedback and conventions (distilled rules, not raw comments), and writes .claude/standards.md. pre-review checks your branch against those rules plus a baseline AI-slop checklist (obvious comments, gratuitous defensive checks, as any, single-use abstractions), then offers to apply the fixes. learn-from-review closes the loop: it distills the human feedback on your PR into the ## Manual section of standards.md, which distill-standards carries forward on regeneration — so pre-review catches that feedback before the next reviewer has to.

Every review surface consults .claude/standards.md when it exists: /pre-review and /extreme-code-quality-review load it directly, and sync.sh maintains a managed block in ~/.claude/CLAUDE.md so the native /code-review picks it up in any repo.

The Golden Path (before every PR)

/pre-review                    # standards conformance — catches what reviewers flagged before
/code-review high              # native correctness review — bugs, not style
/extreme-code-quality-review   # structural audit — only for large or structural changes

Then commit, push, and open the PR (plain request — conventions live in the ~/.claude/CLAUDE.md managed block). After human review lands, /learn-from-review.

Settings

settings.json (synced to ~/.claude/settings.json by sync.sh; the script also maintains a managed block in ~/.claude/CLAUDE.md with the standards lookup and git conventions):

• Extended output tokens (64K) and thinking tokens (32K)
• includeCoAuthoredBy: false — no co-author tags in commits
• alwaysThinkingEnabled: true
• permissions.allow — pre-approved safe commands (git status/diff/log, npm run/test, prettier, eslint, tsc, gh)
• enabledPlugins — marketplace plugins, including this one

Structure