# Executable Operating Documentation

- id: executable-operating-documentation
- type: skill
- category: developer-tooling
- detail: https://agents.proofandstate.com/products/executable-operating-documentation

## Summary
Derive operator guidance and documentation from canonical warning semantics, a versioned data dictionary and executable examples, with CI rejecting drift.

## Problem
Dashboards and runbooks can disagree about warnings, units, ownership and recovery, making unknown evidence appear healthy or automatic work appear manual.

## Core outcomes
- Canonical warning meanings and safe inspection actions
- Versioned field types, units and unavailable semantics
- Shared UI, CLI and generated documentation
- Executable examples, drift checks and projection budgets

## Requirements
- Actual UI and snapshot producers
- Canonical semantic and schema contracts
- Representative bounded or sanitised examples
- Repository-native generation and validation workflow

## Boundaries
- Documentation grants no mutation authority
- Copying an inspection command is not execution
- Optional disabled features are not automatically broken
- Dashboard caching cannot authorise consequential work

## Tags
- documentation
- semantics
- schema
- dashboard
- examples
- drift

## Canonical source
- repository: AyobamiH/agent-shop-products (main)
- payload path: products/executable-operating-documentation/SKILL.md

## Not published
Price, ratings, reviews, sales figures and full PROMPT.md / SKILL.md payload bodies are not published.