Documentation
Plugin
document-templates-for-aws
Fetches AWS knowledge and loads design sheets to check NFR obsolescence and run Well-Architected reviews. Fires during requirement gathering and architecture review.
Plugin Signal38/100Fair
maintained29
capable34
documented50
adopted54
Install
$ npx -y skills add YoshiiRyo1/document-templates-for-aws --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
In this plugin
See everything inside What's inside
Skills
2/nfr-outdated-checkThis skill should be used when the user asks to "check outdated", "outdated check", "陳腐化チェック", "最新化チェック", or "NFR update check" for the non-functional requirement hearing sheets./wa-reviewThis skill should be used when the user asks to "review architecture", "Well-Architected review", "check bestpractices", "security assessment",or "cost optimization analysis".
README
1AWS 上にシステムを設計・構築していくうえで役に立つドキュメントテンプレートを公開しています。
ディレクトリ構成
.
├── design/doc_source/ … クラウド設計シート（インフラ基本設計書テンプレート）
├── survey/doc_source/ … ヒアリングシート（非機能要件チェックリスト）
├── workshop/doc_source/ … ワークショップ資料（AWS ベストプラクティスの解説）
├── steering/ … 過去の対応計画・参考資料
├── .claude/ … Claude Code の設定（スキル・リファレンス）
├── CLAUDE.md … Claude Code プロジェクト指示書
├── .mcp.json … MCP サーバー設定
└── history.md … 変更履歴
各ディレクトリの README.md にファイル一覧と詳細な説明があります。
ドキュメント本体は doc_source/ 配下に格納されており、pandoc で MS Word へ変換して利用できます。
design/ — クラウド設計シート
AWS 上でのシステム構築におけるインフラ基本設計書のテンプレートです。 AWS Well-Architected フレームワークの考え方に準拠して記載しています。
| ファイル名 | 内容 |
|---|---|
| cloud-design-common.md | アーキテクチャ共通の項目 |
| cloud-design-availability.md | システムの可用性設計 |
| cloud-design-network.md | VPC・サブネット・ルーティングなどのネットワーク設計 |
| cloud-design-security.md | IAM・暗号化・脅威検知などのセキュリティ設計 |
| cloud-design-monitoring.md | CloudWatch を中心とした監視設計 |
| cloud-design-log.md | ログ収集・保管・分析の設計 |
| cloud-design-backup.md | バックアップ・リストアの設計 |
| cloud-design-naming.md | リソース命名規則・タグ命名規則 |
| cloud-design-awsaccount.md | AWS アカウント構成 |
| cloud-design-configurationmanagement.md | 構成管理（AMI・IaC） |
| cloud-design-deployprovisioning.md | デプロイ・プロビジョニング |
| cloud-design-patchmanagement.md | EC2・マネージドサービスのパッチ管理 |
survey/ — ヒアリングシート
要件定義・設計フェーズでお客様から非機能要件を聞き取るためのチェックリストです。 IPA 非機能要求グレードと AWS Well-Architected フレームワークを統合した 7 カテゴリ + 2 区分で構成しています。 各ファイルは「質問 | 質問の意図 | ご回答」の 3 列テーブル形式です。
| ファイル名 | カテゴリ |
|---|---|
| nfr-reliability.md | 信頼性（稼働率、バックアップ、災害対策） |
| nfr-performance-efficiency.md | パフォーマンス効率（性能目標、拡張性、キャッシュ） |
| nfr-operational-excellence.md | 運用上の優秀性（運用体制、ジョブ、ログ、監視、デプロイ） |
| nfr-migration.md | マイグレーション |
| nfr-security.md | セキュリティ（コンプライアンス、データ保護、ID 管理、攻撃防御） |
| nfr-sustainability.md | サステナビリティ |
| nfr-cost-optimization.md | コスト最適化 |
| nfr-infrastructure.md | インフラ基盤共通（AWS アカウント、ネットワーク、ドメイン） |
| nfr-generative-ai.md | 生成 AI（ガバナンス、セキュリティ、運用、コスト） |
workshop/ — ワークショップ資料
インフラ設計に入る前に、発注元企業と構築ベンダー間で AWS の前提知識を合わせるための資料です。
| ファイル名 | 内容 |
|---|---|
| workshop_multiaccount.md | マルチアカウント戦略 |
| workshop_network.md | VPC の基礎知識 |
| workshop_s3.md | Amazon S3 の基礎知識 |
steering/ — 過去の対応計画・参考資料
ドキュメントの更新方針や意思決定の経緯を記録しています。
| ファイル名 | 内容 |
|---|---|
| nfr-outdated-check-20260223.md | 非機能要件の陳腐化チェック結果（2020 年 7 月〜2026 年 2 月） |
| nfr-update-plan-20260223.md | 非機能要件の更新計画（2026 年 2 月版） |
| skills-plan.md | Claude Code スキルの導入計画 |
Claude Code によるドキュメント管理
本リポジトリでは Claude Code を活用してドキュメントの作成・更新・レビューを行っています。 Claude Code は Anthropic が提供する CLI ツールで、AI がリポジトリの文脈を理解しながらドキュメント作業を支援します。
前提条件
- Claude Code がインストールされていること
- Python パッケージマネージャー
uvxがインストールされていること（MCP サーバーの実行に必要）
設定ファイル
| ファイル | 説明 |
|---|---|
CLAUDE.md | プロジェクト指示書。ディレクトリ構成、記述規約、ペルソナ、非機能要件の定義体系など、Claude Code がドキュメント作業を行う際のルールを記載しています。 |
.mcp.json | MCP（Model Context Protocol）サーバーの設定。AWS の最新ドキュメントや仕様を参照するための外部ツール接続を定義しています。 |
.claude/settings.json | Claude Code の権限設定。許可するツールや拒否するコマンドを定義しています。 |
MCP サーバー
.mcp.json で以下の MCP サーバーが設定されています。
| サーバー名 | 用途 |
|---|---|
aws-knowledge | AWS ドキュメントの検索、リージョン別サービス提供状況の確認、ベストプラクティスの参照に使用します。 |
document-loader | 外部ドキュメントの読み込みに使用します。 |
スキル（カスタムコマンド）
.claude/skills/ 配下にプロジェクト固有のスキルが定義されています。
Claude Code のチャットで /スキル名 と入力することで実行できます。
| スキル名 | 説明 | 実行方法 |
|---|---|---|
wa-review | AWS Well-Architected フレームワークの 6 本の柱に基づき、設計書やヒアリングシートをレビューして改善提案レポートを生成します。 | /wa-review |
nfr-outdated-check | 非機能要件ヒアリングシート（survey/doc_source/nfr-*.md）に記載された AWS サービスの仕様を最新情報と照合し、陳腐化した記述を特定します。 | /nfr-outdated-check |
リファレンス
.claude/references/ 配下に Claude Code が参照する定義資料が格納されています。
| ファイル | 説明 |
|---|---|
nfr-taxonomy.md | 非機能要件の定義体系。IPA 非機能要求グレードと AWS Well-Architected フレームワークを統合した 7 カテゴリの分類定義です。 |
File tree
52YoshiiRyo1/document-templates-for-awsView on GitHub
.claude/
references/
nfr-taxonomy.md
settings.json
skills/
nfr-outdated-check/
references/
output-template.md
SKILL.md
wa-review/
references/
output-template.md
pillar-cost-optimization.md
pillar-operational-excellence.md
pillar-performance-efficiency.md
pillar-reliability.md
pillar-security.md
pillar-sustainability.md
SKILL.md
.gitignore
.mcp.json
CLAUDE.md
design/
doc_source/
aws_services_that_enhance_security_investigations.jpg
cloud-design-availability.md
cloud-design-awsaccount.md
cloud-design-backup.md
cloud-design-common.md
cloud-design-configurationmanagement.md
cloud-design-deployprovisioning.md
cloud-design-log.md
cloud-design-monitoring.md
cloud-design-naming.md
cloud-design-network.md
cloud-design-patchmanagement.md
cloud-design-security.md
IAM-switch-role.svg
user-attach-policy.svg
user-join-group-policy-attached.svg
README.md
history.md
LICENSE
README.md
steering/
nfr-outdated-check-20260223.md
nfr-update-plan-20260223.md
skills-plan.md
survey/
doc_source/
nfr-cost-optimization.md
nfr-generative-ai.md
nfr-infrastructure.md
nfr-migration.md
nfr-operational-excellence.md
nfr-performance-efficiency.md
nfr-reliability.md
nfr-security.md
nfr-sustainability.md
README.md
workshop/
doc_source/
workshop_multiaccount.md
workshop_network.md
workshop_s3.md
README.mdFAQ
document-templates-for-aws is a Claude Code plugin with 2 hand-picked skills for documentation work, indexed on Flowy. Install it with the command on its page. It includes nfr-outdated-check, wa-review. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is document-templates-for-aws?
- Fetches AWS knowledge and loads design sheets to check NFR obsolescence and run Well-Architected reviews. Fires during requirement gathering and architecture review.
- How do I install document-templates-for-aws?
- Run these in Claude Code: npx -y skills add YoshiiRyo1/document-templates-for-aws --agent claude-code. Then prompt normally.
- Does document-templates-for-aws auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is document-templates-for-aws free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.