A setup tool for creating a single source of truth (SSOT): shared architecture documentation that describes how a codebase is organised. It can create an architecture overview, an ADR folder for recording important technical decisions, and CODEMAPS for finding code.

Use it to document a web app, API, command-line tool, or library, including its technology stack, layers, entry points, external services, and files that should not be edited manually.

It gives developers a consistent place to understand the system and the reasons behind major decisions. This reduces time spent guessing where code belongs or why it works a certain way.

setup-ssot — Skill for Claude Code by ShipWithAI/shipwithai-plugins

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.

Any agent

npx skills add ShipWithAI/shipwithai-plugins --skill setup-ssot

Clone the repo

git clone --depth 1 https://github.com/ShipWithAI/shipwithai-plugins

Made for: Claude Code.

Or install shipwithai-starter, the plugin that ships this one along with the rest of its 13 skills, 4 commands, 1 agent.

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.

README.md

[![agentmods](https://agentmods.dev/badge/skills/shipwithai/shipwithai-plugins/setup-ssot/github.svg)](https://agentmods.dev/skills/shipwithai/shipwithai-plugins/setup-ssot)

Your own site

<a href="https://agentmods.dev/skills/shipwithai/shipwithai-plugins/setup-ssot"><img src="https://agentmods.dev/badge/skills/shipwithai/shipwithai-plugins/setup-ssot/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/shipwithai/shipwithai-plugins/setup-ssot"><img src="https://agentmods.dev/badge/skills/shipwithai/shipwithai-plugins/setup-ssot.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 62 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,423 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

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.

Model	Per session	Once invoked
Fable 5.1	$0.00062	$0.01423
Opus 5.5	$0.00025	$0.00569
Sonnet 5.5	$0.00012	$0.00285
Haiku 4.5	$0.00006	$0.00142

Measured 2mo ago against content hash 59bfdbf0e0bd, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

setup-ssot 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 2mo ago.

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.

plugins/starter/skills/setup-ssot/SKILL.md · 204 lines

How it starts

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

/setup-ssot

Configures SSOT documentation: docs/architecture.md, docs/adr/, docs/CODEMAPS/.

Mode Detection

Read .claude/starter-context.json if it exists:

Exists: use architecture, ssot.adr, ssot.codemaps fields — skip questions
Missing (standalone): ask which outputs to create, then gather architecture details

Flags

--architecture-only — write docs/architecture.md only, skip ADR and CODEMAPS
--adr — include ADR structure
--codemaps — include CODEMAPS structure
Flags can be combined: --adr --codemaps

Standalone Questions (when no context file)

Ask once, grouped:

Which outputs to create?

docs/architecture.md — architecture overview
docs/adr/ — ADR structure with ADR-0001
docs/CODEMAPS/ — codebase navigation guide

For each selected output, gather:

Project name and type (web app / API / CLI / lib)?
Primary stack (language + framework)?
Architecture style (monolith / microservices / modular monolith / event-driven)?
Key layers and their directories?
Entry points?
External dependencies (DB, queue, cache, external APIs)?
Directories/files that must NOT be edited manually?
Sensitive areas requiring extra care?

Output 1: `docs/architecture.md`

Draft from starter-context.json.architecture (or standalone answers). Use actual paths, not generic placeholders:

# Architecture Overview

*Generated by /shipwithai-starter on [DATE]. Edit directly.*

## System overview

[Project name] is a [type] built with [stack].
Architecture style: [monolith / microservices / modular monolith / event-driven].

## Key layers

| Layer | Directory | Responsibility |
|-------|-----------|----------------|
| [API] | [src/routes/] | [HTTP handlers, validation] |
| [Service] | [src/services/] | [Business logic] |
| [Data] | [src/db/] | [Database access, ORM] |

## Entry points

- `[src/index.ts]` → [main server, port 3000]
- `[src/worker.ts]` → [background job processor]

## External dependencies

| Service | Purpose | Connection |
|---------|---------|------------|
| [PostgreSQL] | [Primary database] | [DATABASE_URL] |
| [Redis] | [Session cache] | [REDIS_URL] |

## Key directories

[paste tree output or scan result]

## What to know before touching code

[Gotchas: generated dirs, build order, sensitive areas]

Read the full file on GitHub · 204 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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.

2mo ago First seen · 204 lines · 62 tokens per session scan A 59bfdbf0e0bd

Subscribe to this mod's changes

setup-ssot is a skill published in the GitHub repository ShipWithAI/shipwithai-plugins (9 stars, last pushed 2mo ago), licensed MIT. It adds 62 tokens to every session and 1,423 once invoked, about $0.0002 per session on Opus 5.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-08-31.

Claude Code Writing and docs ai-coding claude-code-plugin developer-tools shipwithai

setup-ssot next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
setup-ssotShipWithAI/shipwithai-plugins	Skill	9	2mo ago	MIT	A	62	Claude Code
connectgreenpolo/cc-multi-cli-plugin	Skill	196	10d ago	Apache-2.0	A	11	Claude Code
review-depthjszmajda/lid	Skill	118	today	MIT	A	93	Claude Code
hook-templateclaude-world/director-mode-lite	Skill	80	20d ago	MIT	A	39	Claude Code
check-environmentclaude-world/director-mode-lite	Skill	80	20d ago	MIT	A	44	Claude Code
agentsclaude-world/director-mode-lite	Skill	80	20d ago	MIT	A	29	Claude Code
handoff-geminiclaude-world/director-mode-lite	Skill	80	20d ago	MIT	A	71	Claude Code