agentic-dev 0.1.0 → 0.2.1

package/.agent/prd.json

@@ -0,0 +1,29 @@
+{
+  "project": "template-agentic-program",
+  "goal": "이 파일은 Ralph loop starter scaffold다. downstream 저장소는 현재 작업 scope에 맞는 story set으로 즉시 교체한다.",
+  "updated_at": "2026-03-19T00:00:00+09:00",
+  "stories": [
+    {
+      "id": "TEMPLATE-ALIGN-001",
+      "title": "Replace template PRD scaffold with repository-specific delivery stories",
+      "priority": 1,
+      "status": "pending",
+      "scope": [
+        ".agent/prd.json",
+        ".agent/prompt.md",
+        "sdd/02_plan",
+        "sdd/03_build",
+        "sdd/04_verify"
+      ],
+      "validation": [
+        "jq . .agent/prd.json"
+      ],
+      "done_when": [
+        "Template placeholder stories are replaced with repository-specific work items.",
+        "Validation commands point at the active repository program.",
+        "progress.txt contains the current operator note."
+      ],
+      "blockers": []
+    }
+  ]
+}

package/.agent/progress.txt

@@ -0,0 +1 @@
+2026-03-19 scaffold initialized for canonical template Ralph loop.

package/.agent/prompt.md

@@ -0,0 +1,21 @@
+You are running one Ralph iteration in this repository.
+
+Rules:
+1. Read `.agent/prd.json` and `.agent/progress.txt`.
+2. Work only on the requested story id.
+3. Lock one reproduction or validation command before editing.
+4. Make one focused change set toward the requested story.
+5. Re-run the requested validation commands immediately.
+6. Update the matching `sdd/02_plan`, `sdd/03_build`, and `sdd/04_verify` current-state artifacts when scope changes.
+7. Update `.agent/prd.json` story status and append one short line to `.agent/progress.txt`.
+8. Stop after this iteration and report:
+   - story id
+   - validation status
+   - files changed
+   - next story or blocker
+9. If the caller provided a completion promise token and the story is truly complete in this iteration, print that token exactly once.
+
+Guardrails:
+- Do not create a parallel `docs/` tree when `sdd/` exists.
+- Do not leave execution-history narrative inside `sdd/03_build`.
+- Do not claim completion without validation evidence.

package/.agent/ralph-loop-state.json

@@ -0,0 +1,13 @@
+{
+  "updated_at": "2026-03-19T00:00:00Z",
+  "story_id": "",
+  "max_iterations": 12,
+  "current_iteration": 0,
+  "status": "idle",
+  "completion_promise": "STORY_COMPLETE",
+  "promise_seen": false,
+  "last_exit_code": 0,
+  "prompt_snapshot": "",
+  "output_file": "",
+  "changed_files": []
+}

package/.agent/ralph-supervisor-state.json

@@ -0,0 +1,12 @@
+{
+  "updated_at": "2026-03-19T00:00:00Z",
+  "max_iterations": 1000,
+  "story_iterations": 1,
+  "current_iteration": 0,
+  "active_story": "",
+  "child_exit_code": 0,
+  "child_status": "idle",
+  "repeat_count": 0,
+  "status": "idle",
+  "run_dir": ""
+}

package/.agent/ralph-supervisor.sh

