Authorship: Ideas & notes — Daniel. Refinement & writing — Claude Opus 4.6.
Claude Code is a hugely powerful CLI that has made made agentic AI accessible to many.
It is also an incredibly fast-moving product: I saw a joke on X that you would have to be unemployed to keep up with developments. It's true!
I created this repo to jot down a few casual "cliff notes" for using it.
Because of how fast moving Claude Code is, this small store of notes is a kind of self-immolating information store: many of the hacks I put in place just a few months ago are now redundant.
In fact, if we look at the course of evolution so far, the general pattern is something like:
- People use Claude
- The open source community - myself included - finds points of friction and fills those gaps with tooling/bolt-ons. Occasionally, it's heralded as the next big thing and a "Claude-killer"
- Anthropic takes notes or was working on these things anyway. It releases an update.
- Open source world reverts to loving Claude until next set of friction points are discovered.
- Cycle repeats!
From a jaundiced perspective, this might seem silly. But in a way, it's virtuous: we get hot fixes that are then folded back to the product. A more probative question is that of ethics: when open source contributors make Claude better - and Anthropic makes lots of money from the product and charges the very users who spotted those flaws - shouldn't the value be distributed a bit more equitably?
| Note | Date | Summary |
|---|
| The Agent Picker Pattern | 25/03/2026 | Solving the "too many subagents" problem with an orchestration agent that selects the right crew |
| The Claude Agent Workspace Model | 25/03/2026 | Using repos as structured workspaces for non-software work — the most important pattern, with 8 real implementations |
| Planning Folder With UUID-Tagged Plans | 06/04/2026 | A planning/ folder with plans, handovers and logs — every plan gets a UUID as ground-truth reference for resume commands |
| Private Plugin Architecture: Workspace, Plugin, MCP Variations | 29/04/2026 | Five variations for private plugins (plugin-only, +workspace, +bundled MCP, +separate MCP via MCP Jungle, +workspace +MCP), decision tree, .mcp.json invocation tradeoffs |
| Note | Date | Summary |
|---|
| Declaude | 25/03/2026 | Build personal writing rules and enforce them on AI-generated content via a slash command |
| No Wheel Inventions | 25/03/2026 | Slash commands to stop Claude reinventing the wheel when good packages exist |
| Claude Handover Plugin | 06/04/2026 | Plugin formalising session handover — writes HANDOVER.md and spawns a new Konsole with Claude pre-loaded to resume |
| Claude Slash Commands | 06/04/2026 | Index repo for 350+ custom slash commands across dev, docs, security, and sysadmin categories |
| Claude Document This | 06/04/2026 | Plugin for capturing sysadmin fixes and routing the writeup to Notion, Obsidian, or email |
| Claude Janitor | 06/04/2026 | Plugin for tidying up repos from Claude-related artefacts and stray scaffolding |
| Plugin User-Data Storage | 21/04/2026 | Where plugins should persist per-user state — why ~/.claude/ is wrong, why XDG Base Directory is right, and how to set it up |
| Intentional Project-Level Plugin Installation | 27/04/2026 | When and why to install a plugin at project scope rather than user-level |
| Shipping A Claude Code Plugin With A Repo | 27/04/2026 | Bundling a plugin alongside the repo it serves so collaborators get it via project-scope install |
| Plugins With Decoupled Templates | 28/04/2026 | Keeping plugin logic and the template repos it operates on as separate, loosely-coupled units |
| Private Claude Code Marketplaces | 01/05/2026 | Run parallel public + private marketplaces — neither marketplace nor plugin repos need to be public, fully private chains work |
| Note | Date | Summary |
|---|
| New Turn Claude Hook | 06/04/2026 | Concept hook for auto-deciding when to start a fresh conversation vs continue the current one |
| Note | Date | Summary |
|---|
| Claude Repo Creator | 06/04/2026 | Workspace for generating GitHub repos from natural language — local, remote, and scaffolding in one shot |
| Note | Date | Summary |
|---|
| Claude MD Chunk | 06/04/2026 | CLI tool that prunes bloated CLAUDE.md and offloads detail into an agent-context/ folder |
| Note | Date | Summary |
|---|
| Claude Code Bash Aliases | 06/04/2026 | Curated bash aliases for Claude Code workflows on Linux, version-controlled with YADM |
| Note | Date | Summary |
|---|
| Claude MCP Guidelines | 25/03/2026 | CLAUDE.md snippet for deterministic MCP tool selection and conflict resolution |
| Note | Date | Summary |
|---|
| Claude Space Self-Ideator | 25/03/2026 | A meta workspace that generates ideas for more workspaces — exploratory and self-referential |
| Claude Task Manager | 25/03/2026 | Spec for a sequential task queue to solve context window exhaustion across multi-task projects |
| Note | Date | Summary |
|---|
| Claude Code Notebook | 25/03/2026 | Personal reference notebook for Claude Code CLI — config files, CWD behaviour, MCP setup on Linux |
Longer-form reference material (folded in from the former Claude-Code-Notebook repo):
For more Claude Code projects, visit my Claude Code Repos Index.