アーキテクチャ設計書を作成するための詳細ガイドとテンプレート。アーキテクチャ設計時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

MITAuto-check passedProduct & Project Management

Install Architecture Design

skills CLI
$ npx skills add GenerativeAgents/claude-code-book-chapter8 --skill architecture-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install GenerativeAgents/claude-code-book-chapter8 architecture-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/GenerativeAgents/claude-code-book-chapter8.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/architecture-design .claude/skills/architecture-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
architecture-design
GitHub stars
120
Token cost
~217 tokens
SKILL.md length
41 words
Files
3
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

アーキテクチャ設計書を作成するための詳細ガイドとテンプレート。アーキテクチャ設計時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

  • Works in 2 steps: docs/product-requirements.md (PRD) → docs/functional-design.md (機能設計書)
  • Product & Project Management work in your project
  • SKILL.md covers 前提条件, 既存ドキュメントの優先順位, 出力先 and テンプレートの参照
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Architecture Design is an agent skill from GenerativeAgents/claude-code-book-chapter8. アーキテクチャ設計書を作成するための詳細ガイドとテンプレート。アーキテクチャ設計時にのみ使用。

Its SKILL.md is about 220 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `guide.md` and `template.md`).

It sits in Product & Project Management. The licence is MIT.

When your agent uses it

  • Product & Project Management work in your project

Example prompts

  • “/architecture-design”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. docs/product-requirements.md (PRD)
  2. docs/functional-design.md (機能設計書)

What it can do on your machine

Read from SKILL.md and the folder at commit 27c4191. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Architecture Design loads about 217 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 41 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~217

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from GenerativeAgents/claude-code-book-chapter8 at commit 27c4191, republished under its MIT licence (© GenerativeAgents). 41 words, ~217 tokens.

Download SKILL.mdSave it as .claude/skills/architecture-design/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
architecture-design
description
アーキテクチャ設計書を作成するための詳細ガイドとテンプレート。アーキテクチャ設計時にのみ使用。
allowed-tools
Read, Write

アーキテクチャ設計スキル

このスキルは、高品質なアーキテクチャ設計書を作成するための詳細ガイドです。

前提条件

アーキテクチャ設計を開始する前に、以下を確認してください:

必須ドキュメント
  1. docs/product-requirements.md (PRD)
  2. docs/functional-design.md (機能設計書)

アーキテクチャ設計は、PRDの要件と機能設計を技術的に実現するための システム構造とテクノロジースタックを定義します。

既存ドキュメントの優先順位

重要: docs/architecture.md に既存のアーキテクチャ設計書がある場合、 以下の優先順位に従ってください:

  1. 既存のアーキテクチャ設計書 (docs/architecture.md) - 最優先

    • プロジェクト固有の技術選定と設計が記載されている
    • このスキルのガイドより優先する
  2. このスキルのガイド - 参考資料

    • 汎用的なテンプレートと例
    • 既存設計書がない場合、または補足として使用

新規作成時: このスキルのテンプレートとガイドを参照 更新時: 既存設計書の構造と内容を維持しながら更新

出力先

作成したアーキテクチャ設計書は以下に保存してください:

docs/architecture.md

テンプレートの参照

アーキテクチャ設計書を作成する際は、次のガイドを参照しながら、テンプレートを使用してください:

  • ガイド: ./guide.md
  • テンプレート: ./template.md

© GenerativeAgents, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in .claude/skills/architecture-design of GenerativeAgents/claude-code-book-chapter8.

  • SKILL.md
  • guide.md
  • template.md

Open the folder on GitHubat commit 27c4191

Compare with similar skills

Architecture Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Architecture Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architecture Design this skillGenerativeAgents/claude-code-book-chapter8120—~217Automated safety check: PassMIT
User Story Writerdeanpeters/Product-Manager-Skills7.2k2 repos~2.9kAutomated safety check: PassCustom licence
Game Changing FeaturesopenstatusHQ/data-table-filters2.3k3 repos~2.1kAutomated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Convex Create Componentspokvulcan/poker-planning1148 repos~2.6kAutomated safety check: PassMIT
Self Improving Agentfarm-fe/farm5.6k2 repos~3.3kAutomated safety check: NotesMIT

