Create design doc

Skill YasuakiOmokawa/skills/plugins/create-design-doc/skills/create-design-doc

Agent skills for improve AI driven development

Install

npx -y skills add YasuakiOmokawa/skills --skill create-design-doc

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

プロトタイプと案件プランファイルの申し送り節から DD (Design Doc) を作成するときに使用。「DD を作って」「デザインドックを起こして」「設計書にして」で起動。テンプレートは ~/.claude/skills-config/create-design-doc/dd_template.md を参照し、未配置なら「テンプレートなしで作成」と宣言して進める。

SKILL.md

2.5 KB, as published. Nobody here has run it

create-design-doc

プロトタイプで確定した設計を DD に起こす。

手順

プランファイルの ## 申し送り (プロトタイプ → DD) と、プロトタイプの実装を読む (実装は PR があれば PR、無ければブランチの diff とコミット履歴。節が無ければその diff から設計判断・根拠・スコープ外を自分で整理してから始める)
~/.claude/skills-config/create-design-doc/dd_template.md を Read し、その見出し構成を骨組みにする (節の追加・削除・改番はしない)。未配置なら「テンプレートなしで作成」と宣言し、背景 / スコープ / 設計 / 設計判断と根拠 / Did not adopt / 未確定事項の 6 節で書く。参考実例 ~/.claude/skills-config/create-design-doc/dd_reference.md があれば構成の参考にする (未配置ならスキップ)
DD を作成し、案件ディレクトリに dd_<案件ディレクトリ名>.md として保存する。設計判断は申し送りの根拠を転記し、採らなかった案は Did not adopt、スコープ外にしたことはスコープ外に残す。材料が無い項目は推測で埋めず、変更が発生しないなら「該当なし」、未決なら「未確定」と理由付きで書く。プロトタイプ側の欠落・矛盾も未確定に挙げる
DD に /dry-ssot-text → /purge-private-vocab (レビュー依頼前に plan 造語を除染)。DD は仕様書なので、節構成・節番号・表・コードブロックは崩さない
保存したらここで停止し、人間の DD レビュー → LGTM を待つ (タスク分解・起票・本実装には進まない)

Gotchas

申し送り節が無くて自分で整理した内容は、プランファイルに書き戻さず DD に書く (再構成が次の読者に一次情報として読まれる)

併用推奨 skill

/map-user-stories, /create-jira-issues — LGTM 後のタスク分解と Jira 起票
/build-poc, /build-prototype — 前工程 (この skill はそれらの申し送り節を入力にする)