pentaglyph-docs

Tutor skill that translates this codebase for newcomers. Given a file path, function name, concept, error message, or architecture term, it discovers existing docs first (re-using rather than re-generating), produces a Diátaxis-style Explanation in narrative voice with a Mermaid diagram and links to ADRs / arc42 §08 / official upstream docs. Audience-aware (dev vs end-user). Asks once at the end whether to persist the explanation under the appropriate `docs/` location; treats silence as "yes, save".

pentaglyph kit のプロジェクトツアー (kit 版)。tour-guide エージェントを起動して、 pentaglyph の全機能 (5 標準 binding / ADR-0010 layer-prefix / 14 templates / CLI / user manual / dogfooding) を Quick narrative / Guided by role / Menu / Ask の 4 mode で外観させる。pentaglyph 採用検討者・downstream user・upstream contributor・docs 担当・AI agent 向け。Quick overview は箇条書きではなく narrative (2000-3000 字、 背景 → 制約 → 決定 → 含意) で出す。深掘りは他 skill (`/explain`, `/doc-init` 等) や user manual に委譲する入口専用スキル。**この SKILL.md は pentaglyph kit が ship する template 版**で、downstream consumer はこの定義に自プロジェクト固有の説明を 足して拡張できる (AI-clone リファレンス実装が `--scope=α/β/γ` で例示している)。

編集前提の AWS アーキ図を draw.io MCP で生成する。公式 AWS4 アイコン使用 + 平仄の取れたラベル / 余白 / 色で 1 枚の整った .drawio ファイルに仕上げ、docs/diagrams/aws-infra/ 配下に保存する。

Render every committed diagram source under `docs/` (Structurizr DSL, PlantUML, Mermaid) to SVG and embed the renders in viewer markdown files so the diagrams are visible from any repo browser (GitHub, CodeCommit, Bitbucket) without client-side rendering. Idempotent — safe to re-run after every diagram source change. Replaces the historical "exports/ is gitignored" policy.

Fill one specific documentation gap directly, bypassing the orchestrator. Takes an `<area>` argument (e.g. `prd:auth`, `adr:adopt-postgres`, `module:billing-service`, `runtime:checkout-flow`, `slos`, `glossary`) and dispatches the appropriate specialist agent. Useful when you know exactly what you want next. Does not run the auditor first.

Start (or resume) the conversational documentation build. Invokes the doc-orchestrator agent which audits the current docs/ state, identifies the current phase + next gap, and begins / resumes the discovery interview. Idem- potent — safe to call repeatedly. Use when a project has just been scaffolded with `pentaglyph init` or when picking up after a long pause.

Read-only documentation coverage report. Invokes the completeness-auditor agent to inventory docs/ against the four-phase rubric and prints the current phase + coverage % + the single highest-priority next gap. Does not start a conversation. Use after manual edits, before commits, or as a quick health check.