Agent-Oriented Documentation System
workflowblueprint
A reusable blueprint that scaffolds agent-oriented documentation for any codebase. Progressive disclosure, executable contracts, declarative manifests, and visual HTML manuals — all generated from a single command.
The problem
Too much context.
None of it relevant.
When you give an agent a whole repository, it drowns. The context window fills with files that have nothing to do with the task — config files, unrelated modules, test fixtures, lock files. The signal gets buried in noise, and the agent starts hallucinating connections that don't exist.
Workflow-blueprint solves this through skill chaining. Instead of loading the entire repo, each workflow contract loads only the context relevant to itself. The agent gets exactly the files, patterns, and rules it needs to execute one task — nothing more. Hallucinations drop. Assertivety goes up.
How it works
The documentation does the work.
You keep working normally.
Once scaffolded, the blueprint lives in your repo as documentation — a skill referenced inAGENTS.md that the agent loads automatically. You don't need to invoke commands or change your workflow.
The agent reads the routing matrix, classifies your task — a bug fix, a feature, a review — and loads only the contract for that task. The rest of the repo stays out of the context window. You keep talking to it the same way you always have.
The bundled workflow generators are starting points, not final workflows. Adapt them to your stack, discard the ones that don't fit.
Generated structure
AGENTS.md
← References orchestrator
skills/<project>/
SKILL.md ← Classifies, loads
template.json ← Declarative manifest
reference/
routing-matrix ← Task → workflow
role-contracts ← Roles, handoffs
workflows/
document/ ← Scoped context
review/ ← Scoped context
plan-to-blueprint/
README.html ← Visual companion
docs/runbooks/
agent-role-system ← Operating manualGet started
Scaffold an agent-oriented
documentation system in minutes.
Point the blueprint at any repository. It generates the full structure: orchestrator skill, workflow contracts, reference docs, and visual HTML manuals. The agent takes it from there.