Surface Auditor — Development agent for Claude Code
Checks that every published surface still describes this binary — site prose, README, FEATURES, CHANGELOG/BACKLOG lifecycle, docs and ADRs.
How to install Surface Auditor
Installs to ~/.claude/agents/assaio-assaio-surface-auditor.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/assaio/assaio/HEAD/.claude/agents/surface-auditor.md -o ~/.claude/agents/assaio-assaio-surface-auditor.md Restart Claude Code, or start a new session, for it to be picked up.
What Surface Auditor does
name: surface-auditor description: Checks that every published surface still describes this binary — site prose, README, FEATURES, CHANGELOG/BACKLOG lifecycle, docs and ADRs. Use on any user-facing change and before every tag. Read-mostly. tools: Read, Grep, Glob, Bash
A release ships more than a binary. This repo has published a page describing a version it was not running twice: `site/index.html` advertised v0.2 while v0.5.0 was tagged, and later `digest` and `mark --suggest` shipped
Alternatives in Development
- TAGS — Tag Vocabulary 2.3k ★
- Constitutioner — Agent Constitutioner — gère les ADRs (création atomique par timestamp) et met à jour workspace/.sys/.context/c 193 ★
- Docs Staleness Detector — Use this agent when a core change has been made to the repository and you need to verify that related document 173 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Growth Consent
Tracking, ads and privacy specialist. Describes cookie-consent behaviour factually: what is shown, how easy de
Dependency Drift
Verifies that code — generated by @zanix/cli, or cited/claimed by a skill's own examples — still compiles agai
Gads Gtag
Google tag / GA4 link / Enhanced Conversions auditor. Verifies the site has gtag or GTM, the Google Ads accoun
Changelog Drafter
Reads git log since last tag, drafts CHANGELOG entry. Groups commits by conventional-commit type, rewrites for
Changelog Updater
Parses commits between the most recent tag and HEAD, then appends Keep a Changelog-formatted entries to CHANGE
Play Release Notes
Generate Google Play "What's new" release notes from git history. Use when the user says "release notes", "wha
Related Skills
Rogue Changelog Generator Skill
Transform git commit history into polished user-facing changelogs and release notes. Use when the user wants a
Blind
Strategy-level blind drill on a known HW or example problem. User describes approach in prose (no math typing)
Sth Fb
Log skill feedback with AI auto-analysis. User describes the pain point in plain language — AI infers type, pr