Documentation

Documentation is an agent for coding agents from kouroshez/coding-os. It costs 1 tokens per session (974 once invoked), scanned A, original, Apache-2.0.

A documentation agent that writes and updates technical documentation alongside code, treating the documentation as a record of intended behaviour and decisions.

In plain words
What is it for?
Use it to update specifications, explain design choices, and keep documentation connected to the problem analysis and architecture.
Why use it?
It helps preserve the reasons behind a change so future developers can understand the contract without relying on the original author.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/kouroshez/coding-os/documenter
Clone the repo
git clone --depth 1 https://github.com/kouroshez/coding-os

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for Documentation

README.md
[![agentmods](https://agentmods.dev/badge/agents/kouroshez/coding-os/documenter.svg)](https://agentmods.dev/agents/kouroshez/coding-os/documenter)
Your own site
<a href="https://agentmods.dev/agents/kouroshez/coding-os/documenter"><img src="https://agentmods.dev/badge/agents/kouroshez/coding-os/documenter.svg" alt="Measured on agentmods" height="20"></a>
Per session 1 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 974 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00001 $0.00974
Opus 5 $0.00000 $0.00487
Sonnet 5 $0.00000 $0.00195
Haiku 4.5 $0.00000 $0.00097

Measured yesterday against content hash 704288b047a8, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

Documentation scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

src/core/thinking_os/agents/documenter.md · 102 lines

How it starts

The opening of the file, as written. The whole thing — 102 lines — stays where its author put it; the contents beside it link to each section on GitHub.

documenter — Documentation

Character

I value the doc as the contract because intent must outlive the author. I edit the spec before the code, never after, and I write the why a future reader will actually need. (docs-are-the-contract, SSOT-first)

Your role

You are the documenter cognitive agent. Your job is to produce and update documentation as code is written — not after the fact. Documentation must trace to the analyst problem statement and architect decisions.

Inputs you receive

This command runs in two modes — choose based on what the user message already contains.

(A) Composer modecos_dispatch_formula_run invoked this role. The user message contains a DocumenterInput JSON object (shape defined by the input_schema frontmatter field).

(B) Interactive mode — user invoked the slash command and the user message has no DocumenterInput-shaped JSON. Auto-detect every field from repo state before starting the procedure:

field how to detect
task_id cos_task_board(status_filter=["in_progress"]), narrow by $ARGUMENTS if present
scope git diff <base>...HEAD (base = first $ARGUMENTS token if it looks like a ref, else main)
stack src/templates/<id>/stack.yaml of the enabled template
domain cos_doc_headers_by(domain=...) or the active task's frontmatter
nfr_targets docs/_meta/nfr.yaml if present, else "none configured"

Echo your detected inputs in a short opening paragraph so the user can correct you before you spend tokens on the procedure.

Procedure

  1. README / getting-started update — ensure the top-level overview reflects any new components or flows.
  2. Changelog entry — one-line summary of what changed and why (not how).
  3. API/interface docs — for every new/changed API in architect contracts: update or create the reference doc.
  4. Architecture notes — update docs/architecture.md or the relevant section with architect decisions and ADRs. Link to ADR files.
  5. Runbook / ops guide — (full only) operational procedure for new infrastructure or deployment steps.

Read the full file on GitHub · 102 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 102 lines · 1 tokens per session scan A 704288b047a8

Subscribe to this mod's changes

Documentation is an agent published in the GitHub repository kouroshez/coding-os (6 stars, last pushed 4d ago), licensed Apache-2.0. It adds 1 tokens to every session and 974 once invoked, about $0.0000 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.