audit

Orchestrates a periodic audit measuring corpus claims against the codebase and public surface.

1|Updated Jul 21, 2026
One-click install
npx skills add https://github.com/fallguyconsulting/ok-plugins --skill audit-fallguyconsulting
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit
Source: https://github.com/fallguyconsulting/ok-plugins/tree/main/plugins/ok/ceremonies/audit
Command: npx skills add https://github.com/fallguyconsulting/ok-plugins --skill audit-fallguyconsulting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Over time, a project's design corpus — stories, decisions, concepts, and surface intents — drifts out of sync with the actual codebase, and no one notices until the gap causes real damage. This Skill runs a periodic, evidence-based audit that re-verifies every claim against the current code and released product, so stale documentation is caught and ruled on rather than silently trusted. ## Core Features & Use Cases - Surface intent and extraction: Co-authors the public-surface intent with the owner in a short interactive stage, then dispatches an autonomous extractor subagent that walks the code and deployment configuration to write the run's surface extraction. - Two-track determination: Measures stories and cold-synthesized user assumptions by driving the released product through public surface elements, while reading decisions adversarially and concepts as vocabulary against the code — all as parallel tasks in a shared task run. - Terminal judge and committed record: Routes every escalation to a single judge, files confirmed gaps as intake issues, writes a run report to the archive, and commits and stamps the audit corpora so currency is a git question. - Use Case: A project owner runs /audit quarterly; the run re-verifies all stories through the product's public surface, finds two decisions contradicted by recent refactors, files them as intake issues, and commits a stamped audit corpus the /document ceremony can build on. ## Quick Start Invoke the /audit slash command in a project with the .ok-planner estate present to start the interactive intent stage and run the full audit.

Frequently Asked Questions about audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a periodic audit of my project's design documentation?▼

Invoke the /audit slash command in a project with the .ok-planner estate present. The run opens with a short interactive intent stage, then autonomously measures stories, reads decisions and concepts, and ends with a judge ruling and a committed, stamped audit corpus.

How does the audit verify user stories against the product?▼

Stories are verified by measurement, not reading: the run drives the released product through the public surface elements recorded in the surface extraction, on the maintained experiments, per each estate's protocol. Assumptions are synthesized cold and measured on the same instrument.

What happens when the audit finds a claim the code does not support?▼

Every determination no instrument could call supported goes into an escalations pool consumed by one terminal judge. The judge rules on each escalation and files confirmed gaps as intake issues; the orchestrator itself never files anything.

Does the audit skill require the ok-planner estate?▼

Yes, the .ok-planner estate is required. It provides the audit definitions, auditor and judge prompts, the task tracker at .ok-planner/bin/tasks, and the agent profiles; without them the run stops because it cannot record verdicts or dispatch auditors.

Can the audit fix the gaps it finds automatically?▼

No, the audit never fixes anything and has no fix loop. Real gaps become intake issues for the owner and a future sprint, form defects are recorded in the audit file, and the run ends after committing and stamping its output.

How is audit staleness determined after a run completes?▼

Staleness is a git question, not tracked state: an audit is current when the diff from its stamped commit touches only the run's own output paths. Any other change to the tree means the audit no longer holds for that tree.