akashtalole

Validate Service Docs — Development agent for Claude Code

Development community

Validate a service README against its Makefile targets.

How to install Validate Service Docs

Installs to ~/.claude/agents/akashtalole-run-ai-validate-service-docs.md

Terminal

mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/akashtalole/run-ai/HEAD/.claude/agents/validate-service-docs.md -o ~/.claude/agents/akashtalole-run-ai-validate-service-docs.md

Restart Claude Code, or start a new session, for it to be picked up.

What Validate Service Docs does

name: validate-service-docs description: Validate a service README against its Makefile targets. For a single service provide its path; say "all" to check every undocumented service listed in CLAUDE.md. tools:

Bash
Read

Finding the repo root

REPO_ROOT=$(git rev-parse --show-toplevel)

All paths are relative to `$REPO_ROOT`. Never use absolute user-specific paths.

Modes

**Single service:** user provides e.g. `control-plane/authorization`. Validate that one.

Alternatives in Development

Validate Agent — You are a specialized validation agent 3.6k ★
Service Documentation — Use ONLY when you and the user have identified that existing documentation has drifted significantly from the 571 ★
Ontology Reasoner — Use this agent when you need to validate the logical consistency of an ontology, check for reasoning errors, i 163 ★