The Clerk — Development agent for Claude Code
Housekeeping auditor for your git repos and your notes repo.
How to install The Clerk
Installs to ~/.claude/agents/tomasfpm-claude-code-guardrails-the-clerk.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/tomasfpm/claude-code-guardrails/HEAD/agents/the-clerk.md -o ~/.claude/agents/tomasfpm-claude-code-guardrails-the-clerk.md Restart Claude Code, or start a new session, for it to be picked up.
What The Clerk does
name: the-clerk description: Housekeeping auditor for your git repos and your notes repo. Checks that nothing is uncommitted, unpushed or stale; that the notes' index, links and frontmatter are consistent; and that the same fact has not drifted between two files that both state it. Reports only — never commits, pushes or edits. Run at the end of a working session, and only after should-i-run.sh says there is something to find. tools: Read, Grep, Glob, Bash
You are the clerk. You keep th
Alternatives in Development
- Get Commit ID — gh api repos/OWNER/REPO/pulls/PR_NUMBER --jq '.head.sha' gh api repos/OWNER/REPO/pulls/PR_NUMBER/comments \ 1.3k ★
- Refactor Validator — Use this agent when a significant refactoring has been completed and you need to verify that the changes are c 358 ★
- Review Fix Agent — Code review + auto-fix agent 149 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Self Reviewer
Blunt pre-PR review of the author's own uncommitted or unpushed changes. Use before opening a PR, to catch wha
Branch Gardener
Triages local branches and stashes in a managed repo (merged, stale, superseded, unpushed) and proposes deleti
Docs
Keeps README/AGENTS consistent with repo reality, lints Markdown, and checks links.
Readme Clarity Reviewer
First-contact reader clarity reviewer for READMEs / repo top pages. Reads the README as a visitor who just lan
Sandbox Runner
Runs untrusted, unfamiliar or agent-written code inside a sealed kosa8 microVM and reports the results, so not
Rustkb Curator
Maintains the rustkb curated knowledge base itself — fixes drift reported by rustkb stale (new crate majors, n
Related Skills
Find Stale References
Find references that point at nothing — doc links and paths to moved files, backticked symbols that were renam
Last Push
Claude Code mod: when this project was last committed and pushed — unpushed commits, uncommitted files, stalen
Worktree Hygiene
Report the state of every git branch and worktree in a repo (unpushed, unmerged, stale, merged) and clean up o