About specdog
specdog is a toolkit for making software specs easier for both humans and AI agents to read. The goal is simple: keep intent, implementation rules, and agent instructions in structured files that can be validated and queried.
The project focuses on spec-driven development, agent discovery, and small runtime surfaces that reduce guesswork when an agent enters a codebase.
What we build
CLI and MCP tooling for writing, validating, and querying structured project specs.
An agent harness that loads graph-backed behavior instead of relying on loose prompt text.
A robotics-oriented harness for simulation-first agent control and capability gating.
Why it exists
AI agents work better when they can find exact names, relationships, states, and constraints without scanning long prose. specdog tools make that structure explicit while still keeping the source material readable.
Where to start
Start with the guide for the workflow, for agents for runtime instructions, or the blog for background writing.
