07

07-design-01-basic-design

Standardizes the creation and formatting of HTML-based basic design documents.

Install

mkdir -p .claude/skills/07-design-01-basic-design && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/15912" && unzip -o skill.zip -d .claude/skills/07-design-01-basic-design && rm skill.zip

Installs to .claude/skills/07-design-01-basic-design

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

基本設計書を作成する。
11 charsno explicit “when” trigger
Beginner

Key capabilities

  • Create basic design documents in HTML
  • Ensure consistent material design
  • Document system architecture
  • Define external interface specifications
  • Create screen mockups

How it works

The skill provides strict rules for folder structure, formatting, and content for creating basic design documents in HTML.

Inputs & outputs

You give it
project requirements and source code
You get back
HTML basic design document

When to use 07-design-01-basic-design

  • Create design document
  • Document system architecture
  • Define interface specifications
  • Create screens mockups

About this skill

フォルダ構成(必須)

  • 基本設計書は 07_Design/01_BasicDesign/html/ 配下にHTML形式で作成してください。
  • これ以外の場所に基本設計書を配置してはいけません。

書式・表示(必須)

  • すべての基本設計書はPCのEdgeブラウザで正しく表示できるHTML形式で作成してください。
  • トップページのファイル名は必ず 07_Design/01_BasicDesign/html/index.html としてください。
  • 全ページでマテリアルデザインの配色・文字サイズを統一し、視認性・可読性を重視してください。
  • UML・図の作成は、uml スキルで作成して、HTMLのIMGタグで表示してください。

参照できる情報(必須)

  • 詳細設計書は、以下の情報を必ず反映してください。
    • 08_Project 配下のソースコード
    • 07_Design/02_DetailDesign/html/ 配下の詳細設計書
  • これ以外の情報のみを根拠に設計書を作成してはいけません。

トップページ(index.html)の構成(必須)

  • ページタイトルは「システム名 基本設計書」としてください。
  • 上部にシステム名・ロゴ・作成日付を必ず配置してください。
  • 記載項目は以下の通りです。
    • 機能一覧
    • 画面遷移図
    • 画面モックアップ
    • 全体ER図
    • 全体クラス図
    • 全体シーケンス図
    • 外部インターフェース
    • 環境・前提条件
    • 終了コード:終了コードと意味の一覧(正常・設定エラー・入力不正・ロック失敗・I/O・想定外等)。
    • ログ方針:出力先、フォーマット(日時/ロケール/タイムゾーン)、レベル、ローテーション、機微情報の扱い。
    • 運用・監視
    • 未決定事項

各項目の記載ルール(必須)

機能一覧

以下を記載してください。

  • 機能名
  • 必要な外部API
  • 機能概要
  • 開発工数 難易度を考慮して、大・中・小で示すこと。

画面モックアップ

  • 画面モックはHTMLモックで作成して、07_Design/01_BasicDesign/html/screens/ 配下に配置してください。
  • index.htmlから各画面モックへのリンクを設定してください。
  • \

外部インターフェース

以下を記載してください。

  • インタフェース名
  • 受信か送信か
  • 送受信先のシステム名
  • 送受信先のインタフェース名
  • 送受信先するプロトコル
  • 送受信先するデータタイプ・定義
  • 送受信する頻度
  • タイムアウト・リトライ
  • エラーコード仕様

環境・前提条件

以下を記載してください。

  • 言語バージョン
  • ビルドツール
  • 対応OS
  • 対応ブラウザ
  • 制限事項
  • \

運用・監視

以下を記載してください。

  • 監視ログ対象
  • 監視方法
  • 監視内容
  • 運用バッチのリトライ・復旧方法
  • \

未決定事項

  • 未決定事項
  • 決定期日
  • 担当者
  • 決定までのタスク

禁止事項

  • ルールに記載されていない独自の判断で内容を追加・削除・省略してはいけません。
  • 配置場所・ファイル名・記載内容を勝手に変更してはいけません。
  • 詳細設計書の内容(クラス/メソッド仕様、入出力フォーマット、例外一覧、テスト観点等)を重複記載してはいけません(概要レベルの要約・参照は可)。
  • 公開版の基本設計書に「(暫定)」等の暫定表記を残したままにしてはいけません。

推奨事項

  • ページ内の説明や表現は、誰が読んでも誤解しないよう具体的かつ簡潔に記載してください。
  • 横断設計項目は詳細設計書と用語を揃え、相互リンクを設定してください(例: 詳細設計の各ページから本書の該当セクションへリンク)。

When not to use it

  • When creating detailed design documents
  • When placing basic design documents outside the specified folder structure

Limitations

  • Basic design documents must be in HTML format
  • Basic design documents must be located in `07_Design/01_BasicDesign/html/`
  • Cannot include detailed design content

How it compares

This skill enforces a standardized structure and content for basic design documents, unlike creating them with arbitrary formats.

Compared to similar skills

07-design-01-basic-design side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
07-design-01-basic-design (this skill)03moNo flagsBeginner
project-planner3210moReviewIntermediate
spec-kit-workflow118moNo flagsIntermediate
specification-architect139moReviewAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

project-planner

adrianpuiu

Comprehensive project planning and documentation generator for software projects. Creates structured requirements documents, system design documents, and task breakdown plans with implementation tracking. Use when starting a new project, defining specifications, creating technical designs, or breaking down complex systems into implementable tasks. Supports user story format, acceptance criteria, component design, API specifications, and hierarchical task decomposition with requirement traceability.

32115

spec-kit-workflow

jmanhype

Guides specification-driven development workflow. Automatically invoked when discussing new features, specifications, technical planning, or implementation tasks. Ensures proper workflow phases (specify → clarify → plan → checklist → tasks → analyze → implement).

11111

specification-architect

adrianpuiu

A rigorous, traceability-first system that generates five interconnected architectural documents (blueprint.md, requirements.md, design.md, tasks.md, and validation.md) with complete requirements-to-implementation traceability. Use this skill when users need to architect systems, create technical specifications, or develop structured project documentation with guaranteed traceability.

1388

architecture

davila7

Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design.

1244

context-driven-development

wshobson

Use this skill when working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md, and workflow.md files.

744

planning-agent

parcadei

Planning agent that creates implementation plans and handoffs from conversation context

531

Search skills

Search the agent skills registry