Contributing

Thanks for taking the time to contribute.

This repo mirrors my ~/.claude/ setup, so changes should stay focused, practical, and easy to maintain.

How To Propose Changes

Open an issue with the problem you are solving and the exact files you want to change.
Keep pull requests small and focused. One concern per PR is preferred.
Include before/after notes so the impact is easy to review.

Global rules, hooks, agents, skills, docs, and settings that are intentionally versioned.
Documentation updates that improve clarity or reduce drift.

Copy only intentionally changed files.
Do not bulk-sync unrelated folders.
If a change is global-only and not useful as documentation, do not mirror it here.

When adding a new doc, include a small navigation block at the bottom so readers can continue without jumping back to root docs.

Use one of these headings:

Link to at least two relevant docs from this set when they apply:

Match the existing tone in this repo: