Kiro の 仕様駆動開発で作る AI ボードゲーム

src/
├── handler.py # Lambda エントリーポイント、ルーティング
├── board.py # 盤面データモデル、バリデーション
├── bedrock_client.py # Bedrock 呼び出し (6モデル対応) 
├── move_validator.py # 合法手列挙・検証
└── response.py # レスポンスビルダー

curl -X POST https://xxxxx.execute-api.us-east-1.amazonaws.com/Prod/move \
	-H "x-api-key: YOUR_API_KEY" \
	-H "Content-Type: application/json" \
	-d '{
		"board": [
			{"position": "d4", "state": "white"},
			{"position": "d5", "state": "black"},
			{"position": "e4", "state": "black"},
			{"position": "e5", "state": "white"}
		],
		"model": "sonnet4"
	}'

{
	"move": "d3",
	"reason": "Flanks 3 black discs diagonally",
	"confidence": "high"
}

def parse_board(payload: dict) -> Board:
	board_data = payload.get("board", [])
	cells: dict[str, str] = {}
	for cell_data in board_data:
		cells[cell_data["position"]] = cell_data["state"]
	# 未指定セルを empty で補完
	for pos in ALL_POSITIONS:
		if pos not in cells:
		cells[pos] = "empty"
	return Board(cells=cells)

DIRECTIONS = [
	(-1, -1), (-1, 0), (-1, 1),
	(0, -1), (0, 1),
	(1, -1), (1, 0), (1, 1),
]

def get_flippable_discs(board: Board, position: str, color: str) -> list[str]:
	if board.cells.get(position) != "empty":
		return []
	opponent = "black" if color == "white" else "white"
	col, row = _pos_to_coords(position)
	flippable = []
	for dc, dr in DIRECTIONS:
		candidates = []
		c, r = col + dc, row + dr
		while 0 <= c <= 7 and 0 <= r <= 7:
			pos = _coords_to_pos(c, r)
			cell_state = board.cells.get(pos)
			if cell_state == opponent:
				candidates.append(pos)
				c += dc
				r += dr
			elif cell_state == color and candidates:
				flippable.extend(candidates)
				break
			else:
				break
	return flippable

MODEL_REGISTRY = {
	"sonnet4": {"model_id": "us.anthropic.claude-sonnet-4-20250514-v1:0", "provider": "anthropic"},
	"opus4.6": {"model_id": "us.anthropic.claude-opus-4-6-v1", "provider": "anthropic"},
	"haiku4.5": {"model_id": "us.anthropic.claude-haiku-4-5-20251001-v1:0", "provider": "anthropic"},
	"nova-pro": {"model_id": "us.amazon.nova-pro-v1:0", "provider": "nova"},
	"nova-micro": {"model_id": "us.amazon.nova-micro-v1:0", "provider": "nova"},
	"llama3.3-70b": {"model_id": "us.meta.llama3-3-70b-instruct-v1:0", "provider": "llama"},
}

_REQUEST_BUILDERS = {
	"anthropic": _build_anthropic_request,
	"nova": _build_nova_request,
	"llama": _build_llama_request,
}

_RESPONSE_PARSERS = {
	"anthropic": _parse_claude_response,
	"nova": _parse_nova_response,
	"llama": _parse_llama_response,
}

# template.yaml (抜粋) 
Resources:
	GameApi:
		Type: AWS::Serverless::Api
		Properties:
			StageName: Prod
			Auth:
				ApiKeyRequired: true
GameFunction:
	Type: AWS::Serverless::Function
	Properties:
		CodeUri: src/
		Handler: handler.lambda_handler
		Runtime: python3.12
		Timeout: 30
		Policies:
			- Version: '2012-10-17'
			Statement:
				- Effect: Allow
				Action: bedrock:InvokeModel
				Resource: '*'

try:
	from board import parse_board, validate_board
except ImportError:
	from src.board import parse_board, validate_board

def _extract_json_from_text(text: str) -> dict:
	# 1. 直接パース
	try:
		return json.loads(text)
	except json.JSONDecodeError:
		pass
	# 2. ```json ... ``` ブロック
	match = re.search(r"```(?:json)?\s*(\{.*?\})\s*```", text, re.DOTALL)
	if match:
		return json.loads(match.group(1))
	# 3. テキスト内の最初の {...}
	match = re.search(r"\{[^{}]*\}", text, re.DOTALL)
	if match:
		return json.loads(match.group(0))
	raise ValueError("No JSON found in model response")

# 修正前: 最大3回リトライ
for attempt in range(MAX_RETRY_COUNT):
	result = invoke_model(board, model=model)
	if is_legal_move(board, result["move"], "white"):
		return success_response(result)

# 修正後: 1回呼び出し + 即フォールバック
result = invoke_model(board, model=model)
if is_legal_move(board, result["move"], "white"):
	return success_response(result)
chosen = random.choice(legal_moves)
return success_response({
	"move": chosen,
	"reason": "Fallback: selected from legal moves",
	"confidence": "low",
})

tests/test_board.py ... 盤面バリデーション、パース、シリアライズ
tests/test_bedrock_client.py ... プロンプト構築、レスポンスパース、モデル解決、各プロバイダー
tests/test_handler.py ... ルーティング、エラーハンドリング、合法手検証、フォールバック、モデル選択
tests/test_move_validator.py ... 座標変換、合法手列挙、合法性判定
tests/test_response.py ... レスポンスビルダー