docs

A docs tree where every page has an owner and review dates, runbooks, a sweep for stale pages, and a static docs build.

• Version 0.1.0
• 3 skills
• 1 gate check
• Running on this site: Docs health

What it does

Documentation as code for one repository. Pages are Markdown files in docs/<space>/, each with an owner, a review date, a next review date and a type. A build script turns them into a static site with a page tree, backlinks, decision record and RFC indexes, a search index and a health page that lists the pages past review. A gate check reports missing or malformed review fields on every run.

Install

Add the marketplace at release v0.1.0 once, then install the plugin and restart Claude Code.

claude plugin marketplace add uncovertechtalent/cto-powersuit#v0.1.0
claude plugin install docs@cto-powersuit

Skills

• /docs:docs-init

  Set up a docs tree in the current repository: ask for the spaces, copy the config, a home page per space, the page templates and the build script, fill the front matter (owner, review dates, type) and run the first build.

• /docs:review-sweep

  Find stale docs pages (review date passed, due within 30 days, reviewed: no, no owner or no type), group them by owner, check each page against the system it describes, and update reviewed and review_by only after that check.

• /docs:runbook

  Write a runbook page for one symptom or procedure, from an incident, a chat or the user's notes: Symptom, Checks, Steps, Verify, Roll back or escalate, with owner and review dates, linked from the runbooks index.

Gate checks

The checks this plugin adds to the deploy gate of the gate module, each with a pass fixture and a fail fixture:

• docs.review

Source

The CTO powersuit is a set of agent skills, one module per CTO function from the deploy gate to the hand-over, that one person uses to run a company's whole engineering platform. docs is one of its 18 plugins, published by Stefan Coetzee.

The skills, templates, checks, fixtures, and the full README of docs at release v0.1.0: github.com/uncovertechtalent/cto-powersuit/tree/v0.1.0/plugins/docs. License: MIT. Every plugin of the powersuit: CTO powersuit.