solmate-skills 2.0.13 → 2.0.14

package/AGENTS.md

@@ -106,7 +106,7 @@
 - **완료 전 차단**: `blocking` 모드에서는 읽기 전용 Verification Agent가 명령 결과와 QA 문서 또는 PR 근거를 포함한 PASS Verification Receipt를 남기지 않으면 Done, PR, merge, publish, deploy로 이동할 수 없다.
 - **역할 분리**: Implementation Agent가 작성한 Change Receipt는 독립 검증이 아니다. Verification Agent는 발견 사항을 직접 수정하지 않고 Coordinator를 통해 Implementation Agent로 반환한다.
 - **Claude와 Codex**: Claude Code는 `.claude/agents/solmate-*.md`를 사용한다. Codex는 `rules-workflow` 정본을 사용 가능한 subagent 또는 별도 task에 전달한다.
-- **강제 수준**: 처음 5개 실제 작업은 `warning` 결과를 기록하고 사용자 확인 후 진행한다. 이후 `npx solmate-skills preflight TASK-ID --strict`와 `npx solmate-skills verify TASK-ID --strict`를 차단 게이트로 사용한다.
+- **강제 수준**: 처음 5개 실제 작업은 Coordinator가 내부 `warning` 결과를 기록하고 사용자 확인 후 진행한다. 이후 Coordinator 또는 CI가 `preflight TASK-ID --strict`와 `verify TASK-ID --strict`를 차단 게이트로 사용한다. 사용자에게 이 명령·Task ID·Receipt 작성을 요구하지 않고, 통과 결과 또는 막힌 사유만 보고한다.
 
 ## 4. Skills & AI Capabilities
 AI 에이전트는 본 프로젝트에 설치된 다음 **26개 스킬**을 활용하여 작업을 수행하며, 모든 작업 결과물은 이 스킬들의 검증 가이드를 통과해야 한다.
@@ -151,8 +151,8 @@ AI 에이전트는 사용자가 스킬을 호출하지 않아도, 아래 상황
 | 기술 선택, DB/API/아키텍처 설계 논의 시작 | `manage-decisions` | "결정이 필요한 상황입니다. `/manage-decisions`로 유형별 질문을 진행할까요?" |
 | 보안·인증·인가·환경변수 관련 코드 작성 전후 | `verify-security` | "보안 관련 변경입니다. `/verify-security`로 OWASP 점검을 실행할까요?" |
 | 성능·렌더링·이미지·번들 관련 작업 완료 후 | `verify-performance` | "성능 영향이 있을 수 있습니다. `/verify-performance`로 Lighthouse 점검을 실행할까요?" |
-| UI·화면·컴포넌트 구현 완료 후 | `verify-ui` | "UI 구현 변경입니다. `/verify-ui`로 HTML Preview·화면 문서·사용자 동선 정합성을 검증할까요?" |
-| PR 생성 전, 코드 변경 완료 후 | `verify-code`, `verify-implementation` | "PR 전 최종 점검입니다. `/verify-implementation`으로 전체 검증을 실행할까요?" |
+| UI·화면·컴포넌트 구현 완료 후 | `verify-ui` | Coordinator가 관련 UI 검증을 자동 실행하고 결과만 보고 |
+| 기능 구현 완료 또는 PR 생성 전 | `verify-code`, `verify-implementation` | Coordinator가 `/verify-implementation`과 필요한 내부 Harness 검증을 즉시 실행하고 결과만 보고 |
 | 기획·UI 문서 작성 요청 | `docs-plan` | "Layer 1-2 문서 작성은 `/docs-plan`을 사용하세요." |
 | DB 스키마·API 명세·백로그 작성 요청 | `docs-dev` | "Layer 3-5 문서 작성은 `/docs-dev`를 사용하세요." |
 | Drizzle 스키마 파일 수정 | `verify-drizzle-schema` | "스키마 변경 후 `/verify-drizzle-schema`로 정합성을 검증하세요." |

package/README.md

@@ -45,9 +45,9 @@ The installer copies each selected skill folder into `.agent/skills/<skill-name>
 - **Versioned harness artifacts**: `validate-harness` checks v1 task manifests, structured messages, ordered state events, role activation, evidence gates, and exclusive write ownership.
 - **Release verification**: `/verify-implementation` runs the verification family for docs, UI, code, security, performance, DB schema, and skill package readiness.
 
-## What's New in 2.0.13: Agent Harness Contracts
+## Agent Harness
 
-`solmate-skills@2.0.13` strengthens the existing Solmate workflow with a shared Claude/Codex agent harness. It addresses two recurring failure modes in long AI-assisted projects:
+The shared Claude/Codex agent harness strengthens the existing Solmate workflow. It addresses two recurring failure modes in long AI-assisted projects:
 
 1. An implementation starts from a backlog item without reading the linked concept, UI, technical, and QA documents.
 2. An agent marks work complete based only on its own summary, without independent verification evidence.
@@ -71,27 +71,28 @@ Coordinator
 
 The canonical contract lives at [`rules-workflow/resources/agent-harness-contract.md`](./rules-workflow/resources/agent-harness-contract.md).
 
-### Backlog Receipt checks
+### Default behavior: ask for a feature, receive a verified result
 
-Existing projects can keep their current `00_BACKLOG.md` workflow and add the checks incrementally:
+You do not run Harness commands during normal feature work. Ask the coding agent to implement the feature; the Coordinator finds the backlog task, checks the linked documents before coding, and starts independent verification immediately after implementation.
 
-```bash
-# Confirm required linked documents were read before coding
-npx solmate-skills preflight TASK-000
+| You say | The agent does internally | You receive |
+|:---|:---|:---|
+| "Implement file upload" | Finds the related backlog task, reads its linked documents, and runs the Context gate | Either implementation begins or a plain-language explanation of the missing decision or document |
+| "The feature is done" | Runs `verify-implementation`, relevant checks, and the Verification gate | A concise PASS/FAIL report, remaining risks, and the next decision only when needed |
 