Similar skills

  • User Story Writer

    deanpeters/Product-Manager-Skills

    Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.

    7.2k GitHub starsUsed in 2 repos~2.9k tokens
    Product & Project ManagementAuto-check passed
  • Game Changing Features

    openstatusHQ/data-table-filters

    Find 10x product opportunities and high-leverage improvements.

    2.3k GitHub starsUsed in 3 repos~2.1k tokens
    Product & Project ManagementAuto-check passed
  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Convex Create Component

    spokvulcan/poker-planning

    Builds reusable Convex components with isolated tables and app-facing APIs.

    114 GitHub starsUsed in 8 repos~2.6k tokens
    Product & Project ManagementAuto-check passed
  • A universal self-improving agent that learns from ALL skill experiences.

    5.6k GitHub starsUsed in 2 repos~3.3k tokens
    Product & Project ManagementAuto-check: notes
  • Builds a weekly engineering retrospective from git history: commit counts, per-person contributions, work patterns and code quality numbers over a chosen window.

    136k GitHub stars~2.4k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from GenerativeAgents/claude-code-book-chapter8

  • Development Guidelines

    GenerativeAgents/claude-code-book-chapter8

    チーム全体で統一された開発プロセスとコーディング規約を確立するための包括的なガイドとテンプレート。開発ガイドライン作成時、コード実装時に使用する。

    120 GitHub stars~521 tokensUpdated 7 mo ago
    Auto-check passed
  • Prd Writing

    GenerativeAgents/claude-code-book-chapter8

    プロダクト要求定義書(PRD)を作成するための詳細ガイドとテンプレート。PRD作成時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

    120 GitHub stars~1.3k tokensUpdated 7 mo ago
    Auto-check passed
  • Steering

    GenerativeAgents/claude-code-book-chapter8

    作業指示毎の作業計画、タスクリストをドキュメントに記録するためのスキル。ユーザーからの指示をトリガーとした作業計画時、実装時、検証時に読み込む。

    120 GitHub stars~1.7k tokensUpdated 7 mo ago
    Auto-check passed
  • Functional Design

    GenerativeAgents/claude-code-book-chapter8

    機能設計書を作成するための詳細ガイドとテンプレート。機能設計書作成時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

    120 GitHub stars~214 tokensUpdated 7 mo ago
    Auto-check passed
  • Repository Structure

    GenerativeAgents/claude-code-book-chapter8

    リポジトリ構造定義書を作成するための詳細ガイドとテンプレート。リポジトリ構造定義時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

    120 GitHub stars~237 tokensUpdated 7 mo ago
    Auto-check passed
  • Glossary Creation

    GenerativeAgents/claude-code-book-chapter8

    用語集を作成するための詳細ガイドとテンプレート。用語集作成時にのみ使用。

    120 GitHub stars~241 tokensUpdated 7 mo ago
    Auto-check passed

Questions about Architecture Design

What does Architecture Design do?

アーキテクチャ設計書を作成するための詳細ガイドとテンプレート。アーキテクチャ設計時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8. Architecture Design is an agent skill from GenerativeAgents/claude-code-book-chapter8.

When should I use Architecture Design?

Architecture Design fits situations like: product & Project Management work in your project.

How do I install Architecture Design in Claude Code?

Run `npx skills add GenerativeAgents/claude-code-book-chapter8 --skill architecture-design -a claude-code`. Or copy the skill folder (.claude/skills/architecture-design in GenerativeAgents/claude-code-book-chapter8) into .claude/skills/architecture-design in your project. Claude Code loads it when a task matches its description.

How do I install Architecture Design in Codex?

Run `npx skills add GenerativeAgents/claude-code-book-chapter8 --skill architecture-design -a codex`. Or copy the skill folder (.claude/skills/architecture-design in GenerativeAgents/claude-code-book-chapter8) into .agents/skills/architecture-design in your project. Codex loads it when a task matches its description.

Can I use Architecture Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add GenerativeAgents/claude-code-book-chapter8 --skill architecture-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architecture-design, .gemini/skills/architecture-design, .github/skills/architecture-design and .opencode/skills/architecture-design in your project.

What does Architecture Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Architecture Design is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write.

Does Architecture Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Architecture Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Architecture Design use?

Architecture Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Architecture Design use?

About 217 tokens (SKILL.md is roughly 868 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Architecture Design?

Skills that share tags, products or a category with Architecture Design: User Story Writer (deanpeters/Product-Manager-Skills, 7.2k stars), Game Changing Features (openstatusHQ/data-table-filters, 2.3k stars), CCPM Project Management (automazeio/ccpm, 8.4k stars) and Convex Create Component (spokvulcan/poker-planning, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architecture Design?

GenerativeAgents (a GitHub organization) maintains it in GenerativeAgents/claude-code-book-chapter8, which has 120 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on February 28, 2026.

Source: GenerativeAgents/claude-code-book-chapter8 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.