a4967df815
Conventions, community best practices research (Sept 2025 - March 2026), and prioritized improvement backlog for Claude Code workflows. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
54 lines
3.2 KiB
Markdown
54 lines
3.2 KiB
Markdown
# TODO: Top 10 Improvements
|
|
|
|
Prioritised by impact and effort. Each item references its detailed topic file in `improvements/`.
|
|
|
|
## 1. Configure PostToolUse auto-formatting hook
|
|
**Impact: High | Effort: Low**
|
|
Auto-format code after every Edit/Write. Removes all formatting rules from CLAUDE.md, saves tokens, and guarantees consistent output. Start with `shfmt` for shell and expand.
|
|
See: [hooks-and-automation.md](improvements/hooks-and-automation.md)
|
|
|
|
## 2. Create global `~/.claude/CLAUDE.md`
|
|
**Impact: High | Effort: Low**
|
|
Move cross-project conventions (Gitea, secrets, SSH, commit format, response style) out of the project-level CLAUDE.md. Reduces duplication and frees ~40 lines from every project file.
|
|
See: [global-configuration.md](improvements/global-configuration.md)
|
|
|
|
## 3. Configure PreToolUse security hook
|
|
**Impact: High | Effort: Low**
|
|
Block writes to secrets files, `.env`, lockfiles, and destructive commands. Deterministic protection vs. hoping Claude remembers the CLAUDE.md rule.
|
|
See: [hooks-and-automation.md](improvements/hooks-and-automation.md)
|
|
|
|
## 4. Install Context7 MCP server
|
|
**Impact: High | Effort: Medium**
|
|
Real-time, version-specific documentation for Helm charts, Kubernetes APIs, and any library. Eliminates knowledge-cutoff guesswork — particularly valuable for cluster-bootstrap.
|
|
See: [mcp-servers.md](improvements/mcp-servers.md)
|
|
|
|
## 5. Build `/catchup` skill
|
|
**Impact: Medium | Effort: Low**
|
|
Reads git diff, changed files, and relevant memory when resuming work. Automates the manual "what changed since last session?" flow.
|
|
See: [skills-and-progressive-disclosure.md](improvements/skills-and-progressive-disclosure.md)
|
|
|
|
## 6. Build `/validate` skill
|
|
**Impact: Medium | Effort: Low**
|
|
Codifies the "validate before deploying" principle into a single command. Runs helm template, kustomize build, linting as appropriate. Prevents deploy-crash-fix cycles.
|
|
See: [skills-and-progressive-disclosure.md](improvements/skills-and-progressive-disclosure.md)
|
|
|
|
## 7. Install Language Server plugin
|
|
**Impact: High | Effort: Medium**
|
|
`boostvolt/claude-code-lsps` gives Claude real-time types, go-to-definition, and find-references. "The single biggest productivity gain" per community consensus.
|
|
See: [plugins-and-language-servers.md](improvements/plugins-and-language-servers.md)
|
|
|
|
## 8. Add PreCompact transcript backup hook
|
|
**Impact: Medium | Effort: Low**
|
|
Save conversation transcript before auto-compaction. Pairs with auto-memory to ensure no context is lost during long sessions.
|
|
See: [hooks-and-automation.md](improvements/hooks-and-automation.md)
|
|
|
|
## 9. Prune and restructure project CLAUDE.md
|
|
**Impact: Medium | Effort: Medium**
|
|
After creating the global file (item 2), prune the project CLAUDE.md. Move discoverable info out, rewrite prohibitions as positive guidance, add verification commands section, put critical rules at the top.
|
|
See: [claude-md-refinements.md](improvements/claude-md-refinements.md)
|
|
|
|
## 10. Adopt Plan Mode as default workflow
|
|
**Impact: High | Effort: Zero**
|
|
Use Shift+Tab twice before any non-trivial task. Iterate on the plan before executing. Boris from Anthropic says this "easily 2-3x's results." No tooling needed — just a habit change.
|
|
See: [planning-and-workflow.md](improvements/planning-and-workflow.md)
|