modify template

Coding/Codex-tsjs/.codex/config.toml

@@ -0,0 +1,4 @@
+#:schema https://developers.openai.com/codex/config-schema.json
+
+[features]
+codex_hooks = true

Coding/Codex-tsjs/.codex/hooks.json

@@ -0,0 +1,28 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "^Bash$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python -c \"import pathlib, runpy, subprocess; root = pathlib.Path(subprocess.check_output(['git', 'rev-parse', '--show-toplevel'], text=True).strip()); runpy.run_path(str(root / '.codex' / 'hooks' / 'pre_commit_checks.py'), run_name='__main__')\"",
+            "timeout": 600,
+            "statusMessage": "Running pre-commit checks"
+          }
+        ]
+      },
+      {
+        "matcher": "^(apply_patch|Edit|Write)$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python -c \"import pathlib, runpy, subprocess; root = pathlib.Path(subprocess.check_output(['git', 'rev-parse', '--show-toplevel'], text=True).strip()); runpy.run_path(str(root / '.codex' / 'hooks' / 'tdd-guard.py'), run_name='__main__')\"",
+            "timeout": 30,
+            "statusMessage": "Checking TDD guard"
+          }
+        ]
+      }
+    ]
+  }
+}

Coding/Codex-tsjs/.codex/hooks/pre_commit_checks.py

@@ -0,0 +1,111 @@
+import json
+import re
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+CHECKS = ("lint", "build", "test")
+
+
+def _repo_root(cwd: Path) -> Path:
+    try:
+        root = subprocess.check_output(
+            ["git", "rev-parse", "--show-toplevel"],
+            cwd=cwd,
+            text=True,
+            stderr=subprocess.DEVNULL,
+        ).strip()
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return cwd
+    return Path(root)
+
+
+def _load_scripts(root: Path) -> dict[str, str]:
+    package_json = root / "package.json"
+    if not package_json.exists():
+        return {}
+
+    try:
+        package = json.loads(package_json.read_text(encoding="utf-8"))
+    except json.JSONDecodeError as exc:
+        _deny(f"Invalid package.json: {exc}")
+        raise SystemExit(0) from exc
+
+    scripts = package.get("scripts", {})
+    if not isinstance(scripts, dict):
+        return {}
+    return {str(name): str(command) for name, command in scripts.items()}
+
+
+def _is_git_commit(command: str) -> bool:
+    return re.search(r"\bgit(?:\s+(?:-[A-Za-z]\s+\S+|--[A-Za-z0-9-]+(?:=\S+)?))*\s+commit\b", command) is not None
+
+
+def _deny(reason: str) -> None:
+    print(
+        json.dumps(
+            {
+                "hookSpecificOutput": {
+                    "hookEventName": "PreToolUse",
+                    "permissionDecision": "deny",
+                    "permissionDecisionReason": reason,
+                }
+            }
+        )
+    )
+
+
+def _tail(text: str, limit: int = 1200) -> str:
+    text = text.strip()
+    if len(text) <= limit:
+        return text
+    return text[-limit:]
+
+
+def _run_checks(root: Path, scripts: dict[str, str]) -> str | None:
+    npm = shutil.which("npm") or shutil.which("npm.cmd")
+    if npm is None:
+        return "npm was not found, so pre-commit checks could not run."
+
+    for check in CHECKS:
+        if check not in scripts:
+            continue
+        result = subprocess.run(
+            [npm, "run", check],
+            cwd=root,
+            capture_output=True,
+            text=True,
+        )
+
+        if result.returncode != 0:
+            details = _tail(result.stdout + "\n" + result.stderr)
+            if details:
+                return f"npm run {check} failed:\n{details}"
+            return f"npm run {check} failed with exit code {result.returncode}."
+
+    return None
+
+
+def main() -> int:
+    try:
+        payload = json.load(sys.stdin)
+    except json.JSONDecodeError:
+        return 0
+
+    command = payload.get("tool_input", {}).get("command", "")
+    if not isinstance(command, str) or not _is_git_commit(command):
+        return 0
+
+    cwd = Path(payload.get("cwd") or Path.cwd())
+    root = _repo_root(cwd)
+    failure = _run_checks(root, _load_scripts(root))
+    if failure:
+        _deny(f"PRE-COMMIT CHECKS: {failure}")
+
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

Coding/Codex-tsjs/.codex/hooks/tdd-guard.py

