skynet/claude-foundations
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit: Claude Code foundations and improvements research

Browse Source 
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>
This commit is contained in:
Paul O'Reilly
2026-03-12 23:02:54 +13:00
commit a4967df815
14 changed files with 765 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

53
TODO.md Normal file
View File

@@ -0,0 +1,53 @@
# 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)