@@ -0,0 +1,238 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+AGENT_DIR="$ROOT_DIR/.agent"
+PRD_FILE="$AGENT_DIR/prd.json"
+PROGRESS_FILE="$AGENT_DIR/progress.txt"
+RUNS_DIR="$AGENT_DIR/runs"
+STATE_FILE="$AGENT_DIR/ralph-supervisor-state.json"
+RALPH_RUNNER="$AGENT_DIR/ralph.sh"
+
+max_iterations=1000
+story_iterations=1
+completion_promise="STORY_COMPLETE"
+run_label=""
+sleep_seconds=0
+dry_run=0
+
+usage() {
+  cat <<'EOF'
+Usage:
+  .agent/ralph-supervisor.sh [options]
+
+Options:
+  --max-iterations N        Maximum global iterations across all stories. Default: 1000
+  --story-iterations N      Iterations per selected story invocation. Default: 1
+  --completion-promise TXT  Promise token passed to child Ralph runner
+  --run-label LABEL         Optional label suffix for this supervisor run
+  --sleep-seconds N         Sleep between global iterations
+  --dry-run                 Use child runner in dry-run mode
+  -h, --help                Show help
+
+Behavior:
+  - Picks the next pending/in_progress story from .agent/prd.json each global iteration
+  - Invokes .agent/ralph.sh for one focused child loop
+  - Stops when all stories complete, when max iterations are exhausted,
+    or when the same story/status pair repeats 3 times with no new signal
+  - Writes state to .agent/ralph-supervisor-state.json and appends monitor lines to .agent/progress.txt
+EOF
+}
+
+require_file() {
+  local file_path="$1"
+  if [[ ! -f "$file_path" ]]; then
+    echo "Missing required file: $file_path" >&2
+    exit 1
+  fi
+}
+
+select_story() {
+  jq -r '
+    .stories
+    | map(select(.status == "in_progress" or .status == "pending"))
+    | sort_by(.priority)
+    | .[0].id // empty
+  ' "$PRD_FILE"
+}
+
+read_story_status() {
+  local story_id="$1"
+  jq -r --arg id "$story_id" '.stories[] | select(.id == $id) | .status // "missing"' "$PRD_FILE"
+}
+
+write_state() {
+  local iteration="$1"
+  local active_story="$2"
+  local child_exit="$3"
+  local child_status="$4"
+  local repeat_count="$5"
+  local status="$6"
+  local run_dir="$7"
+
+  cat >"$STATE_FILE" <<EOF
+{
+  "updated_at": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
+  "max_iterations": $max_iterations,
+  "story_iterations": $story_iterations,
+  "current_iteration": $iteration,
+  "active_story": "$active_story",
+  "child_exit_code": $child_exit,
+  "child_status": "$child_status",
+  "repeat_count": $repeat_count,
+  "status": "$status",
+  "run_dir": "${run_dir#$ROOT_DIR/}"
+}
+EOF
+}
+
+main() {
+  require_file "$PRD_FILE"
+  require_file "$PROGRESS_FILE"
+  require_file "$RALPH_RUNNER"
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --max-iterations)
+        max_iterations="${2:-}"
+        shift 2
+        ;;
+      --story-iterations)
+        story_iterations="${2:-}"
+        shift 2
+        ;;
+      --completion-promise)
+        completion_promise="${2:-}"
+        shift 2
+        ;;
+      --run-label)
+        run_label="${2:-}"
+        shift 2
+        ;;
+      --sleep-seconds)
+        sleep_seconds="${2:-}"
+        shift 2
+        ;;
+      --dry-run)
+        dry_run=1
+        shift
+        ;;
+      -h|--help)
+        usage
+        exit 0
+        ;;
+      *)
+        echo "Unknown argument: $1" >&2
+        usage >&2
+        exit 2
+        ;;
+    esac
+  done
+
+  if ! [[ "$max_iterations" =~ ^[0-9]+$ ]] || [[ "$max_iterations" -lt 1 ]]; then
+    echo "--max-iterations must be a positive integer" >&2
+    exit 2
+  fi
+  if ! [[ "$story_iterations" =~ ^[0-9]+$ ]] || [[ "$story_iterations" -lt 1 ]]; then
+    echo "--story-iterations must be a positive integer" >&2
+    exit 2
+  fi
+  if ! [[ "$sleep_seconds" =~ ^[0-9]+$ ]] || [[ "$sleep_seconds" -lt 0 ]]; then
+    echo "--sleep-seconds must be a non-negative integer" >&2
+    exit 2
+  fi
+
+  mkdir -p "$RUNS_DIR"
+  local run_id
+  run_id="$(date +%Y%m%d-%H%M%S)"
+  if [[ -n "$run_label" ]]; then
+    run_id="$run_id-$run_label"
+  fi
+  local supervisor_run_dir="$RUNS_DIR/supervisor-$run_id"
+  mkdir -p "$supervisor_run_dir"
+
+  local previous_signature=""
+  local repeat_count=0
+  local final_status="max_iterations_reached"
+
+  local iteration=1
+  while [[ "$iteration" -le "$max_iterations" ]]; do
+    local story_id
+    story_id="$(select_story)"
+    if [[ -z "$story_id" ]]; then
+      final_status="all_stories_completed"
+      write_state "$iteration" "" 0 "none" 0 "$final_status" "$supervisor_run_dir"
+      echo "$(date +%F) supervisor all-stories-complete iteration=$iteration" >>"$PROGRESS_FILE"
+      break
+    fi
+
+    echo "[supervisor] iteration $iteration/$max_iterations story=$story_id"
+
+    local child_args=(
+      --story-id "$story_id"
+      --max-iterations "$story_iterations"
+      --completion-promise "$completion_promise"
+      --run-label "supervisor-$iteration-$story_id"
+    )
+    if [[ $dry_run -eq 1 ]]; then
+      child_args+=(--dry-run)
+    fi
+
+    set +e
+    "$RALPH_RUNNER" "${child_args[@]}"
+    local child_exit=$?
+    set -e
+
+    local child_status="unknown"
+    if [[ -f "$AGENT_DIR/ralph-loop-state.json" ]]; then
+      child_status="$(jq -r '.status // "unknown"' "$AGENT_DIR/ralph-loop-state.json")"
+    fi
+
+    local story_status
+    story_status="$(read_story_status "$story_id")"
+    local signature="$story_id:$child_status:$story_status"
+    if [[ "$signature" == "$previous_signature" ]]; then
+      repeat_count=$((repeat_count + 1))
+    else
+      repeat_count=1
+      previous_signature="$signature"
+    fi
+
+    if [[ "$story_status" == "completed" || "$child_status" == "completed" ]]; then
+      final_status="story_completed"
+    elif [[ "$repeat_count" -ge 3 ]]; then
+      final_status="stopped_same_signal_3x"
+    elif [[ "$child_status" == "iteration_pass_no_promise" || "$child_status" == "dry_run" || "$child_exit" -eq 0 ]]; then
+      final_status="iteration_ok"
+    else
+      final_status="iteration_failed"
+    fi
+
+    write_state "$iteration" "$story_id" "$child_exit" "$child_status" "$repeat_count" "$final_status" "$supervisor_run_dir"
+    echo "$(date +%F) supervisor iteration-$iteration story=$story_id child_status=$child_status story_status=$story_status repeat=$repeat_count exit=$child_exit" >>"$PROGRESS_FILE"
+
+    if [[ "$final_status" == "stopped_same_signal_3x" ]]; then
+      break
+    fi
+
+    iteration=$((iteration + 1))
+    if [[ "$iteration" -le "$max_iterations" && "$sleep_seconds" -gt 0 ]]; then
+      sleep "$sleep_seconds"
+    fi
+  done
+
+  echo "[supervisor] final_status=$final_status run_dir=${supervisor_run_dir#$ROOT_DIR/}"
+  if [[ "$final_status" == "all_stories_completed" ]]; then
+    exit 0
+  fi
+  if [[ "$final_status" == "stopped_same_signal_3x" ]]; then
+    exit 1
+  fi
+  if [[ "$final_status" == "max_iterations_reached" ]]; then
+    exit 1
+  fi
+  exit 0
+}
+
+main "$@"

