전사 Kiro 하네스,
하나의 표준으로.

.kiro/
├── steering/team-conventions.md   # 규칙 (AGENTS.md 계보)
├── skills/api-review/SKILL.md     # 스킬 (anthropics/skills 계보)
├── agents/reviewer.json           # 에이전트 (steering+skill 로드)
└── settings/mcp.json              # MCP (aws-docs / awslabs 사례)

$ kiro-cli agent list
  ...
  reviewer    Workspace    사내 코드 리뷰 에이전트   # ← 방금 만든 로컬 에이전트 발견됨

$ kiro-cli agent validate --path .kiro/agents/reviewer.json
# (출력 없음 = 스키마 유효)

$ kiro-cli mcp list
  📄 workspace:
    reviewer         # 워크스페이스 하네스 인식
  🤖 default:
    • aws-docs     uvx   # settings/mcp.json 로드

$ kiro-cli chat --agent reviewer "이 핸들러를 팀 컨벤션·api-review 기준으로 리뷰"
  (using tool: read) .kiro/skills/api-review/SKILL.md  ✓
> 1. 응답 봉투 위반: res.json(rows) → team-conventions·api-review 상
     { data, error } 봉투 필요 → res.json({ data: rows, error: null })
  2. 페이지네이션 누락: "cursor 기반" 규칙 → ?cursor= , 응답에 nextCursor
  3. 에러 처리 부재: 실패 시 { data: null, error: {...} } (try/catch)
# Credits: 0.31 · Time: 23s  →  steering + skill 이 실제 로드·사용됨

#!/bin/bash
# 중앙 저장소의 전사 steering 을 각 기기 ~/.kiro/steering 로 동기화
USER=$(stat -f%Su /dev/console)
HOME_DIR=$(dscl . -read /Users/"$USER" NFSHomeDirectory | awk '{print $2}')
DEST="$HOME_DIR/.kiro/steering"
mkdir -p "$DEST"
git -C /tmp/kiro-harness pull || git clone https://git.corp.example/kiro-harness /tmp/kiro-harness
rsync -a --delete /tmp/kiro-harness/steering/ "$DEST/"
chown -R "$USER" "$HOME_DIR/.kiro"

#!/usr/bin/env bash
set -euo pipefail
REPO="https://git.corp.example/platform/kiro-harness.git"
SRC="${TMPDIR:-/tmp}/kiro-harness"
DEST="$HOME/.kiro"
git -C "$SRC" pull --ff-only 2>/dev/null || git clone --depth 1 "$REPO" "$SRC"
# 전사 파일은 회사 네임스페이스로 격리 배치 → 개인 파일과 충돌 방지
for d in steering skills agents hooks; do
  mkdir -p "$DEST/$d/company"
  rsync -a --delete "$SRC/$d/" "$DEST/$d/company/"
done
mkdir -p "$DEST/settings"
cp "$SRC/settings/mcp.json" "$DEST/settings/mcp.company.json"
echo "kiro-harness $(cat "$SRC/VERSION") 동기화 완료"

{
  "servers": {
    "internal-api": {
      "url": "https://mcp.corp.example.com/mcp",      # remote(HTTP)
      "headers": { "Authorization": "Bearer ${CORP_TOKEN}" }
    },
    "aws-docs": { "command": "uvx", "args": ["awslabs.aws-documentation-mcp-server"] }
  }
}

{ "mcpServers": {
  "internal-api": {
    "url": "https://gateway.bedrock-agentcore.ap-northeast-2.amazonaws.com/.../mcp",
    "oauth": { "clientId": "<cognito-app-client-id>" },   # 공개 클라이언트(PKCE)
    "oauthScopes": ["openid", "api/read"]
  }
}}