Basic Design

spec.md の REQ-# を入力に、機能一覧・モジュール構成・インターフェース・データフローを持つ docs/dev/<対象>/basic-design.md を作成・改訂するスキル。/basic-design <対象名> で明示的に呼び出されたときのみ使用する。

9 starsWriting & Content Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add yasunori0418/skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add yasunori0418/skills --skill basic-design
Manual install
git clone --depth 1 https://github.com/yasunori0418/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/product/basic-design ~/.claude/skills/basic-design

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# basic-design: 基本設計書の作成・改訂

feature-spec と対をなす **基本設計書 1 本** を作る単機能スキル。成果物は
`docs/dev/<対象>/basic-design.md`。仕様が「何を満たすか(`REQ-#`)」を定義するのに対し、
基本設計は **「どう実現するか」** を定義し、各機能を `REQ-#` へ紐づけて
**要求に紐づかない機能 = スコープ外混入** を機械検出可能にする。

## このスキルがやらないこと

- **実装しない**。コードの作成・修正は範囲外。
- **仕様を書かない・改訂しない**。要求の追加・変更が必要になったら `/feature-spec <対象>`
  の改訂モードへ回す(設計側で要求を勝手に足さない。それがスコープドリフトの発生源)。
- **詳細設計に踏み込みすぎない**。クラス単位の内部実装・アルゴリズムの逐次手順は実装工程の
  領分。基本設計は **境界(モジュール・インターフェース・データの流れ)** までを確定させる。
- **テスト成果物を作らない・直さない**。`docs/test/<対象>/` は testing スキル群の担当。

## このスキルが従う原則

### 1. 単体動作(graceful degradation)

- 成果物の既定パスは **`docs/dev/<対象>/basic-design.md`**。
- **プロジェクト側(`CLAUDE.md` / `AGENTS.md` 等)に成果物の配置規約があればそちらを優先する**。
- 主入力: **`docs/dev/<対象>/spec.md`**(`REQ-#` を参照して機能一覧を導出する)。
- 任意入力(あれば整合を取るが、無くても成立する):
  - `docs/test/<対象>/test-analysis.md`(テスト条件 `TC-#`。観測点・境界の洗い出しに使う)
  - `docs/test/<対象>/test-case.md`(テストケース `CASE-#`。設計が想定する入出力と突合する)
  - `docs/dev/definition-of-done.md`(完成の定義)
  - 任意のレビュードキュメント・ユーザーの直接指示
- **`spec.md` が無くても作れる**。ユーザーの直接指示・任意のレビュードキュメントを入力に
  設計書を書いてよい。ただしその場合、機能一覧の「対応要求」列が `-` になり、
  セルフ機械検査が「要求に紐づかない機能」として検出する。
  **先に `/feature-spec <対象>` を実行して仕様を確定させることを推奨する** 旨を利用者へ伝え、
  それでも進めるなら検査 NG が出ることを了解のうえで進める。

### 2. 調査優先 + 決定のみ質問

- **事実はリポジトリ調査で埋める**。既存のモジュール構成・レイヤ分け・命名規約・
  依存の向き・公開契約は、利用者に訊く前に自分で調べる。既存構成に馴染む設計を出す。
- **利用者にしか決められない判断だけ** を `AskUserQuestion`(推奨案を先頭)で確認する。
  本スキルでは **設計方式の選択・既存構成を変えるか否か・分割の粒度・改訂提案の採否** が
  これに当たる。トレードオフのある選択は選択肢と代償を添えて訊く。
Read the full skill on GitHub

Details

Skill name
basic-design
Path
skills/product/basic-design/SKILL.md
License
MIT
Repo updated
18 November 2026

FAQ

What does the Basic Design skill do?

spec.md の REQ-# を入力に、機能一覧・モジュール構成・インターフェース・データフローを持つ docs/dev/<対象>/basic-design.md を作成・改訂するスキル。/basic-design <対象名> で明示的に呼び出されたときのみ使用する。

How do I install the Basic Design skill?

Claude Code plugin: /plugin marketplace add yasunori0418/skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Basic Design popular?

It lives in yasunori0418/skills, which has 9 GitHub stars and 0 forks.

Related skills

Agent Teams

9

yasunori0418/skills

Claude Code の並列エージェント(agent teams・teammate)の後始末と無応答時の打ち切りルール。`name` を付けて Agent を起動するとき、TeamCreate でチームを組むとき、teammate から `idle_notification` が届いたとき、評価ループ等で次のイテレーションのエージェントを起動する前、エージェントの返信が届かないときに参照する。`name` を付けない通常のサブエージェント起動だけなら対象外。

AI, LLMs & Agents

Biz Translate

9

yasunori0418/skills

技術的な内容を、技術用語を排したビジネス職向けの平易な説明文に翻訳する。`/biz-translate` と明示的に呼ばれたときのみ実行する。

Writing & Content

Commit Flow

9

yasunori0418/skills

`git commit` / `git commit --amend` を実行する前、または「commit」「amend」「コミット」「コミットして」の一語・短文だけを渡された時点で必ず発火する git コミット実施ルール。理由や差分の説明が一切無くても、ファイル全文を読んでメッセージを組み立てる前に先に参照する。主目的は論理的に独立した修正を都度・適切な粒度でコミットすること。メッセージは Conventional Commits 形式、素材は同梱の決定論スクリプト commit-context.sh が出す staged diff のみ。「コミット分けて」と依頼される、独立した複数修正をまとめるか分けるか判断する、レビューコメント対応をコミットする、rebase / squash / cherry-pick 後のメッセージを整える、`gh pr create` の PR タイトルをコミット流儀へ揃える場面でも参照する。plan モードでのコミット計画の立案は commit-plan スキルの領分。

Git & Code Review

Wechat Writer

5

TabithaFanny/claude-skills-collection

HelloTalk 公众号内容创作 workflow 支持 5 种任务:做选题 / 写文章 / 润色 / 审核 / 发布检查

Writing & Content

External Writes

9

yasunori0418/skills

Notion・Slack・GitHub Issue/PR・Linear等の外部システムへの書き込み・更新・コメント操作時の運用ルール。MCP書き込み系操作、Notion転記、Slack投稿、Issue/PRコメント、Linearチケット更新等を実行するときに必ず参照する。URLが会話に登場しても自動更新しないという原則を含む。

Writing & Content

Competition Proposal Writing

5

TabithaFanny/claude-skills-collection

比赛计划书写作助手,采用六阶段架构:项目主档→Research补证据→分析稿→成稿→Review修订→统稿可视化。 当用户提到:大创计划、挑战杯、创青春、互联网+、商赛、商业计划书、路演、答辩、融资计划、财务预测、市场分析、竞品分析、配图、格式调整时使用。

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.