package/.agent/ralph.sh

@@ -0,0 +1,305 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+AGENT_DIR="$ROOT_DIR/.agent"
+PRD_FILE="$AGENT_DIR/prd.json"
+PROMPT_FILE="$AGENT_DIR/prompt.md"
+PROGRESS_FILE="$AGENT_DIR/progress.txt"
+RUNS_DIR="$AGENT_DIR/runs"
+STATE_FILE="$AGENT_DIR/ralph-loop-state.json"
+
+story_id=""
+max_iterations=12
+completion_promise="STORY_COMPLETE"
+prompt_file="$PROMPT_FILE"
+run_label=""
+sleep_seconds=0
+dry_run=0
+
+usage() {
+  cat <<'EOF'
+Usage:
+  .agent/ralph.sh [story_id]
+  .agent/ralph.sh --story-id MOB-EXACT-AUTH-001 --max-iterations 20
+
+Options:
+  --story-id ID             Ralph story id from .agent/prd.json
+  --max-iterations N        Maximum codex iterations to run
+  --completion-promise TXT  Promise token to detect in codex output
+  --prompt-file PATH        Base prompt markdown file
+  --run-label LABEL         Optional run label for the log directory
+  --sleep-seconds N         Sleep between iterations
+  --dry-run                 Do not invoke codex exec; only emit prompt snapshots
+  -h, --help                Show help
+
+Behavior:
+  - Select the first in_progress/pending story when no story id is given
+  - Run codex exec in a loop until the completion promise is observed
+  - Persist per-iteration prompt/output/status artifacts under .agent/runs/
+  - Append monitor lines to .agent/progress.txt
+EOF
+}
+
+require_file() {
+  local file_path="$1"
+  if [[ ! -f "$file_path" ]]; then
+    echo "Missing required file: $file_path" >&2
+    exit 1
+  fi
+}
+
+select_story() {
+  if [[ -n "$story_id" ]]; then
+    return 0
+  fi
+
+  story_id="$(
+    jq -r '
+      .stories
+      | map(select(.status == "in_progress" or .status == "pending"))
+      | sort_by(.priority)
+      | .[0].id // empty
+    ' "$PRD_FILE"
+  )"
+
+  if [[ -z "$story_id" ]]; then
+    echo "No open Ralph story found." >&2
+    exit 1
+  fi
+}
+
+load_story_payload() {
+  jq -c --arg id "$story_id" '.stories[] | select(.id == $id)' "$PRD_FILE"
+}
+
+write_state() {
+  local iteration="$1"
+  local status="$2"
+  local promise_seen="$3"
+  local output_file="$4"
+  local prompt_snapshot="$5"
+  local exit_code="$6"
+  local changed_files_json="$7"
+
+  cat >"$STATE_FILE" <<EOF
+{
+  "updated_at": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
+  "story_id": "$story_id",
+  "max_iterations": $max_iterations,
+  "current_iteration": $iteration,
+  "status": "$status",
+  "completion_promise": "$completion_promise",
+  "promise_seen": $promise_seen,
+  "last_exit_code": $exit_code,
+  "prompt_snapshot": "${prompt_snapshot#$ROOT_DIR/}",
+  "output_file": "${output_file#$ROOT_DIR/}",
+  "changed_files": $changed_files_json
+}
+EOF
+}
+
+snapshot_prompt() {
+  local destination="$1"
+  local story_payload="$2"
+  local iteration="$3"
+
+  cat "$prompt_file" >"$destination"
+  cat >>"$destination" <<EOF
+
+Loop control:
+- You are executing one iteration of a persistent Ralph loop runner.
+- Current iteration: $iteration / $max_iterations
+- Story id: $story_id
+- Completion promise token: <promise>$completion_promise</promise>
+- If and only if the requested story is actually complete and all validations pass in this iteration, print exactly:
+  <promise>$completion_promise</promise>
+- If the story is not complete, do not print the promise token.
+
+Current story payload:
+$(printf '%s\n' "$story_payload" | jq .)
+EOF
+}
+
+append_progress_monitor_line() {
+  local iteration="$1"
+  local status="$2"
+  local promise_seen="$3"
+  local exit_code="$4"
+  echo "$(date +%F) monitor iteration-$iteration story=$story_id status=$status promise=$promise_seen exit=$exit_code" >>"$PROGRESS_FILE"
+}
+
+main() {
+  require_file "$PRD_FILE"
+  require_file "$prompt_file"
+  require_file "$PROGRESS_FILE"
+
+  if [[ $# -gt 0 && "${1:-}" != --* ]]; then
+    story_id="$1"
+    shift
+  fi
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --story-id)
+        story_id="${2:-}"
+        shift 2
+        ;;
+      --max-iterations)
+        max_iterations="${2:-}"
+        shift 2
+        ;;
+      --completion-promise)
+        completion_promise="${2:-}"
+        shift 2
+        ;;
+      --prompt-file)
+        prompt_file="${2:-}"
+        shift 2
+        ;;
+      --run-label)
+        run_label="${2:-}"
+        shift 2
+        ;;
+      --sleep-seconds)
+        sleep_seconds="${2:-}"
+        shift 2
+        ;;
+      --dry-run)
+        dry_run=1
+        shift
+        ;;
+      -h|--help)
+        usage
+        exit 0
+        ;;
+      *)
+        echo "Unknown argument: $1" >&2
+        usage >&2
+        exit 2
+        ;;
+    esac
+  done
+
+  if ! [[ "$max_iterations" =~ ^[0-9]+$ ]] || [[ "$max_iterations" -lt 1 ]]; then
+    echo "--max-iterations must be a positive integer" >&2
+    exit 2
+  fi
+
+  if ! [[ "$sleep_seconds" =~ ^[0-9]+$ ]] || [[ "$sleep_seconds" -lt 0 ]]; then
+    echo "--sleep-seconds must be a non-negative integer" >&2
+    exit 2
+  fi
+
+  select_story
+
+  local story_payload
+  story_payload="$(load_story_payload)"
+  if [[ -z "$story_payload" ]]; then
+    echo "Story not found: $story_id" >&2
+    exit 1
+  fi
+
+  if [[ $dry_run -eq 0 ]] && ! command -v codex >/dev/null 2>&1; then
+    echo "codex command not found in PATH" >&2
+    exit 1
+  fi
+
+  mkdir -p "$RUNS_DIR"
+  local run_id
+  run_id="$(date +%Y%m%d-%H%M%S)"
+  if [[ -n "$run_label" ]]; then
+    run_id="$run_id-$run_label"
+  fi
+  local run_dir="$RUNS_DIR/$run_id-$story_id"
+  mkdir -p "$run_dir"
+
+  local iteration=1
+  local final_status="max_iterations_reached"
+  local promise_seen=false
+
+  while [[ "$iteration" -le "$max_iterations" ]]; do
+    story_payload="$(load_story_payload)"
+    if [[ -z "$story_payload" ]]; then
+      echo "Story disappeared from PRD: $story_id" >&2
+      final_status="story_missing"
+      break
+    fi
+
+    local prompt_snapshot="$run_dir/iteration-$iteration.prompt.md"
+    local output_file="$run_dir/iteration-$iteration.output.log"
+    local changed_files_file="$run_dir/iteration-$iteration.changed-files.txt"
+    local status_file="$run_dir/iteration-$iteration.status.json"
+
+    snapshot_prompt "$prompt_snapshot" "$story_payload" "$iteration"
+
+    echo "[ralph] iteration $iteration/$max_iterations story=$story_id"
+    echo "[ralph] prompt: ${prompt_snapshot#$ROOT_DIR/}"
+
+    local exit_code=0
+    if [[ $dry_run -eq 1 ]]; then
+      printf '[ralph] dry-run: codex exec skipped\n' | tee "$output_file" >/dev/null
+      final_status="dry_run"
+    else
+      set +e
+      codex exec -s danger-full-access -C "$ROOT_DIR" - <"$prompt_snapshot" | tee "$output_file"
+      exit_code=${PIPESTATUS[0]}
+      set -e
+    fi
+
+    git status --short >"$changed_files_file"
+    local changed_files_json
+    changed_files_json="$(
+      jq -R -s '
+        split("\n")
+        | map(select(length > 0))
+      ' "$changed_files_file"
+    )"
+
+    if rg -q "<promise>${completion_promise}</promise>" "$output_file"; then
+      promise_seen=true
+      final_status="completed"
+    elif [[ "$exit_code" -eq 0 ]]; then
+      final_status="iteration_pass_no_promise"
+    else
+      final_status="iteration_failed"
+    fi
+
+    write_state "$iteration" "$final_status" "$promise_seen" "$output_file" "$prompt_snapshot" "$exit_code" "$changed_files_json"
+    cat >"$status_file" <<EOF
+{
+  "iteration": $iteration,
+  "story_id": "$story_id",
+  "exit_code": $exit_code,
+  "status": "$final_status",
+  "promise_seen": $promise_seen,
+  "output_file": "${output_file#$ROOT_DIR/}",
+  "changed_files_file": "${changed_files_file#$ROOT_DIR/}"
+}
+EOF
+    append_progress_monitor_line "$iteration" "$final_status" "$promise_seen" "$exit_code"
+
+    echo "[ralph] status=$final_status exit=$exit_code promise=$promise_seen"
+    echo "[ralph] changed-files: ${changed_files_file#$ROOT_DIR/}"
+
+    if [[ "$promise_seen" == "true" ]]; then
+      break
+    fi
+
+    iteration=$((iteration + 1))
+    if [[ "$iteration" -le "$max_iterations" && "$sleep_seconds" -gt 0 ]]; then
+      sleep "$sleep_seconds"
+    fi
+  done
+
+  echo "[ralph] final_status=$final_status story=$story_id run_dir=${run_dir#$ROOT_DIR/}"
+
+  if [[ "$final_status" == "completed" || "$final_status" == "dry_run" ]]; then
+    exit 0
+  fi
+
+  exit 1
+}
+
+main "$@"

