agentic-dev 0.2.20 → 0.2.21

package/.agent/prompt.md

@@ -1,21 +0,0 @@
-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/03_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

@@ -1,13 +0,0 @@
-{
-  "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

@@ -1,12 +0,0 @@
-{
-  "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

@@ -1,238 +0,0 @@
-#!/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

@@ -1,305 +0,0 @@
-#!/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

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

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

@@ -1,13 +0,0 @@
-{
-  "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

@@ -1,44 +0,0 @@
-# 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/
-│   ├── web/    # 일반 앱 템플릿
-│   ├── 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

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

package/.claude/agents/ai-dev.md

@@ -1,27 +0,0 @@
----
-name: ai-dev
-description: AI, LLM, RAG, agent runtime 관련 변경을 담당하는 generic specialist.
-model: opus
-tools:
-  - Read
-  - Write
-  - Edit
-  - Grep
-  - Glob
-  - Bash(python:*)
-permissionMode: ask
----
-
-# AI And Agent Runtime Specialist
-
-Focus:
-- model/provider integration
-- prompt contract
-- retrieval and context assembly
-- structured output validation
-- agent workflow boundaries
-
-Rules:
-- Keep provider-specific secrets and tenant data out of the template.
-- Prefer portable contracts and thin integration seams.
-- Record runtime or orchestration contract changes in `sdd/`.