docs: clarify lightweight harness verification and feature resumption

This commit is contained in:
KOKO\Mimi
2026-09-08 01:15:45 +09:00
parent 2395b0575e
commit 7f70cb2aa7
4 changed files with 218 additions and 0 deletions
+4
View File
@@ -55,6 +55,7 @@
- 현재 checklist는 PRD 한 곳에 둔다. `requirements.md`·검증 matrix는 분리가 필요할 때만 작성하고 PRD에는 요약·링크만 유지한다. Specialist는 할당된 전문 문서만 수정한다.
- `FEATURED_AGENTS.md`는 자동 로드되는 `AGENTS.md`가 아니다. 메인은 필요한 Feature context와 관련 경로·절만 인계하며 모든 문서를 매번 재독하도록 요구하지 않는다.
- 기존 `coordination.md`, `docs/features/<feature-id>/`와 phase 자료는 이력으로 보존하고 필요한 경로·계약 revision을 참조한다. 자동 이동·복제하거나 신규 coordination 상태 파일을 만들지 않는다.
- 기존 Feature 재개 시 운영 절차와 승인된 요구사항을 구분하여 [ADR-028](docs/ADR.md#adr-028)을 적용한다. 현재 할 일과 근거 링크만 Feature PRD의 checklist에 정리한다.
- 보고서는 결정·결과, 적용 계약, evidence와 미해결 항목을 간결하게 기록한다. 간단한 구현·build/test·reference 결과는 한 보고서로 모으고 긴 유도·schema는 같은 폴더의 상세 문서로 분리해 연결한다.
- 실제 계약 변경은 관련 evidence의 유효성을 다시 확인한다. 의미 변화 없는 문서 편집마다 고정 handoff·hash·gate 기록을 만들지 않는다. 미실행 검사는 이유를 남기며 승인·통과로 표시하지 않는다.
- 소스·테스트·기계 생성 로그/결과·read-only reference artifact는 지정 경로에 유지하고 보고서에서 참조한다.
@@ -157,6 +158,9 @@ Harness 구현 변경에 필요한 검사는 관련 범위부터 실행하며
uv run --with pytest python -B -m pytest -v -rs
```
이 Python suite는 Harness 구현을 검증한다. 현재 CMake/CTest 구성은 이를 실행하지 않으므로
`python scripts/execute.py`의 성공을 Python 회귀 검사 통과로 보고하지 않는다.
### 구성된 전체 build/test
```powershell
+6
View File
@@ -379,6 +379,12 @@ Agent·Harness 경량화 결정을 공통 운영 문서에 반영한다. 솔버
연결하고 간단한 구현·build/test·reference evidence는 하나의 보고서에 기록한다.
Release-readiness 감사는 사용자가 명시적으로 요청할 때만 수행한다.
기존 Feature를 재개할 때 삭제된 profile·phase 실행 절차에는 이 결정을 적용하고,
승인된 제품 범위·수치 계약·필수 검증과 명시 요청된 감사는 해당 Feature 계약으로 유지한다.
메인은 남은 작업과 기존 근거 링크만 Feature PRD의 현재 checklist에 정리한다.
과거 coordination·phase·실패 기록을 재작성하거나 새 runner 입력으로 변환하지 않는다.
운영 전환만으로 기존 evidence가 새로 검증되었거나 실제 blocker가 해결되었다고 표시하지 않는다.
이 결정은 ADR-012·024~027의 위에 표시한 운영 부분을 대체한다. Config·preset·실행
command는 검토해야 할 실행 입력이며 `shell=False`나 경로 검사가 그 side effect를
sandbox처럼 격리하지는 않는다. 사용자 변경·reference를 보존하고 미실행·실패·stale
+5
View File
@@ -223,6 +223,11 @@ Architecture 문서의 그림이나 모듈명이 기능의 완료 증거를 대
| Harness runner | 명시 호출 시 config·project·toolchain 선택, adapter 계획 실행과 결과 반환 |
| Backend adapter/process | CMake/CTest 또는 MSBuild 명령 구성, argv/cwd·timeout·실패·결과 검사 |
구성된 solver build/test와 Harness 구현의 Python 회귀 검증은 별도 범위다.
현재 CMake adapter와 CTest 등록은 Harness Python suite를 실행하지 않는다.
Harness 동작 변경의 Python 검사는 구현 담당자가 변경 영향에 맞게 별도로 수행하며,
Runner 성공을 미실행한 Python 검사나 reference 비교의 통과로 확장하지 않는다.
Runner는 내부 LLM, phase 상태기계, 자동 Git·retry, 파일명 TDD gate나 대화 종료 hook을
사용하지 않는다. 과거 phase/coordination 기록은 이력으로 보존한다. 일반 실패는 현재
구현 owner가 수정하며 새 근거나 변경 없이 같은 명령·agent 호출을 반복하지 않는다.
@@ -0,0 +1,203 @@
# Agent·Harness 경량화 문서 정합성 분석 및 보완 계획
> **For agentic workers:** 후속 문서 반영에는 `superpowers:executing-plans`를 적용한다. 메인이 직접 수행하며 task별 agent·reviewer 호출, solver stage 순회, 자동 commit을 추가하지 않는다.
**Goal:** 경량화된 실제 운영과 네 공통 문서의 일치 여부를 확인하고, 기존 작업 재개와 검증 범위를 오해할 수 있는 부분만 보완한다.
**Architecture:** 현재 profile·skill·runner를 공통 문서와 대조한다. 운영 정책의 원본은 ADR, 실행 책임은 ARCHITECTURE, 행동 지침은 AGENTS에 두며 제품·수치 acceptance는 PRD에 유지한다.
**Tech Stack:** 한국어 Markdown, Git·파일·소스 정적 검토. 설명 대상은 Python Harness와 MSVC x64 Debug CMake/CTest이다.
**Spec:** 2026-09-08 사용자 요청(네 문서 분석 및 보완 계획), [ADR-028](../../ADR.md#adr-028), [직전 갱신 계획](2026-09-07-agent-harness-documentation-update.md).
작성 기준: `2395b05`와 현재 worktree. 상태: **계획안 — 대상 문서 변경·구현·테스트 실행 미승인/미실행**. 이번 요청은 이 분석·계획 파일 작성까지이며 후속 실행을 뜻하지 않는다. 직전 계획의 분석은 변경 전 기준이므로 현재 평가로 재사용하지 않는다.
## Global Constraints
- 이번 산출물은 이 파일 하나다. 기존 미커밋 문서·phase 변경 16개를 보존한다.
- 후속 문서 반영 범위는 `AGENTS.md`, `docs/ADR.md`, `docs/ARCHITECTURE.md`다. `docs/PRD.md`는 검토 후 유지한다.
- `.agents`, `.codex`, `scripts`, `tests`, config, 기존 Feature·phase·hook 이력은 이 문서 보완 작업에서 수정하지 않는다.
- FESA의 MSVC x64 Debug CMake/CTest, Abaqus 입력 subset, HDF5 결과, source identity, tolerance, 결정론과 state/output 보존 계약은 유지한다.
- 기존 사용자 요구와 Feature별 필수 검증·명시 요청된 감사는 운영 경량화만으로 취소하지 않는다.
- 문서 작업은 정적 검토로 확인한다. pytest, Harness, CMake/CTest, 수동 hook, 외부 solver를 실행하지 않는다.
- 계획·과거 기록을 일괄 수정하거나 승인·통과·현재 evidence로 소급 표시하지 않는다. Commit/push는 이 계획의 작업에 포함하지 않는다.
## 1. 분석 결론
**네 문서는 전반적으로 현재 변경에 적합하다. 전면 개정이나 추가 agent 제거는 필요하지 않다.**
| 대상 | 판정 | 확인 근거와 최소 조치 |
| --- | --- | --- |
| [AGENTS.md](../../../AGENTS.md) | 적합, 재개·검증 안내 보완 | 7개 specialist의 조건부 호출, medium/high, 인자 없는 runner, hook/자동 Git 제거, 문서 정적 검토를 반영했다. 기존 작업 재개의 운영/계약 구분과 Python 검사 범위를 짧게 보완한다. |
| [docs/ADR.md](../../ADR.md) | 적합, ADR-028 해석 보완 | ADR-012·024~027에 대체 안내가 있고 머리말도 옛 본문을 이력으로 명시한다. ADR-028에 기존 Feature 재개 시 유지할 승인 요구와 폐기된 실행 방식의 관계만 설명한다. |
| [docs/ARCHITECTURE.md](../../ARCHITECTURE.md) | 적합, 검증 책임 보완 | Runtime/운영 분리와 main/specialist/runner/adapter 책임이 현재 코드에 맞는다. 구성된 CTest와 Harness 자체 Python 회귀 검사의 범위를 명시한다. |
| [docs/PRD.md](../../PRD.md) | 적합, 수정 불필요 | GEN-010·011·012, 조건부 전문 작업, 필요한 독립 numerical review, 기능 완료 시 전체 검증, 요청된 release 감사가 현행 지침과 일치한다. CLI·timeout·테스트 파일 현황을 제품 PRD에 추가하지 않는다. |
### 확인된 일치 사항
- `.codex/agents/*.toml`은 7개다. 일반 역할은 `medium`, formulation/numerical/physics는 `high`다. Implementation profile의 모델은 `gpt-5.6-terra`다.
- `.codex/config.toml`, `.codex/hooks.json`, `scripts/hooks/pre_tool_use.py`, `scripts/hooks/stop_validation.py`, `scripts/msvc_harness/tdd_policy.py`는 없다.
- [runner](../../../scripts/execute.py)는 config → discovery → toolchain → adapter → process만 호출하고 phase 인자·내부 LLM·Git·자동 retry를 구현하지 않는다.
- [config](../../../scripts/msvc_harness/config.py)는 legacy `tdd`를 경고 후 무시하지만 경로·허용 field·preset 조합 검사는 유지한다. “느슨하게”는 모든 validation 제거를 뜻하지 않는다.
- [process](../../../scripts/msvc_harness/process.py)는 backend 실패, deadline, MSVC 확인과 CTest 0개 거부를 유지한다. 문서와 동일하다.
- 현재 preset 이름과 AGENTS의 네 CMake/CTest 명령은 [CMakePresets.json](../../../CMakePresets.json), [CMake adapter](../../../scripts/msvc_harness/adapters/cmake.py)에 대응한다. 실제 build 성공을 확인한 것은 아니다.
- 네 문서의 로컬 Markdown 링크 대상 경로 67건을 확인했고 누락은 없었다. Fragment 전체의 자동 검증은 수행하지 않았으며 주요 `adr-028` anchor는 직접 확인했다.
## 2. 부족한 부분과 영향
### F1. 기존 Feature 재개 시 운영 절차와 승인 요구의 구분이 덜 명확하다 — 문서 보완
공통 문서는 checklist를 Feature PRD에 두고 coordination/phase를 이력으로 보존하라고 이미 정한다. [Feature 문서 관리](../../FEATURE_DOCUMENTATION.md)의 `시작과 참조`에도 기존 파일을 자동 이동·복제하지 않는 규칙이 있다. 따라서 기본 정책 누락은 아니다.
그러나 현재 [MITC4 FEATURED_AGENTS](../../mitc4-shell-feast-eigen/FEATURED_AGENTS.md):4~7·14·23~24와 [Feature PRD](../../mitc4-shell-feast-eigen/PRD.md):4~16은 삭제된 coordinator, 9개 stage, coordination 상태 원본을 현재 절차 또는 과거 사용자 요구로 함께 표현한다. 두 파일은 사용자 미커밋 변경이 있는 실제 재개 입력이다.
영향: 다음 작업자가 삭제된 profile/phase runner를 재가동하려 하거나, 반대로 옛 문서를 통째로 이력 처리하여 승인된 acceptance·명시 요청된 감사까지 빠뜨릴 수 있다.
보완: ADR-028에 **운영 방식은 현행 규칙, 승인된 제품·검증 요구는 관련 Feature 계약**이라는 적용 방법을 추가한다. 재개가 실제로 요청되면 현재 할 일과 근거 링크만 PRD checklist로 정리한다. 기존 phase payload/status를 새 runner 입력으로 변환하거나 완료로 표시하지 않는다. 특정 Feature의 상태를 이번 공통 문서 작업에서 대신 수정하지 않는다.
### F2. Python 회귀 테스트가 제거된 운영 기능을 아직 요구한다 — 구현 후속 필요
정적 근거:
- [test_agent_skill_workflow_contract.py](../../../tests/test_agent_skill_workflow_contract.py):15~27은 11개 profile을 기대하고, :349의 검사는 고정 9단계 workflow, :396은 `xhigh`를 요구한다.
- [test_hook_validation_scope.py](../../../tests/test_hook_validation_scope.py):4와 [test_harness_timeouts.py](../../../tests/test_harness_timeouts.py):10은 삭제된 hook 모듈을 import한다.
- [test_execute.py](../../../tests/test_execute.py):62 등은 더 이상 없는 `StepExecutor`를 사용한다. [ownership tests](../../../tests/test_execute_ownership.py)도 이 executor와 과거 자동 Git 계약을 전제로 한다.
- [pytest.ini](../../../pytest.ini)는 `tests`를 수집한다. [CMake test registration](../../../tests/CMakeLists.txt):179·185·191은 GoogleTest discovery이며 현재 구성은 이 Python suite를 등록하지 않는다.
따라서 문서의 pytest 명령 자체가 잘못된 것은 아니지만 현재 테스트 내용이 새 구현에 맞지 않는다. pytest 설치만으로 정합성이 해결된다고 볼 수 없다. 이는 직전 계획의 별도 후속 항목에도 기록된 미해결 문제이며 이번에 실행 실패 건수를 측정한 것은 아니다.
보완: AGENTS와 ARCHITECTURE에 **구성된 solver build/test 성공과 Harness 구현의 Python 회귀 검증은 별개**임을 간단히 명시한다. 일시적인 실패 목록은 루트 운영 규칙에 누적하지 않고 이 분석의 후속 항목으로 둔다. 테스트를 통과시키기 위해 문서를 11개 agent/9단계로 되돌려서는 안 된다.
### 수정 사유로 삼지 않을 관찰
- ADR-012·024~027의 옛 Coordinator/Hook/owned_paths 문구는 명시적으로 이력이다. 본문 삭제·일괄 치환·새 `Accepted` 표시는 불필요하다.
- CLI deadline은 [execute.py](../../../scripts/execute.py):23의 **1,800초**다. [models.py](../../../scripts/msvc_harness/models.py):65와 [process.py](../../../scripts/msvc_harness/process.py):66의 **7,200초**는 현재 브랜치에 남은 내부 기본값이다. CLI가 전달하는 deadline과 `min(command timeout, remaining)` 때문에 [HARNESS](../../HARNESS.md)의 1,800초 설명은 맞다. 문서를 7,200초로 바꾸거나 이번에 상수를 통일하지 않는다.
- Release profile이 없어도 [release skill](../../../.codex/skills/fem-release-readiness/SKILL.md)은 명시 요청된 감사를 수행할 수 있다. “profile 삭제”와 “이미 요청한 감사 취소”는 다르다.
- 전문 책임을 유지한 PRD·ARCHITECTURE의 Numerical Review/I/O/Physics 설명은 별도 고정 stage 의무가 아니다. 실제 수치 검증을 더 완화할 근거는 없다.
## 3. AGENTS.md Quality Report
### Summary
- Files found: 1 (`AGENTS.md`). 생성물·VCS·dependency를 제외한 프로젝트 범위에서 nested `AGENTS.override.md`/`AGENTS.md`는 발견되지 않았다.
- Active chain: repository root `AGENTS.md` → 현재 root 작업 디렉토리. 사용자/global 지침은 이번 파일 감사 범위 밖이다.
- Average score: **88/100 (B)**. 문서 적합성 평가이며 solver 품질 점수가 아니다.
- Files needing update: 1 (선택적·국소 보완).
- Combined active-chain size: **20,421 bytes**. 감사 기준 기본 32 KiB 대비 약 62%. 세 `docs/*.md`는 자동 로드 지침 파일 크기에 합산하지 않았다. 실제 runtime의 별도 limit override는 조사하지 않았다.
### File-by-File Assessment
#### 1. AGENTS.md (project root; active)
**Score: 88/100 (Grade: B)**
| Criterion | Score | Evidence |
| --- | ---: | --- |
| Commands and workflows | 18/20 | 새 CLI와 preset은 일치. Python suite와 configured CTest의 구분을 더 명시할 수 있음 |
| Repository map and instruction scope | 20/20 | 7개 profile·관련 skill·문서 링크가 존재하고 root 범위가 적절함 |
| Non-obvious constraints and gotchas | 15/15 | Identity·수치/물리·reference·state 보존과 preset 묶음 설정을 구체적으로 유지 |
| Conciseness and duplication | 10/15 | 기술 제약은 유용하나 여러 운영 문서와 역할·검증 설명을 반복함; 이번에는 전면 축약하지 않음 |
| Currency against the codebase | 13/15 | 실행기/profile의 경량화는 반영. 구형 테스트 및 재개 입력과의 접점에 보완 여지가 있음 |
| Actionability and verifiability | 12/15 | 명령·완료 기준은 구체적. 기존 작업을 현행 운영으로 이어가는 해석을 더 명시할 수 있음 |
**Issues:** F1의 재개 해석과 F2의 검증 범위 구분. 삭제된 agent를 신규 필수 역할로 요구하는 문제는 이미 해결됐다.
**Recommended changes:** 아래 AGENTS 제안 문구만 추가한다. 미해결 테스트 목록, 새 gate·hash·retry budget과 solver 진행 상태를 루트에 넣지 않는다.
## 4. 제안 diff
아래 diff는 검토용이며 아직 적용하지 않았다. 현재 문서의 구성과 인접 문장을 유지한다.
### Update: AGENTS.md
**Why:** 기존 Feature 재개 시 상세 적용 규칙을 ADR-028로 연결하고 Python 검사와 solver runner의 범위를 구분한다.
```diff
- 기존 `coordination.md`, `docs/features/<feature-id>/`와 phase 자료는 이력으로 보존하고 필요한 경로·계약 revision을 참조한다. 자동 이동·복제하거나 신규 coordination 상태 파일을 만들지 않는다.
+- 기존 Feature 재개 시 운영 절차와 승인된 요구사항을 구분하여 [ADR-028](docs/ADR.md#adr-028)을 적용한다. 현재 할 일과 근거 링크만 Feature PRD의 checklist에 정리한다.
```
`### Harness Python 검증`의 명령 설명 바로 뒤:
```diff
+이 Python suite는 Harness 구현을 검증한다. 현재 CMake/CTest 구성은 이를 실행하지 않으므로
+`python scripts/execute.py`의 성공을 Python 회귀 검사 통과로 보고하지 않는다.
```
### Update: docs/ADR.md
**Why:** ADR-028의 운영 경량화를 기존 계약·사용자 요구의 자동 취소로 해석하지 않도록 적용 방법을 명시한다. 새 정책·새 ADR 번호·새 승인 사실은 만들지 않는다.
ADR-028의 결정 목록 뒤, `이 결정은 ADR-012·024~027...` 문단 앞에 추가:
```diff
+기존 Feature를 재개할 때 삭제된 profile·phase 실행 절차에는 이 결정을 적용하고,
+승인된 제품 범위·수치 계약·필수 검증과 명시 요청된 감사는 해당 Feature 계약으로 유지한다.
+메인은 남은 작업과 기존 근거 링크만 Feature PRD의 현재 checklist에 정리한다.
+과거 coordination·phase·실패 기록을 재작성하거나 새 runner 입력으로 변환하지 않는다.
+운영 전환만으로 기존 evidence가 새로 검증되었거나 실제 blocker가 해결되었다고 표시하지 않는다.
```
### Update: docs/ARCHITECTURE.md
**Why:** Runner가 소유한 configured backend 검증과 개발 도구 자체의 회귀 검사 책임을 구분한다. 실제 CMake adapter/CTest 등록과 일치하는 설명이다.
`개발 운영 인프라`의 owner 표 다음에 추가:
```diff
+구성된 solver build/test와 Harness 구현의 Python 회귀 검증은 별도 범위다.
+현재 CMake adapter와 CTest 등록은 Harness Python suite를 실행하지 않는다.
+Harness 동작 변경의 Python 검사는 구현 담당자가 변경 영향에 맞게 별도로 수행하며,
+Runner 성공을 미실행한 Python 검사나 reference 비교의 통과로 확장하지 않는다.
```
### Update: docs/PRD.md
**Why:** 현재 제품·완료 기준이 경량화와 일치하므로 **제안 diff 없음**. GEN ID·acceptance·수치 검증·reference 정책을 유지한다.
## 5. 후속 문서 반영 작업
### Task 1: 기존 Feature 재개 안내 보완
**Files:** Modify `docs/ADR.md`, `AGENTS.md`. Read-only `docs/FEATURE_DOCUMENTATION.md`, 관련 기존 Feature PRD·FEATURED_AGENTS.
**입출력:** ADR-028과 기존 승인 요구를 입력으로 사용하고, §4의 두 재개 안내를 산출한다.
- [ ] 최신 worktree에서 해당 절과 사용자 변경 여부를 확인한다. 기존 Feature 원문은 수정하지 않는다.
- [ ] ADR-028에 §4의 5문장 적용 설명을 추가한다. 과거 결정 본문·상태·승인 근거는 유지한다.
- [ ] AGENTS에 ADR-028 링크와 PRD checklist 안내 1개 bullet을 추가한다.
- [ ] 정적으로 대조한다: 삭제된 profile 호출·phase 실행 없음, 기존 acceptance·명시 감사 유지, history 수정 없음, 미해결 blocker의 임의 해소 없음.
### Task 2: 검증 범위 명시 및 네 문서 최종 대조
**Files:** Modify `AGENTS.md`, `docs/ARCHITECTURE.md`. Read-only `docs/PRD.md`, `scripts/execute.py`, `scripts/msvc_harness/adapters/cmake.py`, `tests/CMakeLists.txt`.
**입출력:** 현재 backend 명령·CTest 등록을 입력으로 사용하고, §4의 검증 범위 문구와 정적 확인 결과를 산출한다.
- [ ] AGENTS·ARCHITECTURE에 §4의 Python/solver 검증 구분을 추가한다.
- [ ] PRD의 GEN-010·011·012와 `검증과 완료 기준`이 유지됨을 확인한다. PRD에 변경을 만들지 않는다.
- [ ] `git diff --check -- AGENTS.md docs/ADR.md docs/ARCHITECTURE.md docs/PRD.md`로 whitespace를 확인한다.
- [ ] `git diff --stat -- AGENTS.md docs/ADR.md docs/ARCHITECTURE.md docs/PRD.md` 및 실제 diff를 확인한다. 추가가 위 제안 범위이고 PRD diff가 없어야 한다.
- [ ] AGENTS의 링크 대상·`adr-028` anchor·파일 크기를 다시 확인한다. 누락 링크나 새 자동 로드 지침 파일을 만들지 않는다.
- [ ] 실행하지 않은 build/test는 미실행으로 보고하고 문서 정합성 확인과 구분한다. Commit·Feature 실행은 하지 않는다.
완료 기준: F1/F2의 안내가 적용되고, 네 문서의 나머지 계약과 기존 사용자 변경이 보존되며, 새 lifecycle·승인 gate·반복 전체 검증이 추가되지 않는다.
## 6. 별도 후속 범위: Python 테스트 정비와 실제 Feature 재개
이 항목들은 이번 문서 계획의 실행 작업에 포함하지 않는다. 문서 수정만으로 해결되었다고 보고할 수 없다.
| 후속 작업 | 범위·방법 | 완료 시 확인할 결과 |
| --- | --- | --- |
| Harness Python 테스트 정비 | `tests/test_execute.py`, `tests/test_execute_ownership.py`, `tests/test_hook_validation_scope.py`, `tests/test_harness_timeouts.py`, `tests/test_agent_skill_workflow_contract.py`의 구형 동작 기대를 현행 계약과 분류한다. 새 runner의 CLI/exit, config/preset, deadline, 실패 중단, 결과 검사와 자동 Git/phase 변경 부재를 동작 중심으로 검증하도록 별도 구현 계획을 세운다. 유효한 backend coverage를 blanket 삭제·skip하지 않는다. | 필요한 실패 재현과 수정 후 Python suite의 실제 결과. 7개 agent·medium/high를 유지하고 삭제된 hook/StepExecutor를 되살리지 않음. 문서 문자열 일치만으로 동작 검증을 대신하지 않음 |
| 진행 중 Feature 재개 | 해당 작업이 요청되면 현재 PRD/FEATURED_AGENTS의 운영 안내만 최소 갱신하고 남은 승인 작업을 checklist로 연결한다. 기존 계약·실패·차단 사유를 먼저 확인한다. | 현행 runner로 가능한 검증과 별도 구현/수치/reference 작업이 구분되고, 과거 stage 상태나 report만으로 완료를 선언하지 않음 |
내부 7,200초 기본값과 CLI 1,800초의 차이는 필요하다면 테스트 정비에서 명시적으로 검증한다. 이 계획은 timeout 변경·새 설정 필드 도입을 승인하지 않는다.
## 7. 이번 분석의 검증 범위
수행: Git 상태·이력, profile/skill/runner/config/adapter와 관련 테스트 소스 대조, 네 문서 읽기, 링크 대상 존재·AGENTS 크기 확인. Python은 파일을 읽는 정적 점검에만 사용했다.
미실행: pytest collection/실행, Harness, CMake/CTest, 수치/reference 비교. 문서 분석 요청이므로 수행하지 않았고 통과로 보고하지 않는다. 사용자 전역 설정·외부 설치 환경·실행 중 agent profile 반영 여부는 감사 범위 밖이다.
적용 여부는 이 계획 검토 후 정한다. 현재는 계획 파일만 작성했으며 대상 네 문서는 변경하지 않았다.