-# Confirm independent command and QA/PR evidence before completion
-npx solmate-skills verify TASK-000
+The agent must not ask you to type `preflight`, `verify`, `validate-harness`, a task ID, or Receipt content. When a gate blocks progress, it explains what is missing rather than exposing its internal command.
 
-# Turn findings into blocking exit codes for CI or release gates
-npx solmate-skills preflight TASK-000 --strict
-npx solmate-skills verify TASK-000 --strict
-```
+### Advanced automation and CI
 
-### Versioned manifest, message, and event checks
+The following interfaces are for Coordinator runtimes, CI, and teams building custom automation. They are optional; existing backlog Receipt projects do not need structured artifacts.
 
-Projects that need structured multi-agent coordination can opt into the v1 contract without rewriting existing backlog Receipts:
+<details>
+<summary>Internal Receipt and structured-artifact commands</summary>
 
 ```bash
+npx solmate-skills preflight TASK-000 --strict
+npx solmate-skills verify TASK-000 --strict
+
 npx solmate-skills validate-harness manifest _workspace/harness/TASK-000/manifest.json
 npx solmate-skills validate-harness message _workspace/harness/TASK-000/attempt-01/messages/msg-001.json \
   --manifest _workspace/harness/TASK-000/manifest.json
@@ -99,7 +100,7 @@ npx solmate-skills validate-harness events _workspace/harness/TASK-000/events.js
   --manifest _workspace/harness/TASK-000/manifest.json
 ```
 
-[`agent-harness-v1.schema.json`](./rules-workflow/resources/agent-harness-v1.schema.json) defines the manifest, message, and state-event shapes. The validator additionally checks task identity, legal state transitions, active roles, message authority, required evidence, canonical file paths, and exclusive write ownership.
+[`agent-harness-v1.schema.json`](./rules-workflow/resources/agent-harness-v1.schema.json) defines the manifest, message, and state-event shapes. The validator checks task identity, legal state transitions, active roles, message authority, required evidence, canonical file paths, and exclusive write ownership.
 
 | Mode / result | Exit code | Behavior |
 |:---|:---:|:---|
@@ -108,6 +109,8 @@ npx solmate-skills validate-harness events _workspace/harness/TASK-000/events.js
 | `--strict`, contract finding | `1` | Blocks the workflow or CI step |
 | Invalid command input, unreadable file, malformed JSON/JSONL | `2` | Reports an operational error |
 
+</details>
+
 ### Compatibility and current scope
 
 - Existing `preflight`, `verify`, and backlog Receipt fixtures continue to work without structured artifact files.
@@ -117,6 +120,19 @@ npx solmate-skills validate-harness events _workspace/harness/TASK-000/events.js
 - Specialist personas, runtime orchestration, persistent recovery, pilot automation, and blocking rollout remain separate follow-up work.
 - This release ships the contract and validation foundation; specialist personas and runtime orchestration remain separately gated follow-up work.
 
+## What's New in 2.0.14
+
+`solmate-skills@2.0.14` makes verification an agent responsibility instead of a user checklist.
+
+- After implementation, the Coordinator automatically starts `verify-implementation` and the required Harness Receipt checks before reporting completion.
+- Context and Verification agents run their applicable checks internally and return plain-language results or a blocked decision.
+- `npx solmate-skills list` now describes automatic workflow verification rather than presenting internal Harness commands as the default path.
+- README and `USAGE.md` keep `preflight`, `verify`, and `validate-harness` in advanced runtime/CI guidance.
+
+## What's New in 2.0.13
+
+`solmate-skills@2.0.13` introduced the shared Agent Harness contract, versioned artifacts, Context/Change/Verification Receipts, and the `validate-harness` validator.
+
 ## What's New in 2.0.12
 
 `solmate-skills@2.0.12` adds a bilingual usage guide and copies it into every target project on install.
@@ -176,7 +192,8 @@ Install skills, then invoke one command based on your situation.
 |:---|:---|:---|
 | New project or "where do I start?" | `/rules-product` | Diagnoses phase and delegates to the right skill |
 | Implement one feature | `/rules-product` then `/rules-workflow` | Gates must pass before coding |
-| Pre-PR / pre-release check | `/verify-implementation` | Runs the verify-* family in order |
+| Feature implementation just finished | No extra command | The Coordinator automatically starts `verify-implementation` and reports the result |
+| Explicit audit request | `/verify-implementation` | Runs the verify-* family in order |
 
 **Recommended first line:**
 
@@ -218,12 +235,7 @@ npx solmate-skills@latest install hooks
 npx solmate-skills@latest install agents
 ```
 
