この記事は、V2 2.8.0 以降の構築手順です。
今日現在だと 2.10.0 がインストールされます。
aidlcコマンドの導入
tmp="$(mktemp -d)"
curl -fsSL \
https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.sh \
-o "$tmp/install.sh"
sh "$tmp/install.sh"
rm -rf "$tmp"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
% aidlc --version
aidlc 2.10.0 (runtime 2.10.0)
%
プロジェクト設定
mkdir -p ~/[プロジェクトフォルダ]
cd ~/[プロジェクトフォルダ]
aidlc config --harness claude
途中の選択肢
% aidlc config --harness claude
Initialize AI-DLC in /Users/m4/dev/negai? [y/N]: y
MCP servers
1. on
2. off
MCP [2]:
MCP servers off.
configured /Users/m4/dev/negai for Claude Code 2.10.0; next: open Claude Code in this project and run `/aidlc --doctor`
Setup check - 3 of 8 sections need you.
[ok] Harnesses claude recorded
[needs] Models no recorded policy; agents inherit your session model and effort
[needs] Runtime aidlc resolves only through the interactive PATH at /Users/m4/.local/bin/aidlc
[ok] Flags defaults
[ok] Project plugins: all installed, MCP: none, completions: none
[needs] Providers no recorded answers; provider access unverified
[ok] Trust no unmet host trust
[ok] Workspace workspace shell present
Fix the 3 sections that need you now? [Y/n]:
Record settings in [project recommended/local/global]:
Model policy for claude
Preset: none (shipped defaults)
All 14 agents inherit your session model and effort, except:
Reviewing (2 agents): sonnet / medium
Review-only agents use the measured medium baseline; raising effort trades review time and cost for deeper correctness checking.
Recorded in: nothing yet - run 'aidlc config models --preset balanced --project --yes'
Full per-agent list: aidlc config models --show --json
Pins bind in both directions, and shipped tiers never raise an agent above the session.
Models [Enter keep everything, 1 preset, 2 group efforts, 3 set each one myself]:
model policy unchanged
Runtime needs one manual action:
Add ~/.local/bin to the login-independent PATH the harness inherits (a file in /etc/paths.d), not only an interactive shell rc file.
Full diagnostics: aidlc config runtime --show
runtime configuration unchanged
Model provider
Found AWS credentials (credentials profile default); detected region ap-northeast-1.
1. keep current inherit the provider already configured in the harness (default)
2. amazon-bedrock write the AWS region and profile to settings.json (AWS credentials detected)
Provider [1]:
Keeping the current harness provider; attributable AI-DLC Bedrock overrides will be removed when present, and other provider settings will be kept.
Providers current harness provider; attributable AI-DLC overrides cleared when present
configured providers settings for /Users/m4/dev/negai
Setup complete. 2 actions still need you
runtime aidlc config runtime
models aidlc config models
%
これで、プロジェクトフォルダを指定して、claude code で AI-DLC を開始できるはず
正常性確認
/aidlc --doctor
AI-DLC doctor
Machine
warn Runtime hook PATH: aidlc is interactive-only at /Users/m4/.local/bin/aidlc
fix: Add ~/.local/bin to the login-independent PATH the harness inherits (a file in /etc/paths.d), not only an interactive shell rc file.
warn Update: binary 2.10.0; update cache is stale
fix: run `aidlc update --check`
ok 8 checks passed
Project (.claude, Claude Code)
warn Plugins: 1 need attention
fix: host inventory unavailable; run sync through the host SessionStart adapter
warn [runtime-graph-missing] runtime-graph.json is missing for the active workflow.
fix: No compiled runtime graph. Re-run `aidlc engine graph compile`. If it never appears, the rebuild-stage-graph hook is not firing on this harness.
ok 47 checks passed
Framework integrity
ok all 12 checks passed
0 problems, 4 warnings.
Warnings are advisory - if everything works, ignore them.
Run 'aidlc doctor --verbose' to see every check.