dotfiles

Best practices for creating, editing, and maintaining Go projects. Covers project structure (golang-standards/project-layout), code style (Uber Go Style Guide + Effective Go), linting (golangci-lint), formatting, and testing conventions. Use when: (1) creating a new Go project or module, (2) writing or editing Go code, (3) adding packages or restructuring a Go codebase, (4) setting up linting/formatting for a Go project, (5) writing or reviewing Go tests, (6) any task involving .go files or Go modules. Triggers: "go project", "golang", ".go file", "go module", "go test", "go lint", "write go code", "new go service".

Generate Architectural Decision Records (ADRs) in MADR format. Invoke when the user requests an ADR or when the adr-review skill surfaces uncovered architectural decisions and the user agrees to record them. Do NOT auto-create ADRs without user approval. ADRs are written to docs/adr/ in the current git repository.

Review plans and implementations for ADR compliance. Invoked at two mandatory gates defined in CLAUDE.md: (1) after writing a plan, before user approval, and (2) after implementation, before claiming completion. Only applies when docs/adr/ exists. Dispatches the adr-review agent as a subagent to keep ADR content out of the main context window.

Create, edit, and manage Python projects using UV for package management, ruff for linting/formatting, and mypy for type checking. Use when: (1) setting up a new Python project or script, (2) editing Python code, (3) adding dependencies to a Python project, (4) running or debugging Python scripts, or any task involving Python development. Triggers: "create a python project", "set up a python script", "edit this python file", "add a dependency", "write a python tool", "make a CLI in python".