-For a `code` or `deploy` backlog item:
-
-```bash
-npx solmate-skills preflight TASK-000 --strict
-npx solmate-skills verify TASK-000 --strict
-```
+For a `code` or `deploy` backlog item, ask the agent to implement the feature. The Coordinator handles the Context and Verification gates internally and reports only the result or the decision needed to unblock it.
 
 Example prompts: [USAGE.md §9 Recommended Prompts](./USAGE.md#9-recommended-prompts) (EN) · [§9 권장 프롬프트](./USAGE.md#9-권장-프롬프트-모음) (KO)
 

package/USAGE.md

@@ -124,7 +124,12 @@ Coordinator
 - Codex uses available subagents or separate tasks with the same canonical contract from `rules-workflow/resources/agent-harness-contract.md`.
 - The verifier reports findings but does not modify source files.
 - Receipt summaries stay in the backlog; detailed verification links to a QA document or GitHub PR.
-- Use warning mode for the first five real tasks, then switch to blocking checks:
+- For normal feature work, the Coordinator runs Context and Verification checks internally. Do not ask the user to run a Harness command, choose a task ID, or fill in a Receipt. Report only a PASS/FAIL result or the missing decision and document.
+
+<details>
+<summary>Advanced: runtime and CI commands</summary>
+
+Use warning mode for the first five real tasks, then let the Coordinator or CI switch to blocking checks:
 
 ```bash
 npx solmate-skills preflight TASK-000 --strict
@@ -141,11 +146,14 @@ npx solmate-skills validate-harness events _workspace/harness/TASK-000/events.js
 
 Add `--strict` for blocking validation. Contract failures then exit `1`; malformed JSON, missing files, and invalid command input exit `2`. Existing backlog-only projects do not need to create these files.
 
+</details>
+
 ### Individual verify-* vs master
 
 | Situation | Use |
 |:---|:---|
-| Full pre-PR / pre-release | `verify-implementation` |
+| Feature implementation just finished | Coordinator automatically invokes `verify-implementation` |
+| Explicit full audit request | `verify-implementation` |
 | Docs only changed | `verify-docs` |
 | TSX screens only | `verify-ui` |
 | API / auth / env changed | `verify-security` (+ `verify-code` if needed) |
@@ -477,6 +485,7 @@ Use `N/A - reason` when a doc does not exist. Pause implementation if a missing
 - Context and Verification agents are read-only
 - Verification details must link to an existing `docs/05_QA_Validation/` document or GitHub PR
 - Default CLI mode is `warning`; `--strict` returns a blocking non-zero exit
+- `preflight`, `verify`, and `validate-harness` are Coordinator/CI interfaces, not commands a normal user needs to run
 
 ### YAGNI/KISS/DRY Gate
 
@@ -707,7 +716,12 @@ Coordinator
 - Codex는 `rules-workflow/resources/agent-harness-contract.md`의 같은 계약을 subagent 또는 별도 task에 전달합니다.
 - 검증자는 문제를 직접 수정하지 않고 Implementation Agent로 돌려보냅니다.
 - Receipt 요약은 백로그에, 상세 검증 근거는 QA 문서 또는 GitHub PR에 남깁니다.
-- 처음 5개 실제 작업은 warning으로 확인한 뒤 blocking으로 전환합니다.
+- 일반 기능 작업에서는 Coordinator가 Context·Verification 검사를 내부적으로 실행합니다. 사용자에게 Harness 명령, Task ID, Receipt 작성을 요구하지 않고 통과/실패 결과 또는 필요한 결정과 문서만 설명합니다.
+
+<details>
+<summary>고급: 런타임·CI 명령</summary>
+
+처음 5개 실제 작업은 Coordinator 또는 CI가 warning으로 확인한 뒤 blocking으로 전환합니다.
 
 ```bash
 npx solmate-skills preflight TASK-000 --strict
@@ -724,11 +738,14 @@ npx solmate-skills validate-harness events _workspace/harness/TASK-000/events.js
 
 차단 검증에는 `--strict`를 추가합니다. 계약 위반은 종료 코드 `1`, JSON 파싱·파일·명령 입력 오류는 종료 코드 `2`입니다. 기존 백로그 Receipt만 사용하는 프로젝트는 이 파일을 만들 필요가 없습니다.
 
+</details>
+
 ### verify-* 개별 vs 통합
 
 | 상황 | 사용 |
 |:---|:---|
-| PR·배포 전 전체 점검 | `verify-implementation` |
+| 기능 구현 직후 | Coordinator가 `verify-implementation`을 자동 실행 |
+| 명시적 전체 점검 요청 | `verify-implementation` |
 | 문서만 수정함 | `verify-docs` |
 | TSX 화면만 수정함 | `verify-ui` |
 | API·auth·env 수정함 | `verify-security` (+ 필요 시 `verify-code`) |

package/bin/cli.js

@@ -101,11 +101,9 @@ function listSkills() {
     console.log('\nUtilities:');
     console.log(' - hooks (install with: npx solmate-skills install hooks)');
     console.log(' - agents (install with: npx solmate-skills install agents)');
-    console.log('\nHarness checks:');
-    console.log(' - npx solmate-skills preflight TASK-000 [--strict]');
-    console.log(' - npx solmate-skills verify TASK-000 [--strict]');
-    console.log(' - npx solmate-skills validate-harness <manifest|message|events> <path> [--manifest <path>] [--strict]');
-    console.log('   message and events validation require --manifest <path>');
+    console.log('\nWorkflow verification:');
+    console.log(' - Feature work is verified automatically by rules-workflow and verify-implementation.');
+    console.log(' - Advanced runtime and CI contracts: see USAGE.md and agent-harness-contract.md.');
     console.log('\nUsage: npx solmate-skills install <skill-name> | all | hooks | agents\n');
 }
 

package/bin/harness-check.test.js

@@ -156,4 +156,13 @@ for (const fileName of ['solmate-context-reader.md', 'solmate-implementer.md', '
     assert(fs.existsSync(path.join(customAgentDir, fileName)), `${fileName} was not installed`);
 }
 
+const listOutput = childProcess.spawnSync(
+    process.execPath,
+    [cliPath, 'list'],
+    { cwd: root, encoding: 'utf8' },
+);
+assert.strictEqual(listOutput.status, 0, listOutput.stderr || listOutput.stdout);
+assert(listOutput.stdout.includes('Feature work is verified automatically'));
+assert(!listOutput.stdout.includes('preflight TASK-000'));
+
 console.log('harness checks ok');

package/docs/01_Concept_Design/01_AGENT_HARNESS_REQUIREMENTS_ANALYSIS.md

@@ -1,6 +1,6 @@
 # Agent Harness Requirements Analysis
 > Created: 2026-07-17 01:04
-> Last Updated: 2026-07-17 01:31
+> Last Updated: 2026-07-17 03:19
 
 ## 1. Purpose
 
@@ -18,6 +18,7 @@ The user identified the following needs after reviewing `revfactory/harness` and
 - handle agent, tool, contract, and verification failures explicitly;
 - create a user-requirements analysis artifact before design and implementation;
 - retain Solmate's stronger machine-enforced document and verification evidence;
+- keep Harness commands internal so normal feature requesters receive verified results rather than a manual CLI checklist;
 - support both Claude Code and Codex without assuming one runtime's private tool names in the canonical contract.
 
 ## 3. Problem Statement
@@ -85,6 +86,7 @@ It does not yet define:
 | NFR-008 | Independence | Verification evidence must come from a role that did not implement the change |
 | NFR-009 | Recoverability | A stopped agent or interrupted session can resume from persisted artifacts without silently restarting the task |
 | NFR-010 | Open Source | Concepts may be inspired by external projects, but Solmate contracts are independently written and attributable where necessary |
+| NFR-011 | Human Simplicity | The Coordinator owns internal preflight and verification commands; users receive results or required decisions, not Harness CLI instructions |
 
 ## 7. Approved Scope
 

package/docs/03_Technical_Specs/01_AGENT_HARNESS_ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # Agent Harness Architecture
 > Created: 2026-07-17 01:04
-> Last Updated: 2026-07-17 01:53
+> Last Updated: 2026-07-17 03:19
 
 ## 1. Architecture Goal
 
@@ -21,6 +21,7 @@ The architecture is deliberately split into two layers:
 6. **Failures are states, not prose**: the Coordinator records a typed state and legal next action.
 7. **No silent degradation**: missing critical context, design, code, or verification cannot be hidden by a partial final report.
 8. **Adapters are thin**: runtime-specific tool names never become canonical workflow rules.
+9. **Human requests stay simple**: the Coordinator runs Harness checks internally and reports evidence or a blocked decision without requiring users to know CLI commands, task IDs, or Receipt formats.
 
 ## 3. System Context And Data Flow
 
@@ -34,7 +35,7 @@ The Coordinator owns the task state. Specialists produce versioned artifacts. Th
 
 | Role | Activation | Primary Responsibility | Write Authority |
 |---|---|---|---|
-| Coordinator | Always | User communication, topology selection, state transitions, approvals, handoffs, completion decision | Backlog, decision and receipt summaries only |
+| Coordinator | Always | User communication, topology selection, state transitions, approvals, handoffs, internal Harness checks, and completion decision | Backlog, decision and receipt summaries only |
 | Context Reader | Code and deploy; advisory elsewhere | Read all linked references, detect conflicts, return Context Receipt | None |
 | Implementer | After required design and Context gates pass | Change only approved files and return Change Receipt | Declared implementation ownership |
 | QA Inspector | After a Change Receipt; incrementally for complex work | Independently inspect boundaries, execute checks, return findings and Verification Receipt | None, except a separately approved QA report written by Coordinator |
@@ -346,6 +347,7 @@ Rules:
 
 - Existing backlog tasks remain valid until they opt into the enhanced fields.
 - Existing `Context Receipt`, `Change Receipt`, `Verification Receipt`, `preflight`, and `verify` behavior remains compatible.
+- Coordinator and CI own those commands; ordinary feature requests do not expose them as a user action.
 - New structured manifests begin in warning mode.
 - The first five real code/deploy tasks collect false-positive and missing-capability evidence.
 - Blocking mode activates only after the pilot review and user approval.

package/docs/05_QA_Validation/01_TEST_SCENARIOS.md

@@ -1,6 +1,6 @@
 # Agent Harness Test Scenarios
 > Created: 2026-07-17 01:04
-> Last Updated: 2026-07-17 01:53
+> Last Updated: 2026-07-17 03:19
 
 ## 1. Purpose
 
@@ -53,6 +53,7 @@ Implementation-stage status must replace these design-stage statements with exec
 | NFR-008 | QA-QA-001, QA-QA-002 | Covered |
 | NFR-009 | QA-RECOVERY-001, QA-RECOVERY-002 | Covered |
 | NFR-010 | QA-LICENSE-001 | Covered |
+| NFR-011 | QA-UX-001 | Covered |
 
 ## 4. Requirements And Context Scenarios
 
@@ -79,6 +80,14 @@ Implementation-stage status must replace these design-stage statements with exec
 - **Then**: State becomes `BLOCKED_CONTEXT`; both sources are preserved and Coordinator routes a decision.
 - **Failure**: Context Reader chooses one silently or Implementer starts work.
 
+### QA-UX-001 - Internal Harness Commands Stay Internal
+
+- **Given**: A user asks the Coordinator to implement a code feature or reports that implementation is finished.
+- **When**: Context or Verification gates are required.
+- **Then**: The Coordinator resolves the backlog task and runs the applicable Harness checks internally; the user receives a plain-language PASS/FAIL result or the missing document/decision.
+- **Failure**: The agent asks the user to run `preflight`, `verify`, `validate-harness`, provide a task ID, or manually write a Receipt for normal feature progress.
+- **Evidence**: Workflow and adapter review plus a representative feature-task transcript.
+
 ## 5. Role And Design Scenarios
 
 ### QA-ROLE-001 - Minimal Task Avoids Optional Specialists

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solmate-skills",
-  "version": "2.0.13",
+  "version": "2.0.14",
   "description": "AI agent harness and workflow skills for context-aware planning, implementation, verification, docs, and QA",
   "main": "bin/cli.js",
   "bin": {

package/rules-product/SKILL.md

@@ -12,7 +12,7 @@ description: Orchestrates the full product development pipeline from planning to
 > - **Next**: `docs-plan`, `docs-dev`, `rules-react`, `rules-workflow`, or `verify-implementation` by phase
 > - **Guide**: project root `USAGE.md` (English default, Korean below; copied on install)
 
-You are a **workflow lead** who guides the user through the full product development pipeline. You do not do the work yourself — you diagnose the current phase, verify gate conditions, and direct the user to the right sub-skill at each step.
+You are a **workflow lead** who guides the user through the full product development pipeline. Diagnose the current phase, verify gate conditions, and invoke the required sub-skill or internal check yourself. Do not make users run harness CLI commands or translate an internal gate into a manual task.
 
 ## Pipeline Overview
 
@@ -265,7 +265,7 @@ Component & Library Planning Gate 보고에는 `Flow Status Block`을 포함하
 - [ ] Context Receipt의 상태가 PASS이거나 warning 발견 사항에 사용자 진행 승인이 있음
 - [ ] `Required References Read`가 모든 실제 Related 링크를 포함함
 - [ ] Constraints와 Conflicts가 기록됨
-- [ ] warning 기간에는 preflight 발견 사항 기록과 사용자 확인, blocking 전환 후에는 `npx solmate-skills preflight TASK-ID --strict` 통과
+- [ ] Coordinator가 warning 기간의 preflight 발견 사항을 기록하고 사용자 진행 승인을 받음. blocking 전환 후에는 Coordinator가 내부 `preflight TASK-ID --strict`를 통과시킴
 
 상세 역할과 Receipt 형식은 `rules-workflow/resources/agent-harness-contract.md`를 정본으로 따른다. `docs`와 `prototype` 작업은 이 게이트를 기록성 체크로 적용한다.
 
@@ -346,7 +346,7 @@ Phase 4 완료 보고에는 `Flow Status Block`을 포함한다.
 **Gate Out** (다음 단계 진입 조건):
 - [ ] `code`와 `deploy` 작업의 읽기 전용 Verification Agent 실행
 - [ ] Verification Receipt PASS 또는 warning 발견 사항에 사용자 진행 승인 — 명령 결과, 미실행 사유, QA 문서 또는 PR 상세 근거
-- [ ] warning 기간에는 verify 발견 사항 기록과 사용자 확인, blocking 전환 후에는 `npx solmate-skills verify TASK-ID --strict` 통과
+- [ ] Coordinator가 warning 기간의 verify 발견 사항을 기록하고 사용자 진행 승인을 받음. blocking 전환 후에는 Coordinator가 내부 `verify TASK-ID --strict`를 통과시킴
 - [ ] `verify-docs` PASS — 문서 구조·메타데이터 정합성
 - [ ] `verify-ui` PASS — 구현 UI와 화면 문서·사용자 동선·상태별 UI 정합성
 - [ ] `verify-code` PASS — 코드 품질 (로직, 타입, 중복, 사이드 이펙트)
@@ -359,7 +359,7 @@ Phase 4 완료 보고에는 `Flow Status Block`을 포함한다.
 
 ```
 사용할 스킬: verify-implementation
-동작: 위 verify-* 스킬을 순차 실행하고 통합 보고서 생성
+동작: Change Receipt 직후 Coordinator가 이 스킬을 자동 실행해 위 verify-* 스킬과 내부 Receipt 검사를 수행하고 통합 보고서 생성
 FAIL 항목 발견 시: 해당 스킬로 돌아가 수정 후 재검증
 ```
 

package/rules-workflow/SKILL.md

@@ -9,7 +9,7 @@ description: Guides the full implementation lifecycle from planning through PR.
 > - **When**: Feature implementation, commit/PR prep, 18-step workflow
 > - **Invoke**: `/rules-workflow` after gates and backlog links are ready
 > - **Prerequisites**: HTML UI Preview Gate, UI-First Gate, Backlog Context Lock, Component & Library Plan, Context Receipt
-> - **Next**: `verify-implementation` before PR
+> - **Next**: After implementation, the Coordinator automatically invokes `verify-implementation` before any completion report or PR
 > - **Guide**: project root `USAGE.md` (English default, Korean below; copied on install)
 
 Follow this workflow for feature implementation and significant code changes. Complete each phase before advancing; use the checklists to avoid skipping steps.
@@ -25,10 +25,11 @@ Follow this workflow for feature implementation and significant code changes. Co
 - `blocking` 모드에서 Verification Receipt가 없으면 Done, PR, merge, publish, deploy로 이동하지 않는다.
 - 처음 5개 실제 작업은 `warning`, 이후에는 `blocking` 모드를 권장한다.
 - 런타임이 독립 에이전트를 제공하지 않으면 `Degraded`로 보고하고 완료 전 사용자 승인을 받는다.
+- Coordinator는 `preflight`, `verify`, `validate-harness`를 에이전트 내부 검사로 실행한다. 사용자에게 명령어·Task ID·Receipt 파일 작성을 요구하지 않고, 통과 결과 또는 막힌 이유만 설명한다.
 
-기계 검사는 `npx solmate-skills preflight TASK-ID`와 `npx solmate-skills verify TASK-ID`를 사용한다. `--strict`는 누락 시 non-zero로 차단한다.
+기계 검사는 Coordinator가 내부적으로 `npx solmate-skills preflight TASK-ID`와 `npx solmate-skills verify TASK-ID`를 사용한다. `--strict`는 누락 시 non-zero로 차단한다. 이 명령은 CI·런타임 어댑터용이며, 사람용 완료 절차가 아니다.
 
-v1 구조화 산출물을 선택한 작업은 `npx solmate-skills validate-harness manifest|message|events <path>`를 warning 모드로 실행한다. message와 events는 `--manifest <path>`가 필수이며, 파일럿 승인 전에는 `--strict`를 기본값으로 강제하지 않는다.
+v1 구조화 산출물을 선택한 작업은 Coordinator가 `npx solmate-skills validate-harness manifest|message|events <path>`를 warning 모드로 실행한다. message와 events는 `--manifest <path>`가 필수이며, 파일럿 승인 전에는 `--strict`를 기본값으로 강제하지 않는다.
 
 ---
 
@@ -48,7 +49,7 @@ v1 구조화 산출물을 선택한 작업은 `npx solmate-skills validate-harne
 - 요구사항·목적을 문서 또는 이슈 기준으로 정리한다.
 - 백로그 항목에 `Work Type`을 `code`, `deploy`, `docs`, `prototype` 중 하나로 기록한다.
 - `code`와 `deploy` 작업은 Context Agent가 `Related Concept Docs`, `Related UI Docs`, `Related HTML Preview`, `Related Technical Docs`, `Related QA Docs`를 모두 읽고 Context Receipt를 백로그에 기록한다.
-- Coordinator는 Context Receipt의 `Required References Read`가 모든 링크 문서를 포함하는지 확인하고 `preflight TASK-ID`를 실행한다.
+- Coordinator는 Context Receipt의 `Required References Read`가 모든 링크 문서를 포함하는지 확인하고 내부적으로 `preflight TASK-ID`를 실행한다. 누락이 있으면 사용자에게 명령을 요청하지 않고 누락 문서와 보류 사유를 설명한다.
 - 코드 작성보다 먼저 HTML UI Preview Gate를 확인한다. `docs/02_UI_Screens/previews/`의 HTML Preview가 없거나 UI 문서에 링크되지 않았거나 사용자 확인 기록이 없으면 구현 계획을 보류하고 `docs-plan` 문서/HTML 보완을 제안한다.
 - 그 다음 UI-First Gate를 확인한다. 화면 구조, 사용자 동선, 데이터 흐름, 로딩·빈 상태·오류 상태가 문서화되지 않았으면 구현 계획을 보류하고 `docs-plan` 또는 `docs-dev` 문서 보완을 제안한다.
 - Pre-Code Technical Brief를 확인한다. 데이터 소스, 최소 필드, mutation, 상태 관리 방식, acceptance criteria가 불명확하면 구현 전에 사용자와 합의한다.
@@ -77,7 +78,7 @@ v1 구조화 산출물을 선택한 작업은 `npx solmate-skills validate-harne
 
 ### Step 5. 구현
 - 승인된 계획대로 구현한다. AGENTS.md·프로젝트 컨벤션(커밋, Zod, Luxon 등)을 따른다.
-- `code`와 `deploy` 작업은 Context Receipt를 먼저 확인한다. 첫 5개 warning 작업은 발견 사항을 기록하고 사용자 확인을 받으며, blocking 전환 후에는 PASS Receipt 없이는 시작하지 않는다. `preflight TASK-ID --strict`가 차단되면 문서·Receipt를 보완한 뒤 재실행한다.
+- `code`와 `deploy` 작업은 Context Receipt를 먼저 확인한다. 첫 5개 warning 작업은 발견 사항을 기록하고 사용자 확인을 받으며, blocking 전환 후에는 PASS Receipt 없이는 시작하지 않는다. 내부 preflight가 차단되면 Coordinator가 문서·Receipt를 보완한 뒤 재실행하며, 사용자에게는 보류 사유와 필요한 결정만 설명한다.
 - Implementation Agent는 승인 범위만 수정하고 Change Receipt를 남긴다. Change Receipt는 독립 검증을 대체하지 않는다.
 - 코드 작성 전 백로그 항목의 `Implementation Preconditions`와 `Acceptance Criteria`를 확인한다. 관련 문서 링크가 비어 있거나 `N/A - 사유`가 부실하면 구현을 보류하고 문서 보완 필요 여부를 사용자에게 확인한다.
 - HTML UI Preview Gate가 통과되지 않았거나 사용자가 HTML Preview를 확인하지 않았다면 구현을 시작하지 않는다.
@@ -91,7 +92,7 @@ v1 구조화 산출물을 선택한 작업은 `npx solmate-skills validate-harne
 
 ## Phase 3: Verify Implementation (Steps 6–10)
 
-`code`와 `deploy` 작업은 Implementation Agent와 분리된 Verification Agent가 이 단계를 수행한다. 검증자는 발견 사항을 직접 수정하지 않고 Verification Receipt로 Coordinator에 반환한다. 수정이 필요하면 Implementation Agent가 처리한 뒤 새 검증을 실행한다.
+`code`와 `deploy` 작업은 Implementation Agent와 분리된 Verification Agent가 이 단계를 수행한다. Change Receipt가 반환되면 Coordinator는 사용자에게 검증 명령을 요청하거나 구현 완료를 선언하지 않고 즉시 `verify-implementation`과 필요한 내부 Receipt 검사를 시작한다. 검증자는 발견 사항을 직접 수정하지 않고 Verification Receipt로 Coordinator에 반환한다. 수정이 필요하면 Implementation Agent가 처리한 뒤 새 검증을 실행한다.
 
 ### Step 6. 목적 부합 검토
 - 구현이 원래 목적과 요구사항에 맞게 동작하는지 확인한다.
@@ -150,7 +151,7 @@ v1 구조화 산출물을 선택한 작업은 `npx solmate-skills validate-harne
 ### Step 17. 배포 가능 퀄리티 최종 검토
 - "이대로 배포해도 될 수준인가?"를 한 번 더 검토한다. 1–16단계에서 누락된 항목이 없는지 확인한다.
 - `code`와 `deploy` 작업은 Verification Receipt에 `Status: PASS`, 실행 명령 결과, 미실행 항목의 사유, QA 문서 또는 PR 상세 근거 링크가 있어야 한다.
-- 첫 5개 warning 작업은 검증 발견 사항을 기록하고 사용자 확인을 받는다. blocking 전환 후 `npx solmate-skills verify TASK-ID --strict`가 통과하지 않으면 Done, PR, merge, publish, deploy를 차단한다.
+- 첫 5개 warning 작업은 Coordinator가 검증 발견 사항을 기록하고 사용자 진행 승인을 받는다. blocking 전환 후 내부 `verify TASK-ID --strict`가 통과하지 않으면 Done, PR, merge, publish, deploy를 차단한다. 어느 경우에도 사용자에게 이 명령 실행을 요구하지 않는다.
 - 최종 검토 시 `Flow Status Block`을 출력하고, 다음 위치가 `Phase 6 — Ship/Handoff`인지 명시한다.
 - 체크: [ ] 독립 Verification Receipt PASS [ ] 검증 근거 링크 존재 [ ] strict verify 통과 [ ] 배포 전 필수 조건 충족 [ ] 롤백·모니터링 고려 여부
 

package/rules-workflow/adapters/claude/solmate-context-reader.md

@@ -5,6 +5,7 @@ tools:
   - Read
   - Glob
   - Grep
+  - Bash
 permissionMode: plan
 ---
 
@@ -14,4 +15,6 @@ Locate and follow `.agent/skills/rules-workflow/resources/agent-harness-contract
 
 Read the target backlog item and every linked Concept, UI, HTML Preview, Technical, and QA reference. Verify that each relative path exists. Extract constraints, decisions, acceptance criteria, and conflicts.
 
+After preparing the receipt, run the available read-only preflight check for the target task. This is an internal agent action: do not ask the user to provide a command, task ID, or receipt content. If the check is blocked, return the missing references and the plain-language reason to the Coordinator.
+
 Do not edit files or implement the task. Return only a complete Context Receipt plus blocking findings. Missing references or an incomplete receipt must be reported as `BLOCKED`.

package/rules-workflow/adapters/claude/solmate-implementer.md

@@ -17,4 +17,4 @@ Locate and follow `.agent/skills/rules-workflow/resources/agent-harness-contract
 
 Do not start without a passing Context Receipt and explicit user approval. Implement only the approved backlog scope and acceptance criteria. Follow project instructions, existing patterns, and the Minimal Implementation Gate.
 
-If a new requirement, document conflict, or unsafe assumption appears, stop and return it to the Coordinator. After implementation, run only the basic checks appropriate to the change and return a complete Change Receipt. Do not claim independent verification.
+If a new requirement, document conflict, or unsafe assumption appears, stop and return it to the Coordinator. After implementation, run only the basic checks appropriate to the change and return a complete Change Receipt. Do not claim independent verification or tell the user that they must run a verification command; the Coordinator starts the independent verification handoff automatically.

package/rules-workflow/adapters/claude/solmate-verifier.md

@@ -16,6 +16,6 @@ You are the read-only Verification Agent in the Solmate agent harness.
 
 Locate and follow `.agent/skills/rules-workflow/resources/agent-harness-contract.md`, especially the Verification Agent and Verification Receipt sections. If the skill is being developed from its source repository, use `rules-workflow/resources/agent-harness-contract.md`.
 
-Independently inspect the target backlog item, accepted Context Receipt, current diff, acceptance criteria, and relevant verify skills. Run the checks that are available without changing project files.
+Independently inspect the target backlog item, accepted Context Receipt, current diff, acceptance criteria, and relevant verify skills. Run the checks that are available without changing project files, including the internal completion Receipt check when the runtime provides it. The Coordinator invokes this role immediately after a Change Receipt; do not ask the user to run `verify`, `verify-implementation`, or any other command.
 
 Do not fix findings, modify source files, or accept the Implementation Agent's claims without evidence. Return a complete Verification Receipt. Any failing command, missing evidence, or unrun required check makes the receipt `FAIL` and returns the task to the Coordinator.

package/rules-workflow/resources/agent-harness-contract.md

@@ -22,6 +22,8 @@ The main conversation owns phase diagnosis, user approval, handoffs, and final s
 - to Done, PR, merge, publish, or deploy without a passing Verification Receipt;
 - past a failed receipt without returning the task to the responsible role.
 
+The Coordinator owns internal harness operation. It resolves the backlog task, runs `preflight`, `verify`, and any opted-in structured validation, then reports results in plain language. It must never tell the user to type an internal CLI command, supply a task ID, or create a Receipt merely to advance a normal feature request.
+
 ### Context Agent
 
 Read-only. Read every linked backlog reference and return a Context Receipt. Do not edit files, run destructive commands, or implement the task.
@@ -62,7 +64,7 @@ The two mandatory failures are always visible in both modes:
 1. a linked required document was not recorded as read;
 2. a code or deploy task has no passing verification evidence.
 
-Run the machine checks with:
+The Coordinator or CI runs the machine checks internally:
 
 ```bash
 npx solmate-skills preflight TASK-000
@@ -73,6 +75,8 @@ npx solmate-skills verify TASK-000 --strict
 
 `--strict` is an alias for `--mode blocking`. The default backlog path is `docs/04_Logic_Progress/00_BACKLOG.md`; override it with `--backlog <path>`.
 
+These commands are runtime and CI interfaces, not the normal human workflow. When a check blocks progress, explain the missing document, evidence, or failed verification and the decision needed from the user.
+
 ## 5. Receipt Contracts
 
 Keep receipt summaries inside the backlog item. Verification details must link to a QA document or PR.
@@ -134,7 +138,7 @@ Rules:
 
 ## 6. Versioned Structured Artifacts
 
-The existing backlog Receipts remain valid. Projects may additionally opt into the v1 manifest, message, and event contracts defined by `agent-harness-v1.schema.json` in this directory.
+The existing backlog Receipts remain valid. Projects may additionally opt into the v1 manifest, message, and event contracts defined by `agent-harness-v1.schema.json` in this directory. The Coordinator or CI manages these artifacts; a normal feature requester does not create or validate them manually.
 
 ```bash
 npx solmate-skills validate-harness manifest _workspace/harness/TASK-000/manifest.json

package/verify-implementation/SKILL.md

@@ -8,15 +8,15 @@ argument-hint: "[선택사항: 특정 verify 스킬 이름]"
 # 구현 검증 (Master)
 
 > **Human Quick Reference**
-> - **When**: Pre-PR or pre-release full check (default verify entry point)
-> - **Invoke**: `/verify-implementation`
+> - **When**: Automatically after feature implementation; also available for an explicit pre-PR or pre-release check
+> - **Invoke**: The Coordinator invokes `/verify-implementation` after a Change Receipt; users do not run harness commands
 > - **Prerequisites**: Changes to verify; runs verify-* skills based on `git diff`
 > - **Next**: Fix failures, then re-run; use individual verify-* skills for scoped checks
 > - **Guide**: project root `USAGE.md` (English default, Korean below; copied on install)
 
 ## 목적
 
-프로젝트에 존재하는 모든 `verify-*` 스킬을 동적으로 탐색하여 순차적으로 실행하고 통합 검증을 수행합니다. 기본 순서를 따르되, 변경 파일과 프로젝트 특성에 따라 해당 없는 스킬은 `N/A - 사유`로 기록합니다. 코드 변경이 있으면 YAGNI/KISS/DRY Gate와 Agent Harness Verification Receipt 통과 여부를 통합 보고서에 반드시 포함합니다.
+프로젝트에 존재하는 모든 `verify-*` 스킬을 동적으로 탐색하여 순차적으로 실행하고 통합 검증을 수행합니다. 기본 순서를 따르되, 변경 파일과 프로젝트 특성에 따라 해당 없는 스킬은 `N/A - 사유`로 기록합니다. 코드 변경이 있으면 YAGNI/KISS/DRY Gate와 Agent Harness Verification Receipt 통과 여부를 통합 보고서에 반드시 포함합니다. 구현이 끝나면 Coordinator가 이 스킬을 즉시 시작하며, 사용자에게 검증 명령 실행을 요구하지 않습니다.
 
 ## 기본 실행 순서
 
@@ -33,7 +33,7 @@ argument-hint: "[선택사항: 특정 verify 스킬 이름]"
 ## 워크플로우
 
 ### Step 0: Flow 위치 확인
-검증을 시작하기 전에 `rules-product`의 `Flow Status Block` 형식으로 현재 위치를 보고합니다. 일반적으로 현재 위치는 `Phase 5 — 품질 검증`이며, 코드 변경이 있으면 Gate에 `YAGNI/KISS/DRY Gate`를 포함합니다. 상세 기준은 `rules-dev`의 Minimal Implementation Gate 정본을 참조합니다.
+검증을 시작하기 전에 `rules-product`의 `Flow Status Block` 형식으로 현재 위치를 보고합니다. 일반적으로 현재 위치는 `Phase 5 — 품질 검증`이며, 코드 변경이 있으면 Gate에 `YAGNI/KISS/DRY Gate`를 포함합니다. 상세 기준은 `rules-dev`의 Minimal Implementation Gate 정본을 참조합니다. Change Receipt가 반환된 `code` 또는 `deploy` 작업에서는 사용자의 별도 요청을 기다리지 않고 이 단계를 시작합니다.
 
 ```
 [Flow]
@@ -62,7 +62,7 @@ Gate: Quality Gate + YAGNI/KISS/DRY Gate 진행 중
 ### Step 3: 순차 실행
 기본 실행 순서대로 각 스킬의 `Workflow`, `Exceptions`, `Related Files`를 파싱하여 개별 검사를 수행합니다. 앞 단계가 Fail이면 뒤 단계는 실행하되, 해당 Fail이 뒤 단계 판단을 왜곡하는 경우 `Blocked - 사유`로 표시합니다.
 
-`code`와 `deploy` 백로그 작업은 `rules-workflow/resources/agent-harness-contract.md`에 따라 Implementation Agent와 분리된 읽기 전용 Verification Agent가 검증한다. 검증자는 발견 사항을 수정하지 않으며, 수정 후에는 새 Verification Agent 실행으로 다시 확인한다.
+`code`와 `deploy` 백로그 작업은 `rules-workflow/resources/agent-harness-contract.md`에 따라 Implementation Agent와 분리된 읽기 전용 Verification Agent가 검증한다. Coordinator는 관련 Task ID를 해석하고 내부 `verify TASK-ID` 검사를 포함해 검증 흐름을 시작한다. 검증자는 발견 사항을 수정하지 않으며, 수정 후에는 새 Verification Agent 실행으로 다시 확인한다. 사람에게 명령어를 제시하는 대신 통과 결과 또는 차단 원인과 필요한 결정을 보고한다.
 
 ### Step 4: 통합 보고서 생성
 PASS/FAIL 통계와 발견된 이슈 목록을 생성합니다.
@@ -76,7 +76,7 @@ PASS/FAIL 통계와 발견된 이슈 목록을 생성합니다.
 - Context Receipt: 관련 문서 전체 확인 및 PASS 여부
 - Verification Receipt: 독립 검증 상태, 명령 결과, 미실행 사유, QA 문서 또는 PR 상세 근거
 
-warning 기간에는 Verification Receipt 발견 사항과 사용자 진행 승인을 보고합니다. blocking 전환 후 PASS Verification Receipt가 없거나 `npx solmate-skills verify TASK-ID --strict`가 실패하면 PR·merge·publish·deploy 차단 항목으로 보고합니다.
+warning 기간에는 Verification Receipt 발견 사항과 사용자 진행 승인을 보고합니다. blocking 전환 후 PASS Verification Receipt가 없거나 Coordinator의 내부 `verify TASK-ID --strict`가 실패하면 PR·merge·publish·deploy 차단 항목으로 보고합니다. 이 내부 명령을 사용자의 완료 체크리스트로 제시하지 않습니다.
 
 ### Step 5: 수정 옵션 제공
 자동 수정 또는 개별 수정을 사용자에게 제안합니다.

package/verify-skills/SKILL.md

@@ -169,6 +169,8 @@ node bin/cli.js validate-harness events /path/to/events.jsonl --manifest /path/t
   - [ ] `install agents`가 `.claude/agents/solmate-*.md`만 추가하고 기존 에이전트를 보존하는가?
   - [ ] `install rules-workflow`와 `install all`이 Claude 어댑터를 함께 설치하는가?
   - [ ] Codex 지침이 지원되지 않는 `.codex/agents/` 형식을 가정하지 않고 공통 계약을 참조하는가?
+  - [ ] 구현 완료 후 Coordinator가 `verify-implementation`과 필요한 Receipt 검사를 내부적으로 시작하도록 workflow와 adapter가 명시하는가?
+  - [ ] README와 USAGE가 `preflight`, `verify`, `validate-harness`를 일반 사용자 명령이 아닌 고급 런타임/CI 인터페이스로 표시하는가?
   - [ ] v1 manifest, message, events fixture가 구조화 검증을 통과하는가?
   - [ ] 불법 상태 전환, 비-Coordinator 전환, 증거 누락, 겹치는 쓰기 소유권이 strict에서 exit 1로 차단되는가?
   - [ ] message와 events 검사가 유효한 manifest 없이 PASS를 반환하지 않는가?