Generate Japanese documentation from spec files. Use AUTOMATICALLY after writing or editing any file matching specs/**/*.md (excluding specs/**/docs/*). Also use when user says "generate spec docs", "spec docs", "PM docs", "architect docs", or "implementation guide". (user)
This skill inherits all available tools. When active, it can use any tool Claude has access to.
README.mdThis skill MUST be invoked automatically when:
specs/**/*.md is created or modified via Write or Edit toolsspecs/**/docs/ (those are generated outputs)After writing/editing a spec file, Claude MUST:
This skill also activates when user says:
Generate Japanese documentation from specification files for three different audiences:
specs/
└── feature-name/
├── spec.md # Original spec (English)
└── docs/
├── overview.ja.md # PM向け概要
├── architecture.ja.md # アーキテクト向け設計
└── implementation.ja.md # 実装者向けガイド
Find the specification file to process:
Read the spec file and extract:
Generate three separate documents using parallel subagents for efficiency.
Target audience: Product Managers, stakeholders, business users
Content structure:
# [機能名] 概要
## 目的
[この機能が解決する課題、ビジネス価値]
## 対象ユーザー
[誰がこの機能を使うか]
## スコープ
### 含まれる機能
- [機能1]
- [機能2]
### 含まれない機能
- [除外項目1]
- [除外項目2]
## ユーザーストーリー
[主要なユーザーシナリオを日本語で記述]
## 受け入れ条件
[Acceptance criteriaを日本語で、非技術者にもわかる形で記述]
## 成功指標
[この機能の成功をどう測定するか]
## リスクと制約
[ビジネス観点でのリスク、制約事項]
Target audience: Technical leads, architects, senior engineers
Content structure:
# [機能名] アーキテクチャ設計
## 技術概要
[技術的な全体像、採用する技術スタック]
## システム構成
[コンポーネント間の関係、データフロー]
## API設計
[エンドポイント、リクエスト/レスポンス形式]
## データモデル
[データベーススキーマ、エンティティ関係]
## 非機能要件
### パフォーマンス
[レイテンシ、スループット要件]
### スケーラビリティ
[同時接続数、データ量]
### セキュリティ
[認証、認可、データ保護]
### 可用性
[SLA、フェイルオーバー]
## 依存関係
[外部サービス、ライブラリ]
## 技術的制約
[技術的な制限事項]
## 設計上の決定事項
[重要な技術的決定とその理由]
Target audience: Developers implementing the feature
Content structure:
# [機能名] 実装ガイド
## 実装概要
[実装する内容の概要]
## 前提条件
[実装前に必要な知識、セットアップ]
## 詳細要件
### [機能1]
**エンドポイント**: `POST /api/xxx`
**リクエスト**:
\`\`\`json
{
"field": "説明"
}
\`\`\`
**レスポンス**:
\`\`\`json
{
"data": {},
"meta": {}
}
\`\`\`
**バリデーション**:
- [バリデーションルール1]
- [バリデーションルール2]
**エラーコード**:
| HTTP | コード | 条件 |
|------|--------|------|
| 400 | INVALID_XXX | [条件] |
## エッジケース
| 入力 | 期待される動作 |
|------|----------------|
| [ケース1] | [動作] |
| [ケース2] | [動作] |
## エラーハンドリング
[各エラーケースの処理方法]
## テスト観点
[ユニットテスト、統合テストで確認すべき項目]
## 実装チェックリスト
- [ ] [チェック項目1]
- [ ] [チェック項目2]
- [ ] [チェック項目3]
docs/ directory under the spec directory if it doesn't exist