inho-team · qe-framework · v6.5.0

QE Framework
시스템 구조도

Query & Execute — AI와의 모든 상호작용을 두 동작으로 환원하고, 그 사이에 Plan → Spec → Execute → Verify 파이프라인과 SIVS 품질 게이트를 끼워 넣는 Claude Code 플러그인.

SKILLS ···· 165
AGENTS ···· 21
CODING EXPERTS ···· 71
LICENSE ···· MIT

USER SAYS

"뭐 할지"
"그거 해줘"

→

CONTEXTFolder Memory

QUALITYSIVS Loop

LIBRARY165 Skills

→

YOU GET

정밀한 Query
검증된 Result

PSE Chain — 사용자 워크플로우

4-STEP PIPELINE

사용자 동선 4단계 — 큰 작업이든 버그 하나든 같은 파이프라인. 각 단계는 기본 모델이 정해져 있지만 /Qsivs-config로 자유 변경 가능. Qplan이 Micro 규모로 판정하면 로드맵 없이 곧바로 /Qgs로 자동 핸드오프 — 사용자가 규모 판단을 안 해도 됨.

STEP 01 / PLAN

Plan

/Qplan

로드맵·단계·요구사항을 잡는다. 무엇을 만들지 구조화하는 단계.

→

STEP 02 / SPEC

Spec

/Qgs

TASK_REQUEST + VERIFY_CHECKLIST 생성. "정밀한 Query"로 다듬는 단계.

→

STEP 03 / EXECUTE

Execute

/Qatomic-run

Haiku Teammates로 병렬 Wave 실행. 순차 실행은 /Qrun-task 폴백.

→

STEP 04 / VERIFY

Verify

/Qcode-run-task

Test → Review → Fix 품질 루프. 통과할 때까지 반복.

💡 각 단계의 엔진(Claude / Codex)과 모델은 /Qsivs-config로 자유 변경 가능 — 기본값은 위와 같지만 어떤 단계든 다른 엔진·모델로 교체할 수 있다.

Layer Architecture — 6-Layer Stack

SYSTEM STRUCTURE

프레임워크는 6개 레이어로 구성. 위(User)일수록 사용자 가시영역, 아래(Engine Bridge)일수록 실행 기반. 레이어 간 통신은 오직 아티팩트(파일) 경유.

프레임워크는 명확한 6개 레이어로 분리된다. 위 레이어(User)일수록 사용자 가시영역, 아래 레이어(Engine Bridge)일수록 실행 기반. 각 레이어는 자기 책임만 가지며 인접 레이어와 아티팩트(파일)로만 통신한다.

