設定

kizamiはリポジトリルートの kizami.toml、またはグローバル設定 ~/.config/kizami/config.toml で設定できます。

プロジェクトレベルの設定(kizami.toml)がグローバル設定より優先されます。

コミットしたくない環境固有の値(個人の AWS Bedrock モデル ARN など)は、同じディレクトリに kizami.local.toml を作成してください。kizami.toml の値を上書きします。.gitignore に追加してバージョン管理から除外してください。

# kizami.local.toml  (.gitignore に追加)
[ai]
model = "arn:aws:bedrock:ap-northeast-1:123456789012:application-inference-profile/abc123"

← ドキュメントトップへ


設定ファイルの作成

kizami init を実行するとデフォルト値入りの kizami.toml が生成されます。手動で作成することも可能です。


全オプション

[documents]

[documents]
dirs = ["docs/decisions", "docs/design"]

kizami listkizami searchkizami showkizami blamekizami reviewkizami statuskizami supersede がドキュメントを検索するディレクトリです。設定しない場合は [decisions] dir が使われます。

[decisions]

[decisions]
dir = "docs/decisions"

kizami adr が新しいADRを保存するディレクトリです。

[design]

[design]
dir = "docs/design"

kizami design が新しい設計ドキュメントを保存するディレクトリです。

[audit]

[audit]
dirs = ["docs/decisions", "docs/design"]

kizami audit がチェックするディレクトリです。設定しない場合は [documents] dirs が使われます。

[review]

[review]
months_threshold = 6

kizami review が陳腐化とみなすまでの月数です。デフォルトは6ヶ月。kizami review --months N でコマンド実行時に上書きできます。

[editor]

[editor]
command = "code --wait"

ドキュメント作成後に開くエディタコマンドです。$EDITOR$VISUAL 環境変数が優先されます。

[ai]

[ai]
model = "claude-sonnet-4-20250514"

kizami adr --ai / kizami design --ai で使用するモデルです。--model フラグでコマンド実行時に上書きできます。

Anthropic API(デフォルト): claude-sonnet-4-20250514 などの標準モデルIDを指定します。ANTHROPIC_API_KEY が必要です。

AWS Bedrock: BedrockのモデルIDを設定するだけで、kizamiが自動的にBedrockへルーティングします。追加設定は不要です。対応パターン:

パターン
Application / Provisioned Inference Profile ARN arn:aws:bedrock:ap-northeast-1:123456789012:application-inference-profile/abc123
クロスリージョン推論プロファイル us.anthropic.claude-3-5-sonnet-20241022-v2:0
プロバイダープレフィックス付きモデルID anthropic.claude-3-5-sonnet-20241022-v2:0

AWSクレデンシャルは標準の環境変数(AWS_PROFILEAWS_REGIONAWS_ACCESS_KEY_ID など)から解決されます。

明示的にBedrockを指定したい場合は [ai] backend = "bedrock" または環境変数 CLAUDE_CODE_USE_BEDROCK=1 も使用できます。


kizami.toml の例

[documents]
dirs = ["docs/decisions", "docs/design"]

[decisions]
dir = "docs/decisions"

[design]
dir = "docs/design"

[audit]
dirs = ["docs/decisions", "docs/design"]

[review]
months_threshold = 6

[editor]
command = "code --wait"

[ai]
model = "claude-sonnet-4-20250514"