@@ -0,0 +1,189 @@
+import json
+import subprocess
+import sys
+from pathlib import Path
+
+
+SOURCE_SUFFIXES = {".ts", ".tsx", ".js", ".jsx"}
+TEST_SUFFIXES = ("ts", "tsx", "js", "jsx")
+CONFIG_SUFFIXES = {".json", ".css", ".scss", ".md", ".yml", ".yaml"}
+NEXT_SPECIAL_FILES = {
+    "layout.ts",
+    "layout.tsx",
+    "page.ts",
+    "page.tsx",
+    "loading.tsx",
+    "error.tsx",
+    "not-found.tsx",
+    "globals.css",
+}
+
+
+def _repo_root(cwd: Path) -> Path:
+    try:
+        root = subprocess.check_output(
+            ["git", "rev-parse", "--show-toplevel"],
+            cwd=cwd,
+            text=True,
+            stderr=subprocess.DEVNULL,
+        ).strip()
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return cwd
+    return Path(root)
+
+
+def _extract_patch_paths(command: str) -> list[str]:
+    prefixes = (
+        "*** Add File: ",
+        "*** Update File: ",
+        "*** Delete File: ",
+        "*** Move to: ",
+    )
+    paths: list[str] = []
+    for raw_line in command.splitlines():
+        line = raw_line.strip()
+        for prefix in prefixes:
+            if line.startswith(prefix):
+                paths.append(line[len(prefix) :].strip())
+                break
+    return paths
+
+
+def _touched_paths(payload: dict) -> list[str]:
+    tool_input = payload.get("tool_input", {})
+    if not isinstance(tool_input, dict):
+        return []
+
+    file_path = tool_input.get("file_path")
+    if isinstance(file_path, str) and file_path:
+        return [file_path]
+
+    command = tool_input.get("command")
+    if isinstance(command, str):
+        return _extract_patch_paths(command)
+
+    return []
+
+
+def _normalize(path_text: str) -> str:
+    return path_text.replace("\\", "/").lower()
+
+
+def _is_test_path(path_text: str) -> bool:
+    normalized = _normalize(path_text)
+    name = normalized.rsplit("/", 1)[-1]
+    return (
+        "__tests__/" in normalized
+        or ".test." in name
+        or ".spec." in name
+        or "test" in name
+        or "spec" in name
+    )
+
+
+def _is_exempt(path_text: str) -> bool:
+    normalized = _normalize(path_text)
+    path = Path(path_text)
+    name = path.name.lower()
+
+    if _is_test_path(path_text):
+        return True
+    if name in NEXT_SPECIAL_FILES:
+        return True
+    if path.suffix.lower() in CONFIG_SUFFIXES:
+        return True
+    if ".env" in name or ".config." in name:
+        return True
+    if any(token in name for token in ("tailwind", "postcss", "next.config", "tsconfig")):
+        return True
+    if "/types/" in normalized or name in {"types.ts", "types.d.ts"}:
+        return True
+
+    return False
+
+
+def _resolve_path(path_text: str, cwd: Path) -> Path:
+    path = Path(path_text)
+    if path.is_absolute():
+        return path
+    return (cwd / path).resolve()
+
+
+def _base_name(path: Path) -> str:
+    for suffix in (".tsx", ".ts", ".jsx", ".js"):
+        if path.name.endswith(suffix):
+            return path.name[: -len(suffix)]
+    return path.stem
+
+
+def _has_existing_test(path: Path, root: Path) -> bool:
+    directory = path.parent
+    parent = directory.parent
+    base = _base_name(path)
+
+    for ext in TEST_SUFFIXES:
+        if (directory / f"{base}.test.{ext}").exists():
+            return True
+        if (directory / f"{base}.spec.{ext}").exists():
+            return True
+
+    for ext in TEST_SUFFIXES:
+        if (parent / "__tests__" / f"{base}.test.{ext}").exists():
+            return True
+        if (directory / "__tests__" / f"{base}.test.{ext}").exists():
+            return True
+
+    for ext in TEST_SUFFIXES:
+        if (root / "src" / "__tests__" / f"{base}.test.{ext}").exists():
+            return True
+
+    return False
+
+
+def _guarded_paths(paths: list[str], cwd: Path, root: Path) -> list[str]:
+    missing_tests: list[str] = []
+    for path_text in paths:
+        if _is_exempt(path_text):
+            continue
+
+        path = _resolve_path(path_text, cwd)
+        if path.suffix.lower() not in SOURCE_SUFFIXES:
+            continue
+        if not _has_existing_test(path, root):
+            missing_tests.append(_base_name(path))
+
+    return missing_tests
+
+
+def main() -> int:
+    try:
+        payload = json.load(sys.stdin)
+    except json.JSONDecodeError:
+        return 0
+
+    cwd = Path(payload.get("cwd") or Path.cwd())
+    root = _repo_root(cwd)
+    missing_tests = _guarded_paths(_touched_paths(payload), cwd, root)
+    if not missing_tests:
+        return 0
+
+    names = ", ".join(sorted(set(missing_tests)))
+    print(
+        json.dumps(
+            {
+                "hookSpecificOutput": {
+                    "hookEventName": "PreToolUse",
+                    "permissionDecision": "deny",
+                    "permissionDecisionReason": (
+                        "TDD GUARD: missing test file for "
+                        f"{names}. Write or add the test first."
+                    ),
+                }
+            }
+        )
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

Coding/Codex-tsjs/.codex/skills/harness-review/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: harness-review
+description: Use when reviewing this Harness repository: local changes, generated phase files, step outputs, implementation diffs, missing tests, build readiness, or compliance with AGENTS.md, docs/ARCHITECTURE.md, docs/ADR.md, and Harness acceptance criteria.
+---
+
+# Harness Review
+
+## Overview
+
+Use this skill to review Harness work against the repository's persistent rules, architecture docs, and executable verification requirements. Prioritize bugs, regressions, missing tests, and rule violations.
+
+## Review Process
+
+1. Read `/AGENTS.md`, `/docs/ARCHITECTURE.md`, and `/docs/ADR.md`.
+2. Inspect the changed files with `git status --short` and `git diff`.
+3. Check architecture, stack choices, tests, critical rules, and build readiness.
+4. Run relevant verification commands when feasible. If a command cannot be run, report that as residual risk.
+5. Lead with actionable findings. Keep summaries secondary.
+
+## Checklist
+
+| Item | Question |
+| --- | --- |
+| Architecture | Does the change follow `docs/ARCHITECTURE.md` directory and module boundaries? |
+| Stack | Does the change stay within choices documented in `docs/ADR.md`? |
+| Tests | Are new or changed behaviors covered by tests? |
+| Critical Rules | Does the change violate any `AGENTS.md` CRITICAL rule? |
+| Build | Do relevant build/test/lint commands pass? |
+
+## Output Format
+
+If there are findings, list them first in severity order with file and line references when possible. Then include this table:
+
+| 항목 | 결과 | 비고 |
+| --- | --- | --- |
+| 아키텍처 준수 | PASS/FAIL | {상세} |
+| 기술 스택 준수 | PASS/FAIL | {상세} |
+| 테스트 존재 | PASS/FAIL | {상세} |
+| CRITICAL 규칙 | PASS/FAIL | {상세} |
+| 빌드 가능 | PASS/FAIL | {상세} |
+
+When there are no findings, say that clearly, then mention any commands not run or remaining risk.

Coding/Codex-tsjs/.codex/skills/harness-review/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Harness Review"
+  short_description: "Review Harness changes safely"
+  default_prompt: "Use $harness-review to review Harness repository changes."

Coding/Codex-tsjs/.codex/skills/harness-workflow/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: harness-workflow
+description: Use when planning or running this Harness framework: reading AGENTS.md and docs/*.md, discussing implementation scope, creating or updating phases/index.json, phases/{task}/index.json, phases/{task}/stepN.md, or invoking scripts/execute.py for staged Codex execution.
+---
+
+# Harness Workflow
+
+## Overview
+
+Use this skill to turn a user-approved task into small, self-contained Harness steps that another Codex session can execute reliably. Keep the workflow grounded in repository docs and executable acceptance criteria.
+
+## Workflow
+
+1. Read `AGENTS.md` and relevant files under `docs/`, especially `docs/PRD.md`, `docs/ARCHITECTURE.md`, and `docs/ADR.md`.
+2. Discuss unresolved product or technical decisions with the user before writing phase files.
+3. When the user asks for an implementation plan, draft steps and get approval before creating files.
+4. Create or update `phases/index.json`, `phases/{task-name}/index.json`, and one `phases/{task-name}/stepN.md` per step.
+5. Run the phase with `python scripts/execute.py {task-name}` when asked to execute it. Use `--push` only when the user asks to push.
+
+## Step Design Rules
+
+- Scope each step to one layer or module. Split steps when multiple modules would otherwise change together.
+- Make every step self-contained. Do not rely on prior conversation; include all required context and file paths.
+- Force context gathering. Each step must tell Codex which docs and previous outputs to read before editing.
+- Specify interfaces and signatures, not full implementations, unless exact code is required for a constraint.
+- Put core invariants directly in the step: idempotency, security, data integrity, API contracts, or other non-negotiables.
+- Use executable acceptance criteria such as `npm run build && npm test`, not abstract statements.
+- Write cautions concretely: "Do not do X. Reason: Y."
+- Name steps with kebab-case slugs such as `project-setup`, `api-layer`, or `auth-flow`.
+
+## Phase Files
+
+Create or update `phases/index.json`:
+
+```json
+{
+  "phases": [
+    {
+      "dir": "0-mvp",
+      "status": "pending"
+    }
+  ]
+}
+```
+
+Create `phases/{task-name}/index.json`:
+
+```json
+{
+  "project": "<project-name>",
+  "phase": "<task-name>",
+  "steps": [
+    { "step": 0, "name": "project-setup", "status": "pending" },
+    { "step": 1, "name": "core-types", "status": "pending" },
+    { "step": 2, "name": "api-layer", "status": "pending" }
+  ]
+}
+```
+
+Rules:
+
+- `project` comes from `AGENTS.md`.
+- `phase` matches the task directory name.
+- `steps[].step` starts at `0`.
+- Initial status is always `pending`.
+- Do not add timestamps when creating files. `scripts/execute.py` records `created_at`, `started_at`, `completed_at`, `failed_at`, and `blocked_at`.
+
+## Step Template
+
+```markdown
+# Step {N}: {name}
+
+## 읽어야 할 파일
+
+먼저 아래 파일들을 읽고 프로젝트의 아키텍처와 설계 의도를 파악하라:
+
+- `/AGENTS.md`
+- `/docs/ARCHITECTURE.md`
+- `/docs/ADR.md`
+- {previously created or modified files}
+
+이전 step에서 만들어진 코드를 꼼꼼히 읽고, 설계 의도를 이해한 뒤 작업하라.
+
+## 작업
+
+{Concrete instructions with file paths, interfaces, signatures, and rules.}
+
+## Acceptance Criteria
+
+```bash
+npm run build
+npm test
+```
+
+## 검증 절차
+
+1. 위 AC 커맨드를 실행한다.
+2. 아키텍처 체크리스트를 확인한다:
+   - ARCHITECTURE.md 디렉토리 구조를 따르는가?
+   - ADR 기술 스택을 벗어나지 않았는가?
+   - AGENTS.md CRITICAL 규칙을 위반하지 않았는가?
+3. 결과에 따라 `phases/{task-name}/index.json`의 해당 step을 업데이트한다:
+   - 성공: `"status": "completed"`, `"summary": "산출물 한 줄 요약"`
+   - 3회 수정 시도 후 실패: `"status": "error"`, `"error_message": "구체적 에러 내용"`
+   - 사용자 개입 필요: `"status": "blocked"`, `"blocked_reason": "구체적 사유"` 후 중단
+
+## 금지사항
+
+- {Do not do X. Reason: Y.}
+- 기존 테스트를 깨뜨리지 마라.
+```
+
+## Execution And Recovery
+
+Run:
+
+```bash
+python scripts/execute.py {task-name}
+python scripts/execute.py {task-name} --push
+```
+
+`scripts/execute.py` creates or checks out `feat-{task-name}`, injects `AGENTS.md` and `docs/*.md` into each prompt, carries completed step summaries forward, retries failed steps up to three times, separates code and metadata commits, and records timestamps.
+
+If a step is `error`, set it back to `pending` and remove `error_message` after fixing the cause. If a step is `blocked`, resolve `blocked_reason`, set it back to `pending`, remove `blocked_reason`, and rerun.

Coding/Codex-tsjs/.codex/skills/harness-workflow/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Harness Workflow"
+  short_description: "Plan staged Harness workflow steps"
+  default_prompt: "Use $harness-workflow to plan Harness phases and step files."