selfish-pipeline 1.0.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "name": "selfish-pipeline",
+  "owner": {
+    "name": "jhlee0409",
+    "email": "relee6203@gmail.com"
+  },
+  "metadata": {
+    "description": "Claude Code 전용 자동화 파이프라인 — spec → plan → tasks → implement → review → clean",
+    "version": "1.0.0"
+  },
+  "plugins": [
+    {
+      "name": "selfish",
+      "source": "./",
+      "description": "Claude Code 전용 자동화 파이프라인. spec → plan → tasks → implement → review → clean 전체 개발 사이클을 자동화합니다.",
+      "version": "1.0.0",
+      "category": "automation",
+      "tags": ["pipeline", "automation", "spec", "plan", "implement", "review", "critic-loop"]
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "name": "selfish",
+  "version": "1.0.0",
+  "description": "Claude Code 전용 자동화 파이프라인. spec → plan → tasks → implement → review → clean 전체 개발 사이클을 자동화합니다.",
+  "author": { "name": "jhlee0409", "email": "relee6203@gmail.com" },
+  "homepage": "https://github.com/jhlee0409/selfish-pipeline",
+  "repository": "https://github.com/jhlee0409/selfish-pipeline",
+  "license": "MIT",
+  "keywords": ["pipeline", "automation", "spec", "plan", "implement", "review", "critic-loop"],
+  "commands": "./commands/",
+  "hooks": "./hooks/hooks.json"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 jhlee0409
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MIGRATION.md

@@ -0,0 +1,100 @@
+# Migration Guide: install.sh → Plugin
+
+> 기존 `git clone` + `install.sh` 방식에서 Claude Code 플러그인 방식으로 마이그레이션하는 가이드입니다.
+
+## 변경 요약
+
+| 항목 | 이전 | 이후 |
+|------|------|------|
+| 설치 | `git clone` + `./install.sh` | `/plugin install <url>` |
+| 커맨드 구분자 | `.` (`/selfish.spec`) | `:` (`/selfish:spec`) |
+| 커맨드 위치 | `~/.claude/commands/selfish.*.md` | 플러그인 내 `commands/*.md` |
+| Hook 스크립트 | `<project>/.claude/hooks/*.sh` | 플러그인 내 `scripts/*.sh` |
+| Hook 설정 | `<project>/.claude/settings.json` | 플러그인 내 `hooks/hooks.json` |
+| 설정 파일 | `.claude/selfish.config.md` (변경 없음) | `.claude/selfish.config.md` (변경 없음) |
+
+## 마이그레이션 절차
+
+### 1. 기존 파일 정리
+
+```bash
+# 기존 커맨드 파일 삭제 (유저 레벨)
+rm -f ~/.claude/commands/selfish.*.md
+
+# 기존 hook 스크립트 삭제 (프로젝트 레벨)
+rm -f .claude/hooks/session-start-context.sh
+rm -f .claude/hooks/pre-compact-checkpoint.sh
+rm -f .claude/hooks/track-selfish-changes.sh
+rm -f .claude/hooks/selfish-stop-gate.sh
+rm -f .claude/hooks/selfish-pipeline-manage.sh
+```
+
+### 2. settings.json에서 selfish hook 제거
+
+`.claude/settings.json`에서 selfish 관련 hook 항목을 제거합니다.
+플러그인이 자체 `hooks.json`으로 hook을 등록하므로 settings.json에서의 수동 설정이 불필요합니다.
+
+제거 대상 (settings.json 내):
+- `SessionStart` → `session-start-context.sh`
+- `PreCompact` → `pre-compact-checkpoint.sh`
+- `PostToolUse` → `track-selfish-changes.sh`
+- `Stop` → `selfish-stop-gate.sh`
+
+> 다른 프로젝트 고유 hook이 settings.json에 있다면 그것은 유지하세요.
+
+### 3. 플러그인 설치
+
+```bash
+npx selfish-pipeline
+```
+
+또는 수동으로:
+
+```bash
+claude plugin marketplace add jhlee0409/selfish-pipeline
+claude plugin install selfish@selfish-pipeline --scope user
+```
+
+기존 `install.sh`의 `--commands-only`에 해당하는 것은 **User** 스코프, 팀 공유는 **Project** 스코프입니다.
+
+### 4. 커맨드명 변경
+
+모든 커맨드의 구분자가 `.`에서 `:`로 변경되었습니다:
+
+```text
+# 이전
+/selfish.auto "기능 설명"
+/selfish.spec "기능 설명"
+/selfish.plan
+
+# 이후
+/selfish:auto "기능 설명"
+/selfish:spec "기능 설명"
+/selfish:plan
+```
+
+### 5. 설정 파일 확인
+
+`.claude/selfish.config.md`는 **변경 없이 그대로 사용 가능**합니다.
+
+신규 프로젝트라면 `/selfish:init`으로 자동 생성할 수 있습니다.
+
+## 변경되지 않는 것
+
+- `.claude/selfish.config.md` 파일 형식 및 경로
+- `specs/{feature}/` 아티팩트 경로
+- `memory/` 참조 (checkpoint, principles, research, decisions)
+- `.selfish-*` 상태 파일 경로
+- `git tag selfish/pre-*` 안전 태그
+- hook 스크립트 내부 로직
+
+## FAQ
+
+**Q: 기존 프로젝트의 `.claude/selfish.config.md`를 다시 만들어야 하나요?**
+A: 아니요. 설정 파일 형식은 동일합니다. 그대로 사용하세요.
+
+**Q: 여러 프로젝트에서 사용 중인데, 각 프로젝트마다 마이그레이션해야 하나요?**
+A: 플러그인은 한 번만 설치하면 됩니다. 각 프로젝트에서는 기존 `.claude/hooks/*.sh`와 settings.json의 selfish hook 항목만 정리하면 됩니다.
+
+**Q: 이전 버전과 플러그인을 동시에 사용할 수 있나요?**
+A: 권장하지 않습니다. 커맨드명이 다르므로 (`/selfish.spec` vs `/selfish:spec`) 충돌은 없지만, hook이 중복 등록될 수 있습니다.

package/README.md

@@ -0,0 +1,195 @@
+# Selfish
+
+> Claude Code 전용 자동화 파이프라인 시스템
+
+기능 설명 하나로 **spec → plan → tasks → implement → review → clean** 전체 개발 파이프라인을 자동 실행합니다.
+
+## 특징
+
+- **외부 의존성 제로**: 순수 마크다운 프롬프트 + bash hook
+- **프로젝트 독립적**: `selfish.config.md`로 어떤 프로젝트에도 적용 가능
+- **물리적 CI 게이트**: Stop hook으로 CI 미통과 시 응답 종료 자체를 차단
+- **Critic Loop**: 각 단계에서 자기비판을 통한 산출물 품질 보장
+- **Agent Teams**: 독립 태스크를 병렬 서브에이전트로 동시 실행
+- **세션 연속성**: 컨텍스트 압축/세션 중단 시에도 체크포인트로 복원
+
+## 요구사항
+
+- [Claude Code](https://claude.ai/code) CLI (플러그인 시스템 지원 버전)
+- Git
+- `jq` (PostToolUse hook에서 사용)
+
+## 설치
+
+```bash
+npx selfish-pipeline
+```
+
+마켓플레이스 등록 + 플러그인 설치를 자동 수행하며, 설치 범위(user / project / local)를 인터랙티브하게 선택합니다.
+
+### 수동 설치
+
+```bash
+# 1. 마켓플레이스 등록
+claude plugin marketplace add jhlee0409/selfish-pipeline
+
+# 2. 플러그인 설치 (스코프 선택)
+claude plugin install selfish@selfish-pipeline --scope user      # 개인 전체
+claude plugin install selfish@selfish-pipeline --scope project   # 팀 공유
+claude plugin install selfish@selfish-pipeline --scope local     # 이 프로젝트만
+```
+
+### 설치 후 프로젝트 초기 설정
+
+```text
+/selfish:init                  # 프로젝트 구조 자동 분석
+/selfish:init nextjs-fsd       # Next.js + FSD 프리셋 사용
+```
+
+> 기존 `git clone` + `install.sh` 방식에서 마이그레이션하는 경우 [MIGRATION.md](./MIGRATION.md)를 참고하세요.
+
+## 설정
+
+`/selfish:init` 실행 후 `.claude/selfish.config.md`를 프로젝트에 맞게 수정합니다:
+
+```yaml
+# CI 명령어
+ci: "yarn ci"
+gate: "yarn typecheck && yarn lint"
+
+# 아키텍처
+style: "FSD"
+layers: [app, views, widgets, features, entities, shared, core]
+import_rule: "상위 계층은 하위 계층만 import 가능"
+
+# 프레임워크
+name: "Next.js 14"
+client_directive: "'use client'"
+```
+
+## 커맨드
+
+### Full Auto (권장)
+
+```text
+/selfish:auto "사용자 인증 기능 추가"
+```
+
+spec → plan → tasks → implement → review → clean 전체를 자동 실행합니다.
+
+### 개별 실행
+
+| 커맨드 | 역할 | Critic |
+|--------|------|--------|
+| `/selfish:spec` | 기능 명세서 생성 | 1회 |
+| `/selfish:clarify` | 명세 모호성 해소 | - |
+| `/selfish:plan` | 구현 설계 | 3회 |
+| `/selfish:tasks` | 태스크 분해 | 1회 |
+| `/selfish:analyze` | 아티팩트 정합성 검증 | - |
+| `/selfish:implement` | 코드 구현 실행 | - |
+| `/selfish:review` | 코드 리뷰 | 1회 |
+| `/selfish:debug` | 버그 진단/수정 | 2회 |
+| `/selfish:architect` | 아키텍처 분석 | 3회 |
+| `/selfish:security` | 보안 스캔 | - |
+| `/selfish:research` | 기술 리서치 | - |
+| `/selfish:principles` | 프로젝트 원칙 관리 | - |
+| `/selfish:checkpoint` | 세션 상태 저장 | - |
+| `/selfish:resume` | 세션 복원 | - |
+| `/selfish:init` | 프로젝트 초기 설정 | - |
+
+### 파이프라인 흐름
+
+```text
+/selfish:spec "기능 설명"  →  specs/{feature}/spec.md
+          ↓
+/selfish:clarify (선택)    →  spec.md 인라인 업데이트
+          ↓
+/selfish:plan              →  plan.md + research.md
+          ↓
+/selfish:tasks             →  tasks.md
+          ↓
+/selfish:analyze (선택)    →  정합성 보고서
+          ↓
+/selfish:implement         →  코드 구현 (Phase별 CI 게이트)
+          ↓
+/selfish:review (선택)     →  리뷰 보고서
+```
+
+## 핵심 메커니즘
+
+### Critic Loop
+
+각 단계에서 산출물을 자기비판합니다. 형식적 "PASS"를 방지하는 4가지 필수 원칙:
+
+1. **최소 발견 수**: 기준당 최소 1개의 우려/검증 근거
+2. **체크리스트 응답**: "PASS" 한 단어 금지, 구체적 답변 필수
+3. **Adversarial Pass**: 매 회차 "실패 시나리오 1가지" 필수
+4. **정량적 근거**: "N개 중 M개 확인" 형태의 데이터 제시
+
+### 3단계 Phase 게이트
+
+Implement 중 각 Phase 완료 시:
+
+1. **CI 게이트**: `{config.gate}` 실행 (3회 실패 → 중단)
+2. **Mini-Review**: 변경 파일별 정량적 품질 점검
+3. **Auto-Checkpoint**: 세션 상태 저장 (중단 시 복원용)
+
+### Stop Gate Hook
+
+파이프라인 활성 중 CI 미통과 시 `exit 2`로 Claude의 응답 종료를 물리적으로 차단합니다.
+
+## Hook 설명
+
+| Hook | 이벤트 | 역할 |
+|------|--------|------|
+| `session-start-context.sh` | SessionStart | 파이프라인 상태 복원 |
+| `pre-compact-checkpoint.sh` | PreCompact | 컨텍스트 압축 전 체크포인트 |
+| `track-selfish-changes.sh` | PostToolUse | 파일 변경 추적, CI 무효화 |
+| `selfish-stop-gate.sh` | Stop | CI 게이트 강제 |
+| `selfish-pipeline-manage.sh` | (내부 호출) | 파이프라인 상태 플래그 관리 |
+
+## 디렉토리 구조
+
+```text
+selfish-pipeline/
+├── .claude-plugin/
+│   └── plugin.json              # 플러그인 매니페스트
+├── bin/
+│   └── cli.mjs                  # npx 인터랙티브 인스톨러
+├── commands/                    # 16개 커맨드
+│   ├── auto.md                  # Full Auto 파이프라인
+│   ├── spec.md                  # 기능 명세서
+│   ├── plan.md                  # 구현 설계
+│   ├── tasks.md                 # 태스크 분해
+│   ├── implement.md             # 코드 구현
+│   ├── review.md                # 코드 리뷰
+│   ├── debug.md                 # 버그 진단
+│   ├── architect.md             # 아키텍처 분석
+│   ├── security.md              # 보안 스캔
+│   ├── analyze.md               # 정합성 검증
+│   ├── clarify.md               # 명세 모호성 해소
+│   ├── research.md              # 기술 리서치
+│   ├── principles.md            # 원칙 관리
+│   ├── checkpoint.md            # 세션 저장
+│   ├── resume.md                # 세션 복원
+│   └── init.md                  # 프로젝트 초기 설정
+├── hooks/
+│   └── hooks.json               # hook 이벤트 등록
+├── scripts/                     # 5개 bash hook 스크립트
+│   ├── session-start-context.sh
+│   ├── pre-compact-checkpoint.sh
+│   ├── track-selfish-changes.sh
+│   ├── selfish-stop-gate.sh
+│   └── selfish-pipeline-manage.sh
+├── templates/
+│   ├── selfish.config.template.md   # 프로젝트 설정 템플릿
+│   └── selfish.config.nextjs-fsd.md # Next.js + FSD 예시
+├── package.json                 # npx 실행용
+├── README.md
+├── MIGRATION.md                 # 기존 사용자 마이그레이션 가이드
+└── LICENSE
+```
+
+## 라이선스
+
+MIT

package/bin/cli.mjs

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+import { createInterface } from "node:readline/promises";
+import { execSync } from "node:child_process";
+import { stdin, stdout, exit } from "node:process";
+
+const GITHUB_REPO = "jhlee0409/selfish-pipeline";
+const MARKETPLACE_NAME = "selfish-pipeline";
+const PLUGIN_NAME = "selfish";
+
+const SCOPES = [
+  {
+    key: "1",
+    name: "user",
+    label: "User (개인 전체 프로젝트)",
+    desc: "~/.claude/settings.json",
+  },
+  {
+    key: "2",
+    name: "project",
+    label: "Project (팀 공유, git 커밋 가능)",
+    desc: ".claude/settings.json",
+  },
+  {
+    key: "3",
+    name: "local",
+    label: "Local (이 프로젝트만, gitignore)",
+    desc: ".claude/settings.local.json",
+  },
+];
+
+function run(cmd) {
+  try {
+    execSync(cmd, { stdio: "inherit" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function main() {
+  console.log();
+  console.log("  Selfish Pipeline — Claude Code Plugin Installer");
+  console.log("  ================================================");
+  console.log();
+
+  // claude CLI 존재 확인
+  try {
+    execSync("claude --version", { stdio: "pipe" });
+  } catch {
+    console.error("  ✗ Claude Code CLI가 설치되어 있지 않습니다.");
+    console.error("    https://claude.ai/code 에서 설치하세요.");
+    exit(1);
+  }
+
+  const rl = createInterface({ input: stdin, output: stdout });
+
+  try {
+    console.log("  설치 범위를 선택하세요:\n");
+    for (const s of SCOPES) {
+      console.log(`    ${s.key}) ${s.label}`);
+      console.log(`       → ${s.desc}`);
+    }
+    console.log();
+
+    const answer = await rl.question("  선택 [1/2/3] (기본: 1): ");
+    const choice = answer.trim() || "1";
+    const scope = SCOPES.find((s) => s.key === choice);
+
+    if (!scope) {
+      console.error("\n  ✗ 잘못된 선택입니다.");
+      exit(1);
+    }
+
+    console.log(`\n  → ${scope.label} 스코프로 설치합니다...\n`);
+
+    // Step 1: 마켓플레이스 등록
+    console.log("  [1/2] 마켓플레이스 등록...");
+    run(`claude plugin marketplace add ${GITHUB_REPO}`);
+
+    // Step 2: 플러그인 설치
+    console.log(`  [2/2] 플러그인 설치 (--scope ${scope.name})...`);
+    const installed = run(
+      `claude plugin install ${PLUGIN_NAME}@${MARKETPLACE_NAME} --scope ${scope.name}`
+    );
+
+    if (!installed) {
+      console.error("\n  ✗ 설치에 실패했습니다. 수동으로 시도하세요:");
+      console.error(`    claude plugin marketplace add ${GITHUB_REPO}`);
+      console.error(
+        `    claude plugin install ${PLUGIN_NAME}@${MARKETPLACE_NAME} --scope ${scope.name}`
+      );
+      exit(1);
+    }
+
+    console.log();
+    console.log("  ✓ 설치 완료!");
+    console.log();
+    console.log("  다음 단계:");
+    console.log("    /selfish:init              프로젝트 설정 생성");
+    console.log('    /selfish:auto "기능 설명"   파이프라인 실행');
+    console.log();
+  } finally {
+    rl.close();
+  }
+}
+
+main().catch((err) => {
+  console.error(`\n  ✗ 설치 실패: ${err.message}`);
+  exit(1);
+});

package/commands/analyze.md

@@ -0,0 +1,113 @@
+# /selfish:analyze — 아티팩트 정합성 검증
+
+> spec.md, plan.md, tasks.md 간의 일관성과 품질을 검증한다.
+> **읽기 전용** — 파일을 수정하지 않는다.
+
+## 인자
+
+- `$ARGUMENTS` — (선택) 검증 범위 한정 (예: "spec-plan", "tasks-only")
+
+## 설정 로드
+
+프로젝트 루트의 `CLAUDE.md` 또는 `.claude/CLAUDE.md`에서 다음 설정을 읽어 `config` 변수에 할당:
+
+```
+config.architecture = 프로젝트에서 사용하는 아키텍처 패턴
+                      (예: "FSD", "Clean Architecture", "Layered", "Modular Monolith")
+                      → CLAUDE.md에 명시된 아키텍처 기준. 없으면 "레이어드 아키텍처"로 가정.
+```
+
+## 실행 절차
+
+### 1. 아티팩트 로드
+
+`specs/{feature}/`에서:
+- **spec.md** (필수)
+- **plan.md** (필수)
+- **tasks.md** (있으면)
+- **research.md** (있으면)
+
+누락 파일이 있으면 경고하되 있는 것으로 진행.
+
+### 2. 검증 수행
+
+6가지 카테고리를 검증:
+
+#### A. 중복 감지 (DUPLICATION)
+- spec.md 내 유사한 요구사항
+- tasks.md 내 겹치는 태스크
+
+#### B. 모호성 감지 (AMBIGUITY)
+- 측정 불가능한 형용사 ("적절한", "빠른", "좋은")
+- TODO/TBD/FIXME 잔류
+- 불완전한 문장
+
+#### C. 커버리지 갭 (COVERAGE)
+- spec → plan: 모든 FR-*/NFR-*가 plan에 반영되었는가?
+- plan → tasks: plan의 File Change Map 모든 항목이 tasks에 있는가?
+- spec → tasks: 모든 요구사항이 태스크에 매핑되는가?
+
+#### D. 불일치 (INCONSISTENCY)
+- 용어 드리프트 (같은 개념에 다른 이름)
+- 충돌하는 요구사항
+- plan의 기술 결정과 tasks의 실행이 불일치
+
+#### E. 원칙 준수 (PRINCIPLES)
+- memory/principles.md가 있으면 MUST 원칙 대비 검증
+- {config.architecture} 규칙 위반 가능성
+
+#### F. 리스크 미식별 (RISK)
+- plan.md에 식별되지 않은 리스크가 있는가?
+- 외부 의존성 리스크
+- 성능 병목 가능성
+
+### 3. 심각도 분류
+
+| 심각도 | 기준 |
+|--------|------|
+| **CRITICAL** | 원칙 위반, 핵심 기능 차단, 보안 문제 |
+| **HIGH** | 중복/충돌, 테스트 불가능, 커버리지 갭 |
+| **MEDIUM** | 용어 드리프트, 모호한 요구사항 |
+| **LOW** | 스타일 개선, 사소한 중복 |
+
+### 4. 결과 출력 (콘솔)
+
+```markdown
+## 정합성 분석 결과: {기능명}
+
+### 발견사항
+| ID | 카테고리 | 심각도 | 위치 | 요약 | 권장 조치 |
+|----|----------|--------|------|------|-----------|
+| A-001 | COVERAGE | HIGH | spec FR-003 | tasks에 매핑 없음 | 태스크 추가 |
+| A-002 | AMBIGUITY | MEDIUM | spec NFR-001 | "빠르게" 측정 불가 | 수치 기준 추가 |
+
+### 커버리지 요약
+| 매핑 | 비율 |
+|------|------|
+| spec → plan | {N}% |
+| plan → tasks | {N}% |
+| spec → tasks | {N}% |
+
+### 메트릭스
+- 총 요구사항: {N}개
+- 총 태스크: {N}개
+- 이슈: CRITICAL {N} / HIGH {N} / MEDIUM {N} / LOW {N}
+
+### 다음 단계
+{CRITICAL/HIGH 이슈에 대한 구체적 조치 제안}
+```
+
+### 5. 최종 출력
+
+```
+🔎 분석 완료
+├─ 발견: CRITICAL {N} / HIGH {N} / MEDIUM {N} / LOW {N}
+├─ 커버리지: spec→plan {N}%, plan→tasks {N}%, spec→tasks {N}%
+└─ 권장: {다음 액션}
+```
+
+## 주의사항
+
+- **읽기 전용**: 어떤 파일도 수정하지 않는다. 보고만 한다.
+- **오탐 주의**: 모호성 감지가 과도하지 않도록. 컨텍스트를 고려.
+- **선택적**: 파이프라인에서 필수가 아님. plan → tasks → implement 직행 가능.

package/commands/architect.md

@@ -0,0 +1,119 @@
+# /selfish:architect — 아키텍처 분석 및 설계 조언
+
+> 코드베이스의 아키텍처를 분석하고 설계 결정을 기록한다.
+> Critic Loop 3회로 설계 품질을 보장한다. **읽기 전용** — 코드를 수정하지 않는다.
+
+## 인자
+
+- `$ARGUMENTS` — (필수) 분석 대상 또는 설계 질문 (예: "상태 관리 전략 리뷰", "새 entity 추가 위치")
+
+## 설정 로드
+
+프로젝트 루트의 `CLAUDE.md` 또는 `.claude/CLAUDE.md`에서 다음 설정을 읽어 `config` 변수에 할당:
+
+```
+config.architecture = 프로젝트에서 사용하는 아키텍처 패턴
+                      (예: "FSD", "Clean Architecture", "Layered", "Modular Monolith")
+                      → CLAUDE.md에 명시된 아키텍처 기준. 없으면 "레이어드 아키텍처"로 가정.
+```
+
+## 실행 절차
+
+### 1. 범위 결정
+
+`$ARGUMENTS`를 분석하여 작업 유형 판별:
+
+| 유형 | 예시 | 출력 |
+|------|------|------|
+| **구조 분석** | "타임라인 모듈 구조" | 의존성 맵 + 개선 제안 |
+| **설계 질문** | "새 feature 어디에?" | 배치 제안 + 근거 |
+| **ADR 기록** | "Redis vs In-memory 결정" | Architecture Decision Record |
+| **리팩토링 평가** | "store 분리 필요성" | 현재 문제 + 리팩토링 계획 |
+
+### 2. 코드베이스 탐색
+
+1. 관련 디렉토리/파일 탐색 (Glob, Grep, Read)
+2. 의존성 흐름 추적 (import 관계)
+3. {config.architecture} 구조 확인
+4. 기존 패턴 식별
+
+Agent Teams 활용: 분석 범위가 넓으면 (3개+ 모듈) 병렬 탐색:
+```
+Task("features/timeline 분석", subagent_type: Explore)
+Task("widgets/timeline 분석", subagent_type: Explore)
+```
+
+### 3. 분석 작성
+
+분석 결과를 구조화하여 **콘솔에 출력**:
+
+```markdown
+## 아키텍처 분석: {주제}
+
+### 현재 구조
+{의존성 맵, 모듈 관계, 데이터 흐름}
+
+### 발견사항
+| # | 영역 | 현재 | 제안 | 영향도 |
+|---|------|------|------|--------|
+| 1 | {영역} | {현재 방식} | {제안} | H/M/L |
+
+### 설계 결정 (ADR)
+**결정**: {선택한 방식}
+**상태**: Proposed / Accepted / Deprecated
+**컨텍스트**: {배경}
+**선택지**:
+1. {옵션1} — 장점: / 단점:
+2. {옵션2} — 장점: / 단점:
+**근거**: {왜 이 선택인지}
+**결과**: {예상되는 영향}
+
+### 아키텍처 정합성
+{config.architecture} 규칙 위반 여부, import 방향 검증}
+```
+
+### 4. Critic Loop (3회)
+
+| 기준 | 검증 내용 |
+|------|-----------|
+| **FEASIBILITY** | 제안이 현재 코드베이스에서 실현 가능한가? |
+| **INCREMENTALITY** | 점진적 적용이 가능한가? (빅뱅 리팩토링 지양) |
+| **COMPATIBILITY** | 기존 코드와 호환되는가? Breaking change가 있는가? |
+| **ARCHITECTURE** | {config.architecture} 규칙을 준수하는가? |
+
+출력 규칙:
+- FAIL 시: `⚠ {기준}: {문제}. 수정 중...`
+- PASS 시: `✓ Critic {N}/3 통과`
+- 최종: `Critic Loop 완료 ({N}회). 주요 수정: {요약}`
+
+### 5. ADR 저장 (설계 결정인 경우)
+
+ADR 유형이면 `memory/decisions/{YYYY-MM-DD}-{topic}.md`에 저장:
+
+```markdown
+# ADR: {제목}
+- **날짜**: {YYYY-MM-DD}
+- **상태**: Proposed
+- **컨텍스트**: {배경}
+- **결정**: {선택}
+- **근거**: {이유}
+- **결과**: {영향}
+```
+
+### 6. 최종 출력
+
+```
+🏗 아키텍처 분석 완료
+├─ 유형: {구조 분석 | 설계 질문 | ADR | 리팩토링 평가}
+├─ 발견사항: {개수}개
+├─ Critic: {N}회 완료
+├─ ADR: {저장됨 | 해당없음}
+└─ 제안: {핵심 제안 한 줄}
+```
+
+## 주의사항
+
+- **읽기 전용**: 코드를 수정하지 않음. 분석과 제안만 수행.
+- **실제 코드 기반**: 추측이 아닌 실제 코드베이스를 탐색하여 분석.
+- **아키텍처 우선**: 모든 제안은 {config.architecture} 규칙을 존중.
+- **점진적 변경**: 빅뱅 리팩토링보다 점진적 개선을 선호.