← ClaudeAtlas

conventionslisted

Scaffold or update docs/CONVENTIONS.md by reading the actual codebase and interviewing the user. Use when setting up a new project or when conventions have drifted and need to be documented. Trigger this when someone says: document our team standards, set up conventions, what are our coding standards, conventions are out of date, update our style guide, write our CONVENTIONS.md. Do NOT use to read or apply existing conventions — those are loaded automatically. Do NOT use for architectural decisions — use /memory-audit instead.
chuckplayer/claude-agent-pack · ★ 2 · AI & Automation · score 75
Install: claude install-skill chuckplayer/claude-agent-pack
# Conventions Scaffold or update `docs/CONVENTIONS.md` by grounding it in the actual codebase — not templates or guesses. This skill is interactive. It reads existing code to discover what conventions are already in use, then asks the user to confirm, correct, or extend them. ## 1. Check current state - Does `docs/CONVENTIONS.md` already exist? - **Yes:** read it fully. This is an update run. Identify which sections need revision. - **No:** this is a fresh scaffold. Read `docs/CONVENTIONS.template.md` if it exists for the expected structure. - Check `memory/**/*.md` for any architecture or design decisions that should be reflected in conventions. ## 2. Read the codebase to discover actual conventions Use Glob and Grep to observe what the code actually does — conventions should describe reality, not aspiration. Sample across all layers: | Category | What to look for | |----------|-----------------| | **Naming** | Class/method/variable casing, file naming, interface prefix (`I`?) | | **Architecture** | Directory layers, dependency flow (DI? static?), repo/service/controller separation | | **Error handling** | Catch/log patterns, global error handler, return type (exception/Result\<T\>/tuple) | | **Testing** | Framework, file location pattern, test class naming, mocks vs. real deps | | **Frontend** | Options vs. Composition API, state management, API call pattern (fetch/axios/generated) | | **Other** | Logging levels, auth patterns, compliance requirements visible in