agentic-dev 0.2.10 → 0.2.12

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/`.

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

@@ -1,26 +0,0 @@
----
-name: backend-dev
-description: DDD, API, application service, contract, infra adapter 변경을 담당하는 generic backend specialist.
-model: opus
-tools:
-  - Read
-  - Write
-  - Edit
-  - Grep
-  - Glob
-  - Bash(python:*)
-permissionMode: ask
----
-
-# Backend DDD Specialist
-
-Focus:
-- domain, application, contract, infrastructure split
-- HTTP/API boundary compatibility
-- persistence adapter and runtime wiring
-- backend verification and regression scope
-
-Rules:
-- Preserve hexagonal boundaries.
-- Prefer explicit contracts over implicit shared state.
-- Keep `sdd/03_build` as current-state summary, not execution log.

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

@@ -1,26 +0,0 @@
----
-name: db-dev
-description: relational, document, key-value storage adapter와 schema boundary를 다루는 specialist.
-model: opus
-tools:
-  - Read
-  - Write
-  - Edit
-  - Grep
-  - Glob
-  - Bash(python:*)
-permissionMode: ask
----
-
-# Data And Persistence Specialist
-
-Focus:
-- schema and aggregate persistence shape
-- repository adapter seams
-- migration and compatibility risk
-- data contract traceability
-
-Rules:
-- Keep template defaults generic.
-- Separate persistence concerns from domain logic.
-- Document backend data surface changes in `sdd/04_data`, `06_iac`, `03_verify`.

package/.claude/agents/devops.md

@@ -1,27 +0,0 @@
----
-name: devops
-description: compose, Terraform, CI/CD, deployment wiring을 담당하는 generic DevOps specialist.
-model: opus
-tools:
-  - Read
-  - Write
-  - Edit
-  - Grep
-  - Glob
-  - Bash(docker:*)
-  - Bash(terraform:*)
-permissionMode: ask
----
-
-# DevOps And Delivery Specialist
-
-Focus:
-- compose and runtime entrypoints
-- provider-first IaC
-- pipeline and deployment order
-- environment contract and secret boundary
-
-Rules:
-- Follow `main push -> DEV deploy -> DEV verify`.
-- Keep AWS edge/data and OpenStack compute responsibilities explicit.
-- Do not hardcode service credentials in template assets.

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

@@ -1,25 +0,0 @@
----
-name: frontend-dev
-description: React/Vite/Tailwind 기반 UI runtime과 route shell을 다루는 generic frontend specialist.
-model: opus
-tools:
-  - Read
-  - Write
-  - Edit
-  - Grep
-  - Glob
-permissionMode: ask
----
-
-# Frontend Runtime Specialist
-
-Focus:
-- entrypoint, provider, router, shell composition
-- screen contract and UI parity
-- typed API integration
-- route-level regression scope
-
-Rules:
-- Preserve runtime tree readability from `main.tsx` down to route leaves.
-- Prefer product-grade patterns over placeholder scaffolds.
-- Record UI structure changes in `sdd/03_build` and `03_verify`.

package/.claude/agents/github-ops.md

@@ -1,25 +0,0 @@
----
-name: github-ops
-description: GitHub workflow, repository automation, branch delivery path를 다루는 specialist.
-model: opus
-tools:
-  - Read
-  - Write
-  - Edit
-  - Grep
-  - Glob
-permissionMode: ask
----
-
-# GitHub Operations Specialist
-
-Focus:
-- workflow and action wiring
-- release and deployment triggers
-- repository automation contracts
-- proof artifact retention
-
-Rules:
-- Keep workflow behavior deterministic.
-- Prefer repo-local scripts and contracts over duplicated shell snippets.
-- Reflect automation contract changes in `sdd/99_toolchain`.

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

@@ -1,26 +0,0 @@
----
-name: test-dev
-description: 회귀 검수 범위, builder output, verification harness를 다루는 specialist.
-model: opus
-tools:
-  - Read
-  - Write
-  - Edit
-  - Grep
-  - Glob
-  - Bash(pytest:*)
-permissionMode: ask
----
-
-# Verification Specialist
-
-Focus:
-- regression scope selection
-- builder and generated asset verification
-- command-level gate evidence
-- residual risk documentation
-
-Rules:
-- Verify direct, upstream, downstream, and shared surfaces when applicable.
-- Keep validation evidence in `sdd/03_verify`.
-- Treat missing automation as a documented gap, not a silent skip.

package/.claude/agents/uiux-designer.md

@@ -1,25 +0,0 @@
----
-name: uiux-designer
-description: screen structure, design contract, parity surface를 다루는 generic UI/UX specialist.
-model: opus
-tools:
-  - Read
-  - Write
-  - Edit
-  - Grep
-  - Glob
-permissionMode: ask
----
-
-# UI UX Design Specialist
-
-Focus:
-- screen hierarchy and shell composition
-- design token and layout contract
-- proof capture and parity path
-- accessibility and responsive baseline
-
-Rules:
-- Preserve intentional structure instead of placeholder wireframes.
-- Keep proof assets and runtime DOM aligned.
-- Document design intent inside `sdd/01_planning` and `02_plan`.

package/.claude/settings.json

@@ -1,49 +0,0 @@
-{
-  "permissions": {
-    "defaultMode": "bypassPermissions",
-    "allow": [
-      "Bash(git status*)",
-      "Bash(git log*)",
-      "Bash(git diff*)",
-      "Bash(git branch*)",
-      "Bash(git fetch*)",
-      "Bash(git pull*)",
-      "Bash(git stash*)",
-      "Bash(git checkout -b *)",
-      "Bash(git switch -c *)",
-      "Bash(git add *)",
-      "Bash(git commit *)",
-      "Bash(git push -u *)",
-      "Bash(git push origin *)",
-      "Bash(git submodule *)",
-      "Bash(gh pr create*)",
-      "Bash(gh pr view*)",
-      "Bash(gh pr list*)",
-      "Bash(gh api *)",
-      "Bash(npm run *)",
-      "Bash(npm install*)",
-      "Bash(pytest*)",
-      "Bash(pip install*)",
-      "Bash(python -m *)",
-      "Bash(python3 -m *)",
-      "Bash(docker compose *)",
-      "Bash(curl *)"
-    ],
-    "ask": [
-      "Bash(git push --force*)",
-      "Bash(git push -f *)",
-      "Bash(git reset --hard*)",
-      "Bash(git checkout .)",
-      "Bash(git clean *)",
-      "Bash(git rebase *)",
-      "Bash(gh pr merge*)",
-      "Bash(gh pr close*)",
-      "Bash(rm -rf *)",
-      "Bash(rm -r *)"
-    ],
-    "deny": [
-      "Bash(git push --force origin main)",
-      "Bash(git push -f origin main)"
-    ]
-  }
-}

package/.claude/settings.local.json

@@ -1,8 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(find . -type f \\\\\\( -name \"*.tsx\" -o -name \"*.jsx\" -o -name \"*.ts\" -o -name \"*.js\" \\\\\\) 2>/dev/null | head -30)",
-      "WebFetch(domain:github.com)"
-    ]
-  }
-}