Skip to content

1.8 Documentation loop — operational and product docs

1. Focus / PL1-documentation-loop

1.8 Documentation loop — operational and product docs

operational and product docs** — runbooks (ops / infra), feature specs, user guides, admin and dev docs exist, are current, and are consumed by agents. Produced with the work that needs them, *and* retrievable as agent context for downstream work


Levels

Level 0

Docs are an afterthought; tribal knowledge for ops

Level 1

Some docs exist; rarely referenced by agents; runbooks present but stale

Level 2

Both operational and product docs are living; agents cite them in task output and PRs; indexed and retrievable as agent context

Level 3

Access patterns logged; gaps and stale entries auto-flagged; docs version alongside features; deprecation cascades automatically; doc retrieval rate tracked


Recipes that advance this criterion

No recipes yet.