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
- Cross Linker — Scan recent or specified notes for missing wikilinks 4.6k ★
- 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 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Branch Gardener
Triages local branches and stashes in a managed repo (merged, stale, superseded, unpushed) and proposes deleti
Review Fix Agent
Code review + auto-fix agent. Reviews uncommitted changes for bugs, stale refs, duplication, and abstraction g
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
Config Verifier
Read-only reviewer that checks the repairs applied by config-fixer during a claude-checkup run — confirms each
Rustkb Curator
Maintains the rustkb curated knowledge base itself — fixes drift reported by rustkb stale (new crate majors, n
Related Skills
Obsidian Agent
A complete system for managing Obsidian vaults with Claude Code and Cowork. Designed for two vaults (work and
Frontmatter Normalizer
Use when auditing or normalizing note frontmatter to a consistent schema across a folder or the vault. Defers
Repo Sync
Check if focused repositories are up to date with the remote. Fetches latest changes and warns about repos tha