메뉴
Architecture Decision Records (ADRs)をdocs/adr/ディレクトリで管理します。 新しいADRの作成、既存ADRの編集、ADR索引の確認を行います。 ユーザーがアーキテクチャ決定の記録、ADRの作成・更新・検索を依頼したときに使用してください。 番号の自動採番、プロジェクト固有のフォーマット（日本語、メタデータ構造）を遵守します。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | manage-adr |
| description | Architecture Decision Records (ADRs)をdocs/adr/ディレクトリで管理します。 新しいADRの作成、既存ADRの編集、ADR索引の確認を行います。 ユーザーがアーキテクチャ決定の記録、ADRの作成・更新・検索を依頼したときに使用してください。 番号の自動採番、プロジェクト固有のフォーマット（日本語、メタデータ構造）を遵守します。 |
| allowed-tools | Read, Edit, Glob, Grep |
このスキルはdocs/adr/内のArchitecture Decision Recordsを、プロジェクト固有のルールに従って管理します。
docs/adr/
├── 0001-security.md
├── 0002-realtime.md
├── 0003-cost.md
├── 0004-services.md
├── 0005-centralize-runtime-config.md
├── 0006-transcript-subscription-simplification.md
├── 0007-orchestrator-browser-interaction.md
├── 0008-chime-media-pipelines-for-server-side-transcription.md
├── 0009-third-party-meeting-service-integration.md
└── 0011-sqs-fifo-for-transcript-streaming.md
[4桁番号]-[ケバブケース説明].md0001-security.md, 0011-sqs-fifo-for-transcript-streaming.md各ADRファイルは以下のメタデータを含む必要があります：
# ADR 0001: タイトル
- Status: Proposed | Accepted | Rejected | Superseded | TBD
- Date: YYYY-MM-DD
- Owners: プロジェクトチーム名 または 個人名
Statusの意味:
# ADR [番号]: タイトル
- Status: [Status]
- Date: [YYYY-MM-DD]
- Owners: [チーム名]
## 背景 / Context
[意思決定が必要になった背景、問題、要件]
## 決定 / Decision
[何を決定したか。明確に、簡潔に]
## 影響 / Consequences
[この決定によって生じる影響（ポジティブ、ネガティブ両方）]
## 代替案 / Alternatives Considered
[検討した他の選択肢とその理由]
## 参考 / References
[関連リンク、ドキュメント、関連ADR]
ADR間で関連がある場合、明示的に参照する：
## 参考 / References
### 関連ADR
- ADR 0002: リアルタイム性（レイテンシ要件）
- ADR 0003: コスト（コスト最適化方針）
- ADR 0007: Orchestratorとブラウザの連携
docs/adr/[番号]*.mdパターンで検索docs/adr/*.mdを一覧表示現在は専用のREADME.mdは存在しないが、全ADRを一覧する場合：
Glob: docs/adr/*.md
で一覧を取得し、ユーザーに提示する。
ユーザー: 「SQSの使用について新しいADRを書いて」
docs/adr/*.md を確認# ADR 0012: SQS使用方針
- Status: Proposed
- Date: 2025-12-25
- Owners: timtam PoC チーム
## 背景 / Context
[SQS導入の背景]
## 決定 / Decision
[SQS使用の決定]
## 影響 / Consequences
[影響分析]
## 代替案 / Alternatives Considered
[他の選択肢]
## 参考 / References
[関連情報]
/home/yattom/work/timtam/docs/adr/0012-sqs-usage-policy.md を作成ユーザー: 「ADR 0011のStatusをAcceptedに変更して」
docs/adr/0011-*.md を読み込む- Status: Proposed
+ Status: Accepted
- Date: 2025-12-25
+ Date: 2025-12-26
ユーザー: 「Kinesisに関するADRを教えて」
pattern: "Kinesis", path: docs/adr/ を検索❌ 既存のADR番号を再利用しない ❌ 番号を遡って挿入しない（0001と0002の間に0001.5を作らない） ✅ 常に最新番号+1を使用
❌ Statusを省略 ❌ Dateフォーマットが不統一（2025/12/25等） ✅ 必須メタデータ（Status, Date, Owners）を必ず含める
常に絶対パスを使用：
/home/yattom/work/timtam/docs/adr/0001-security.mddocs/adr/0001-security.md開発用およびインフラ作業用のワークフローコマンドを実行します。 本番環境: CDKデプロイ、インフラ管理(open/close)、Webビルド・デプロイ ローカル開発環境: LocalStackセットアップ、スキーマ同期、docker-compose操作 ユーザーがデプロイ、ビルド、インフラ操作、ローカル開発を依頼したときに使用してください。
Write product code and test code simultaneously to write conscise and simple code.
Generates clear, concise git commit messages in Japanese from staged changes. Use when the user asks to create a commit, write a commit message, or review staged changes for committing.
docs/plan.md内のTODOリストを管理します。TODO項目の追加、完了マーク、整理を行います。 ユーザーがplan.mdの更新、TODO管理、計画の進捗確認を依頼したときに使用してください。 プロジェクト固有のTODO形式ルール（フラット構造、エピック化など）を遵守します。