LAYER 01 · INTERFACE
User Interface사용자가 직접 호출하는 진입점. 슬래시 명령(/Qplan, /Qgs…)과 PSE Chain 사용자 동선. 프롬프트 문맥, CLAUDE.md, 세션 입력이 이 레이어에 속한다.
CLAUDE.md · prompts · /Q* commands
LAYER 02 · SKILLS
Skill Library165+ 개의 자기완결 스킬 정의. 각 스킬은 Role / Workflow / Handoff를 담은 Markdown. 사용자 명령이 스킬로 라우팅되어 실행 계획을 수립하지만 구현은 에이전트에 위임.
skills/**/SKILL.md
LAYER 03 · AGENTS
Agent Fleet21개 백그라운드 에이전트(E*). Teammate(Haiku)·Executor(Sonnet)·Supervisor(Sonnet/Opus)의 3계층 책임 분리. 스킬이 위임하는 실제 실행 주체.
agents/E*.md
LAYER 04 · HOOKS
Hook System결정론적 제어 레이어. SessionStart·PreToolUse·PostToolUse·Stop 등 이벤트에 자동 반응해 컨텍스트 주입·권한 게이트·상태 동기화를 수행. LLM 판단과 독립된 rule-based 게이트.
hooks/scripts/*.mjs
LAYER 05 · STATE
State & MemoryUnified State(.qe/state/unified-state.json) 단일 진실 원천 + Folder-Aware Context(.qe/context/). 모든 훅·에이전트가 한 버전의 상태를 공유해 레이스 컨디션 방지.
.qe/state/ · .qe/context/ · .qe/tasks/
LAYER 06 · ENGINE
Engine BridgeSIVS 단계별 엔진 라우팅 추상화. Claude 기본, 선택적으로 codex-plugin-cc를 경유해 Codex 위임. 외부 SDK(OpenAI/Gemini) 직접 호출 없음 — 의존성 격리.
scripts/lib/codex_bridge.mjs

# 레이어 통신은 아티팩트 경유 — 스킬이 에이전트를 부를 때도 파일/상태를 통해
# 훅은 어떤 레이어도 직접 수정하지 않고 상태 레이어에만 쓴다 (deterministic)

SIVS Loop & 3대 지지축

QUALITY GATE + SUPPORT SYSTEMS

SIVS는 PSE 파이프라인 안에서 도는 품질 게이트. Spec → Implement → Verify → Supervise 4단계. Verify(했나?)와 Supervise(잘 했나?)는 다른 일. FAIL이면 REMEDIATION으로 루프 재진입(최대 3회).

SIVS Loop — 품질 게이트

INSIDE STEPS 03 & 04

Spec

Implement

Verify

Supervise

→ PASS
완료 (Done)

→ FAIL
Remediate → Spec 재시도

# 핵심: Supervise 단계가 독립 엔진일 때 "자가 채점" 문제를 회피
# 각 단계는 Claude / Codex 중 자유 라우팅

CORE PRINCIPLE

"Work without a spec is guesswork.
A spec without implementation is intent.
Implementation without verification is hope.
Verification without supervision is confirmation bias."

SPEC → IMPLEMENT

TASK_REQUEST가 구현의 계약이 된다. 계약 없이 실행하면 검증이 불가능.

VERIFY ≠ SUPERVISE

Verify는 "했는가?"(yes/no), Supervise는 "잘 했는가?"(security·quality·docs 전문 평가).

REMEDIATE

FAIL 시 즉석 수정이 아니라 새 spec(REMEDIATION_REQUEST)을 만들어 루프 재진입. 최대 3회.

CROSS-PHASE

Phase N 완료 전에 Phase 1~N-1의 핵심 VERIFY 항목을 재검증. 회귀 방지 게이트.

PILLAR 01

Context Memory Manager

폴더별로 컨텍스트를 분할해 작업 디렉토리와 매칭되는 것만 로드. 단일 CLAUDE.md 대신 .qe/context/ 아래 분산.

컨텍스트 토큰 절약

PILLAR 02

SIVS Loop Engine

Spec → Implement → Verify → Supervise. Multi-Engine 라우팅으로 자가 채점 방지, Supervisor가 PASS/FAIL 판정.

Claude ↔ Codex 독립 라우팅

PILLAR 03

Skills & Agents Library

165 Skills (Q*, M*, coding-experts) + 21 Agents (E*). 상황에 맞게 주입되는 전문 지식 + 실행 주체.

165 skills · 21 agents · 71 experts

Design Philosophies — 5 공리

FOUNDATIONAL AXIOMS

모든 스킬·에이전트·훅이 따르는 5 공리 + 5 의무. 핵심: "토큰 낭비는 드리프트", "병렬이 기본, 순차는 폴백", "Spec 없이 실행 금지".

SIVS 루프 외에도 프레임워크 전반에 스며든 5가지 공리. 모든 스킬·에이전트·훅은 이 공리에 어긋나면 Ttune으로 교정된다.

AXIOM 01

Efficiency = Accuracy

토큰 낭비는 단순 비용이 아니라 드리프트의 근원이다. 불필요한 I/O·중복 읽기는 모델의 집중력을 흩뜨려 잘못된 판단을 유도한다.

적용: ContextMemo · Semantic Compression · 140k/170k 압축 게이트

AXIOM 02

Parallel-First

두 작업 사이에 데이터 의존성이 없으면 기본은 병렬. 순차는 의존성이 명시될 때만의 폴백. 기본값을 뒤집어야 왕복 시간이 줄어든다.

적용: Haiku Wave · 멀티 UUID Qrun-task · 동시 Test+Review

AXIOM 03

Spec-First

Spec 없는 실행은 추측이다. 요청이 모호하면 먼저 TASK_REQUEST를 만들고 실행으로 넘어간다. 긴급 요청에도 최소한의 계약을 요구.

적용: Qplan → Qgs 강제 순서 · Pre-execution Gate

AXIOM 04

Minimal Change

요청된 범위만 수정. 주변 코드의 "보기 좋게" 리팩터링 금지. 버그 수정은 수정만, 한 번의 작업은 한 가지 목적만.

적용: Qcommit atomic 분할 · 리뷰어 경계 감사

AXIOM 05

Evidence-Based

추측하지 않는다. 불확실하면 파일을 읽어 확인. "있을 것 같다"가 아니라 "line 42에 있다". 메모리·캐시 주장도 현재 상태와 대조.

적용: grep·Read 사전 확인 · VERIFY_CHECKLIST yes/no 엄격 판정

▸ MANDATORY OBLIGATIONS (5) — 펼치기

Respect the spec — TASK_REQUEST 없이 실행 금지. 없으면 먼저 생성.
Do not skip verification — VERIFY_CHECKLIST 미완료 상태에서 complete 금지.
Parallel first — 의존 없는 두 작업은 반드시 병렬로.
Remediation is a new spec — ad-hoc 수정 금지, REMEDIATION_REQUEST 생성.
The loop is the product — 기능·스킬·에이전트는 수단, spec→구현→검증 루프가 목적.

Multi-Engine Routing

/Qsivs-config

SIVS 4단계 각각을 Claude 또는 Codex에 독립 할당 가능. 동일 엔진이 자기 결과를 채점하는 "자가 평가 편향" 회피. 기본값은 모두 Claude.

SIVS의 각 단계(Spec/Implement/Verify/Supervise)에 Claude 또는 Codex를 독립 할당. 동일 엔진이 자기 결과를 채점하는 문제 회피.

SPEC

Claude

or Codex

IMPLEMENT

Codex

or Claude

VERIFY

Claude

or Codex

SUPERVISE

Codex

or Claude

$ /Qsivs-config implement codex --effort high
$ /Qsivs-config set --all claude # 기본값 복원

Folder-Aware Context Memory

.qe/context/

프로젝트 컨텍스트를 폴더별로 분할 저장. 작업 디렉토리와 매칭되는 파일만 자동 로드 — 단일 CLAUDE.md 방식 대비 컨텍스트 토큰 절약(프로젝트별 상이, docs/BENCHMARK.md로 측정).

# 작업 위치: src/frontend/components/Button.tsx
.qe/context/
├── _registry.json      # 폴더 ↔ 컨텍스트 매핑
├── root.md             # 항상 로드 (프로젝트 전역 규칙)
├── frontend.md          # ✔ src/frontend/** 매칭 → 로드
├── backend.md           # ✘ 스킵
└── scripts.md           # ✘ 스킵
RESULT → fewer context tokens (varies by project)

Skill Library — 165 Skills

Q* + M* + coding-experts

165+ 스킬을 12 카테고리로 분류. PSE Core, Meta, PM, Docs/Writing, Coding Experts(71명), QA/Testing, Data/Analysis 등. 각 스킬은 frontmatter + Role + Workflow + Handoff의 4-part 표준.

Backend

Django, FastAPI, Spring, Rails, NestJS…

Frontend

React, Vue, Next.js, Flutter, Angular…

Languages

Python, Rust, Go, TS, Kotlin, Swift…

Infra

K8s, Terraform, AWS, CI/CD, SRE…

Quality

Code review, security, debugging, E2E…

Data/ML

RAG, fine-tuning, ML pipelines, Spark…

Core Q-Skills · 주요 명령어

/Qinit 초기화
/Qplan 계획
/Qgs 스펙생성
/Qatomic-run 병렬실행
/Qrun-task 순차실행
/Qcode-run-task 검증
/Qcontext 컨텍스트
/Qsivs-config 라우팅
/Qrefresh 갱신
/Qmemory 메모리
/Qcompact 압축
/Qcommit 커밋
/Qbranch 브랜치
/Qarchive 아카이브
/Qmap-codebase 맵
/Qpm-prd PRD
/Qpm-roadmap 로드맵
/Qpm-okr OKR
/Qfact-checker 검증
/Qdocx 문서
/Qpptx 슬라이드
/Qxlsx 표
/Qfind-skills 검색
/Qhelp 도움말

SKILL CATEGORIES — 12 클러스터

165+ 스킬을 역할별로 12개 카테고리로 분류. 각 카테고리는 하나의 사용자 의도 패턴에 대응하며 IntentGate가 의도→카테고리→스킬 경로로 라우팅한다.

① PSE Core

사용자 워크플로우 4단계 — 기획·스펙·실행·검증의 뼈대.

/Qplan · /Qgs · /Qatomic-run · /Qcode-run-task

② Meta (M*)

프레임워크 자체를 관리 — 버전·스킬 생성·감사·테스트.

/Mbump · /Mcreate-skill · /Mqe-audit · /Mtest-skill

③ PM / Strategy

제품·전략 문서 — PRD, OKR, 로드맵, 회고, GTM.

/Qpm-prd · /Qpm-okr · /Qpm-roadmap · /Qpm-retro

④ Docs / Writing

문서·이메일·논문·프레젠테이션 작성과 정제.

/Qdocx · /Qpptx · /Qwriting-clearly · /Qdoc-comment

⑤ Coding Experts

언어·프레임워크별 모범사례 71 전문가 (Java·Go·Rust…).

Qjava-specialist · Qreact · Qfastapi · Qkotlin…

⑥ QA / Testing

테스트 계획·시나리오·회귀·보안·시각 QA.

/Qqa-test-planner · /Qscenario-test · /Qvisual-qa

⑦ Data / Analysis

데이터 탐색·통계·금융 분석·DB 스키마 설계.

/Qdata-analysis · /Qfinance-analyst · /Qdatabase-schema-designer

⑧ Research / Content

심층 리서치·사실 검증·출처 검증·콘텐츠 작성.

Edeep-researcher · /Qfact-checker · /Qsource-verifier

⑨ Dev Env / Integration

MCP 설정·Chrome·Stitch·Codex 연동·시크릿 관리.

/Qmcp-setup · /Qchrome · /Qstitch-cli · /Qsecret

⑩ Browser / UI

브라우저 자동화·UI 디자인·스타일 감사·시각 리디자인.

/Qagent-browser · /Qfrontend-design · /Qdesign-audit

⑪ Academic / Thesis

논문 작성·리뷰 응답·연구 계획·세미나 준비.

/Qgrad-paper-write · /Qgrad-paper-review · /Qgrad-research-plan

⑫ Utility / Flow

세션 관리·컨텍스트·이관·정리·자동화 루프.

/Qcompact · /Qresume · /Qcommit · /Qcron · /Qutopia ⚠

SKILL COMPOSITION

한 개의 SKILL.md는 어떻게 생겼는가

모든 스킬은 동일한 4-part 구조를 따른다. 이 표준 덕분에 신규 스킬을 /Mcreate-skill로 자동 생성할 수 있고, 라우팅·실행 엔진이 어느 스킬이든 동일한 패턴으로 다룰 수 있다.

PART 01 — FRONTMATTER (YAML)

---
name: Qexample
description: One-line description. Use when user says "keyword1", "keyword2".
recommendedModel: sonnet         # haiku | sonnet | opus
invocation_trigger: When to invoke. Typical user phrasing.
---

PART 02 — ROLE (한 문단)

# Skill Name

## Role
You are [X]. Your job is to [Y]. [Z constraint].
Match the [action] to the [context], not the other way around.

PART 03 — WORKFLOW (Steps)

## Workflow

### Step 1: [Discovery / Context Acquisition]
- 무엇을 읽고 무엇을 결정할지

### Step 2: [Draft / Execute]
- 실제 작업 (파일 생성·분석·리네임 등)

### Step 3: [Verification / Approval]
- AskUserQuestion으로 사용자 확인 (MANDATORY)

### Step N: [Handoff]
- 다음 스킬로 넘기는 표준 포맷

PART 04 — HANDOFF (응답 마지막 블록)

Phase {X}: {PhaseName} — Complete

Roadmap
  [x] Phase 1: {Name1}
  [>] Phase {X+1}: {NextName}

PSE: [x] Plan [x] Spec [x] Execute [x] Complete

다음: /Qgs Phase {X+1}: {짧은 별칭}

# Handoff가 없으면 스킬 실행 실패로 간주 — 사용자가 다음 단계로 이동할 수 없다
# 짧은 별칭만 허용, Phase 전체 설명 복사 금지 (feedback_handoff_brevity 규칙)

Agent Fleet & Model Tiering

21 AGENTS · 3 TIERS

21개 백그라운드 에이전트(E* 접두사) + 3 모델 티어 — Haiku(빠름·병렬), Sonnet(균형·구현), Opus(깊이·전략). Delegation Enforcer 훅이 용도에 맞는 모델을 자동 주입.

Agent Fleet · E* Agents (21)

Etask-executor — 복잡한 체크리스트 실행
Eqa-orchestrator — 테스트·리뷰·수정 루프
Esupervision-orchestrator — 도메인 감독자 라우팅
Ecode-reviewer — 코드 리뷰
Ecode-test-engineer — 테스트 작성
Ecommit-executor — AI 흔적 없는 커밋
Erefresh-executor — 프로젝트 분석·컨텍스트 갱신
Edeep-researcher — 다중 소스 리서치
Esecurity-officer — diff 보안 감사
Ecompact-executor — 컨텍스트 윈도우 관리
Epm-planner — PRD·로드맵·문서
+ 10 more — 아카이빙·프로파일링·핸드오프…

TIER 01 · FAST

Haiku

단순·병렬 작업

Wave Teammates
아카이빙 / 데이터 갱신

TIER 02 · BALANCED

Sonnet

코드 구현

Etask-executor
Ecode-reviewer

TIER 03 · DEEP

Opus

전략·아키텍처

/Qplan
Edeep-researcher

# Delegation Enforcer가 pre-tool-use 훅으로 올바른 모델을 자동 주입
# 토큰 압박 시: 140k → Ecompact-executor 트리거, 170k → 강제 압축

Hook System — 결정론적 제어 레이어

DETERMINISTIC CONTROL

9종 이벤트 훅(SessionStart·PreToolUse·PostToolUse·Stop 등)으로 LLM 판단과 독립된 게이트 제공 — 컨텍스트 주입·권한 체크·상태 동기화·압축 트리거를 결정론적으로 처리.

Hook은 Claude 라이프사이클의 결정론적 실행 지점 — 프롬프트가 "제안"이라면 Hook은 "강제"다.

모델 라우팅 — Delegation Enforcer가 에이전트별 recommendedModel 자동 주입
중복 I/O 차단 — ContextMemo로 같은 파일 재읽기 방지
자동 압축 — 140k 토큰 돌파 시 Ecompact 트리거, 170k에서 강제
파이프라인 지속성 — Stop 시 task 상태 보존, 재시작 시 이어서

SESSION LIFECYCLE

▶ SessionStart

QE: _registry.json 로드
폴더 컨텍스트 주입

│

↺ Main Loop

(오른쪽 상세 참조)

│

📦 PreCompact

QE: 140k → Ecompact
170k → 강제 압축

│

⏹ SessionEnd

QE: 작업 기록 / archive

MAIN CONVERSATION LOOP

📝 HOOK

UserPromptSubmit

사용자 프롬프트 수신 · 전처리 주입 가능

↓

Claude 판단

답변 생성 or Tool 호출 결정

↓

🔁 TOOL EXECUTION LOOP · Tool 쓸 때마다 반복

① HOOK

PreToolUse

Delegation Enforcer · ContextMemo · Security Gate

↓

② RUN

Tool 실행

Bash · Edit · Write · Read · Grep · Task

↓

③ HOOK

PostToolUse

감사 로그 · 자동 포맷 · 린트

↺ 결과가 Claude 컨텍스트로 반환 → 더 필요하면 ①부터 다시

↓

🛑 HOOK

Stop

Persistent Mode가 파이프라인 중단 차단

EXIT CODE 프로토콜

exit 0

성공 — 계속 진행.
stdout의 JSON이 있으면 파싱되어 allow / additionalContext 주입에 사용.

exit 2

결정론적 BLOCK.
stderr 메시지를 Claude에게 반환. ContextMemo가 중복 읽기 차단할 때 이 방식.

exit N

기타 에러 — non-blocking.
verbose 모드에서만 stderr 표시, 실행은 계속.

# Hooks run with user permissions
# No sandbox — 스크립트는 신중히

QE Framework 특수 훅 · What happens at each point

훅 이름	이벤트	동작	결과
Delegation Enforcer	PreToolUse	작업 종류에 맞는 모델(Haiku / Sonnet / Opus)을 자동 주입. 예: /Qplan은 Opus로, Wave Teammate는 Haiku로.	inject · exit 0
ContextMemo	PreToolUse (Read)	이미 읽은 파일을 중복으로 다시 읽으려 하면 훅 레벨에서 차단. 토큰 낭비 방지.	BLOCK · exit 2
Folder Context Loader	SessionStart	작업 디렉토리와 .qe/context/_registry.json을 매칭, root.md + 해당 폴더 컨텍스트만 주입.	inject ctx · exit 0
Auto-compaction Trigger	PreCompact	140k 토큰 도달 시 Ecompact-executor 자동 호출, 170k 초과 시 강제 압축 집행.	spawn agent
Persistent Mode	Stop	PSE Chain 진행 중이면 Claude가 중간에 응답 종료하는 것을 차단. SIVS Loop 끝까지 실행 강제.	BLOCK · exit 2
Commit Trace Cleaner	PreToolUse (Bash: git commit)	Ecommit-executor와 연동 — 커밋 메시지의 AI 흔적 제거, 규약 준수 검사.	allow / deny
Context Refresh Guard	PostToolUse (Edit/Write)	파일 수정 후 해당 폴더 컨텍스트의 staleness 체크, 필요 시 /Qrefresh 트리거.	trigger
Security Gate	PreToolUse (Bash)	rm -rf /, force push to main, curl \| sh 등 위험 패턴 하드 블록.	BLOCK · exit 2

End-to-End Flow — 한 번의 질의가 도는 경로

USER QUERY → FINAL RESPONSE

한 번의 사용자 쿼리가 프레임워크의 6 레이어를 어떻게 통과하는지 전체 경로 스냅샷 — 프롬프트 수신부터 최종 응답까지 어떤 훅·스킬·에이전트가 언제 개입하는지 한눈에.

사용자가 한 줄 입력하고 검증된 응답을 받기까지, Context·Hook·PSE Chain·SIVS Loop가 실제로 어떤 순서로 맞물려 도는지를 한 장의 플로우차트로 정리. 분기(◆)에서 경로가 갈라지고, 실패 시 이전 단계로 루프백된다.

MAIN 단계

HOOK 개입

CONTEXT 상태

분기 / 판정

━ 실선: 실행 · ┄ 점선: 참조/루프백

💡 다이어그램의 "기본 Opus/Sonnet/Haiku"는 디폴트일 뿐 — 각 PSE 단계의 엔진(Claude/Codex)과 모델은 /Qsivs-config로 언제든 재라우팅 가능.

flowchart TD USER["👤 USER
버그 고쳐줘"]:::terminal H_PROMPT["UserPromptSubmit 훅"]:::hook H_SESSION["SessionStart 훅"]:::hook H_PRE["PreToolUse 훅
· Delegation Enforcer
· ContextMemo
· Security Gate"]:::hook H_POST["PostToolUse 훅
· 감사 로그 · 자동 포맷"]:::hook H_COMPACT["PreCompact 훅"]:::hook H_STOP["Stop 훅"]:::hook H_END["SessionEnd 훅"]:::hook C_CTX["폴더 컨텍스트
root.md + folder.md
매칭 컨텍스트만 로드"]:::ctx C_MEMO["읽은 파일 캐시"]:::ctx C_TOKEN["토큰 사용량 모니터"]:::ctx SUBMIT["프롬프트 수신"]:::main CTXLOAD["Folder Context Loader
작업 폴더 매칭 로드"]:::main CLAUDE["Claude 처리 시작"]:::main PLAN["① Plan · /Qplan
기본 Opus"]:::main SPEC["② Spec · /Qgs
기본 Sonnet"]:::main EXEC["③ Execute · /Qatomic-run
기본 Haiku Wave"]:::main VERIFY["④ Verify · /Qcode-run-task
기본 Sonnet"]:::main TCALL["Tool Call 발생
Bash · Edit · Write · Read"]:::main CHECK{"중복 보안 위험
차단 필요?"}:::decision BLOCK["exit 2 BLOCK
Claude에게 사유 반환"]:::block TEXEC["Tool 실행"]:::main POSTLOG["결과 가공
감사 로그 · 포맷"]:::main SIVS{"SIVS 판정"}:::decision TOKEN{"토큰 임계치?"}:::decision COMPACT["Ecompact-executor
자동 압축 실행"]:::main STOP{"Stop 시도
파이프라인 진행중?"}:::decision PERSIST["Persistent Mode BLOCK"]:::block ARCHIVE["세션 아카이브
컨텍스트 보존"]:::main RESULT["✅ 검증된 응답
버그 수정 + 테스트 + 리뷰 완료"]:::terminal USER --> SUBMIT H_PROMPT -.-> SUBMIT SUBMIT --> CTXLOAD H_SESSION -.-> CTXLOAD C_CTX -.-> CTXLOAD CTXLOAD --> CLAUDE CLAUDE --> PLAN PLAN --> SPEC SPEC --> EXEC EXEC -->|Tool 필요| TCALL H_PRE -.-> TCALL C_MEMO -.-> CHECK TCALL --> CHECK CHECK -->|YES 차단| BLOCK CHECK -->|NO 통과| TEXEC TEXEC --> POSTLOG H_POST -.-> POSTLOG POSTLOG -.->|다음 Tool Call| TCALL POSTLOG --> VERIFY BLOCK --> VERIFY VERIFY --> SIVS SIVS -->|FAIL Remediate| SPEC SIVS -->|PASS| TOKEN C_TOKEN -.-> TOKEN TOKEN -->|140k 이상 자동| COMPACT TOKEN -->|170k 이상 강제| COMPACT TOKEN -->|140k 미만| STOP H_COMPACT -.-> COMPACT COMPACT --> STOP H_STOP -.-> STOP STOP -->|진행중| PERSIST PERSIST -.->|계속 실행| EXEC STOP -->|완료| ARCHIVE H_END -.-> ARCHIVE ARCHIVE --> RESULT classDef main fill:#18212d,stroke:#3a4a60,stroke-width:1px,color:#dce4ef classDef hook fill:#2a1d08,stroke:#fbbf24,stroke-width:1px,color:#fbbf24 classDef ctx fill:#0a1e2a,stroke:#7dd3fc,stroke-width:1px,color:#7dd3fc classDef decision fill:#2a0e20,stroke:#f472b6,stroke-width:1.5px,color:#f472b6 classDef terminal fill:#0a2a1d,stroke:#6ee7b7,stroke-width:2px,color:#6ee7b7 classDef block fill:#2a0e14,stroke:#fb7185,stroke-width:1px,color:#fb7185

CONTEXT

폴더별 선택 로드
읽은 파일 캐시
토큰 자동 압축

HOOKS (7)

SessionStart · End
Pre·PostToolUse
PreCompact · Stop

PIPELINE

Plan → Spec
Execute → Verify
(+ Inner Tool Loop)

DECISIONS (4)

Tool 차단
SIVS PASS/FAIL
토큰 임계 · Stop