package/.agent/runs/README.md

@@ -0,0 +1,7 @@
+# Ralph Runs
+
+이 디렉터리는 Ralph loop run artifact를 보관하는 작업용 경로다.
+
+- commit 대상은 아니다.
+- canonical scaffold는 디렉터리 구조와 file naming만 제공한다.
+- 실제 run 산출물은 `.gitignore`로 제외한다.

package/.agent/sdd-build-ast-audit.json

@@ -0,0 +1,13 @@
+{
+  "scores": {
+    "ast_similarity": 10,
+    "implementation_traceability": 10,
+    "human_agent_readability": 10
+  },
+  "all_ten": true,
+  "findings": {
+    "ast_similarity": [],
+    "implementation_traceability": [],
+    "human_agent_readability": []
+  }
+}

package/.claude/CLAUDE.md

@@ -0,0 +1,44 @@
+# CLAUDE.md
+
+## What This Is
+
+범용 웹 제품 템플릿에서 Claude/Codex 실행 규칙과 자동화 하네스 위치를 설명하는 문서다.
+
+## Environment Naming Policy
+
+- 문서/대화/로그에서 실행 환경은 항상 `DEV(개발계)`로 표기한다.
+- `local`, `localhost 환경` 같은 표현은 운영 용어로 사용하지 않는다.
+
+## Harness Layout
+
+```text
+templates/
+├── .agent/          # Ralph loop harness, PRD scaffold, run state
+├── .claude/         # Claude 설정
+│   ├── agents/      # Claude role agents
+│   └── skills/      # Claude Code repo-local skills (.claude/skills/<name>/SKILL.md)
+├── .codex/          # Codex 설정, 에이전트, 스킬
+├── client/
+│   ├── platform/    # 일반 앱 템플릿
+│   ├── admin/       # 어드민 템플릿
+│   ├── mobile/      # 현장형 모바일 템플릿
+│   └── landing/     # 랜딩 템플릿
+├── server/          # HTTP 서버 템플릿
+└── sdd/             # toolchain 정책/자동화 문서
+```
+
+## Working Rules
+
+- 컨벤션과 실행 규칙의 정본은 `sdd/99_toolchain/02_policies`에 둔다.
+- DEV 반영이 필요한 작업은 항상 `main push -> DEV 배포 -> DEV 검증` 순서를 따른다.
+- 템플릿은 특정 서비스/도메인/실환경에 종속된 문자열, URL, 자격증명, 브라우저 상태를 포함하지 않는다.
+- 브라우저 자동화 예시는 generic 흐름만 제공하고, 실제 실행 산출물이나 프로필 데이터는 저장하지 않는다.
+- `sdd/03_build`는 runtime assembly를 설명하는 current-state 문서이며 dated execution narrative를 남기지 않는다.
+- AST-style build current-state 적합성은 `scripts/dev/audit_sdd_build_ast.py`로 검증한다.
+
+## Claude Skills
+
+- Claude Code 최신 project skill 표면은 `.claude/skills/<name>/SKILL.md`다.
+- Claude Code의 custom commands와 skills는 merge된 표면으로 취급한다. 이 템플릿은 공식 skills 디렉터리 구조를 기본값으로 쓴다.
+- Codex와 Claude가 같은 실행 하네스를 공유해야 할 때는 `.codex/skills/*`의 정본 스크립트와 계약을 재사용하고, Claude skill은 그 진입 규칙과 운영 가이드를 얇게 감싼다.
+- 기본 제공 표면은 `otro`, `planning-with-files`, `ralph-loop`, `commit`, `dev-browser`, `prd`, `sdd`, `sdd-development`다.

package/.claude/agentic-dev.json

@@ -0,0 +1,3 @@
+{
+  "contract_path": "../sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json"
+}