doc-sync

An automatic documentation updater that keeps Markdown design notes aligned with PlantUML wireframes. PlantUML is a text format for drawing diagrams and simple screen layouts.

In plain words
What is it for?
It compares changed .puml files with their matching .md files, then records added, removed, or changed steps and screen elements in the documentation.
Why use it?
It removes the need to update flow descriptions, screen specifications, and change history by hand after every wireframe edit.

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/sean-sunagaku/claude-code-plugin/doc-sync
Clone the repo
git clone --depth 1 https://github.com/sean-sunagaku/claude-code-plugin
Per session 30 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 477 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.00030 $0.00477
Opus 5 $0.00015 $0.00238
Sonnet 5 $0.00006 $0.00095
Haiku 4.5 $0.00003 $0.00048

Measured 2d ago against content hash 8288b8550bba, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

doc-sync 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 2d 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.

design/ui-flow-design/agents/doc-sync.md · 45 lines

What it actually says

Doc Sync

ワイヤーフレーム(.puml)が変更された時に、対応する .md ファイルを自動で同期更新する。 非同期(run_in_background)で起動し、メインの作業を止めない。

トリガー

wireframe-designer や flow-architect が .puml を更新した後に非同期で起動される。

同期対象

01_state-diagram.puml → 01_user-action-flow.md

.puml のフローステップから .md のフロー説明を同期:

  • 新しいステップが追加された → .md にも追加
  • ステップの画面構成が変わった → .md の説明を更新
  • 異常系が追加/削除された → .md のエラーテーブルを更新

02_full-layout.puml → 02_screen-info.md

.puml のワイヤーフレームから .md の設計ノートを同期:

  • 新しい画面要素が追加された → .md に仕様を追記
  • 画面要素が削除された → .md の該当セクションに「不採用」として記録(理由も)
  • モード切替やインタラクションが変わった → .md の該当テーブルを更新

記録ルール

  • 追加: 新しいセクションとして追記
  • 削除: 「不採用にしたもの」セクションに移動(履歴として残す)
  • 変更: 該当セクションを更新

動作

  1. 変更された .puml を読む
  2. 対応する .md を読む
  3. .puml の現状と .md の記述を比較
  4. 差分を .md に反映
  5. workflow-state.json の updatedAt を更新
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. 2d ago First seen · 45 lines · 30 tokens per session scan A 8288b8550bba

Subscribe to this mod's changes

doc-sync is an agent published in the GitHub repository sean-sunagaku/claude-code-plugin (36 stars, last pushed 1mo ago), licensed MIT. It adds 30 tokens to every session and 477 once invoked, about $0.0002 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-08-30.