@tienne/gestalt 0.88.0 → 0.89.0

package/CLAUDE.md

@@ -17,6 +17,7 @@
 - **Memory**: 이전 스펙·실행 이력을 `.gestalt/memory.json`에 축적, 신규 인터뷰에 자동 주입
 - **Multi-Provider LLM**: frugal/standard/frontier 티어별로 Anthropic/OpenAI 호환 프로바이더 자유 조합
 - **Local PR**: 에이전트끼리 레포 안에서 PR을 만들고 리뷰하고 머지하는 자리 — 원격에 안 나간다. 워크트리 여럿이 `.gestalt/reviews.db` 하나를 공유한다
+- **Architecture View**: 세션이 코드와 맥락 소스를 탐색해 근거 달린 IR을 쓰면 서버가 검증하고 elkjs 좌표로 단일 HTML을 그린다. 서비스 노드가 있으면 전체에서 서비스, 기능영역, 화면으로 들어가는 드릴다운이 된다. 노드 하나를 고르면 그와 위아래로 이어진 카드만 남기는 포커스도 된다. 서비스 아래에는 손님, 직원, 시스템을 가로줄로 나눠 정상 흐름과 취소나 노쇼 같은 옆 흐름을 함께 그리는 도메인 흐름 레벨을 둘 수 있다. 흐름 그림은 상태 값으로, 기술 그림은 세션이 정한 구간으로 왼쪽에서 오른쪽을 나눈다. 단계 카드에서 기술 그림의 화면과 API로 건너간다. 근거 없는 실선은 거부하고 근거 없는 연결은 미해결 질문으로 돌린다. 따로 돌린 분석 둘을 git remote 기준으로 합쳐 제품끼리 같이 쓰는 게이트웨이와 서버, 저장소를 한 그림에 모을 수도 있다. 합친 그림은 맨 위에 같이 쓰는 카드를, 그 아래로 제품마다 전용 카드를 띠로 나눠 그리고 같이 쓰는 카드 위에 제품 브릭을 꽂는다. 전체보기는 prod 기준이다. 저장은 `.gestalt/architecture/`
 - **Event Store**: better-sqlite3 WAL 모드 이벤트 소싱
 
 ## Tech Stack
@@ -56,11 +57,13 @@ pnpm tsx bin/gestalt.ts explain-eval --a plugin/role-agents/explainer/AGENT.md
 - `ges_search`: query, k?, kbPath?, types?
 - `ges_sync`: sourcePath?, targetPath
 - `ges_pr`: action=[create|list|get|diff|comment|resolve|review|update|edit|merge|close|checkout|checkout_remove]
+- `ges_architecture`: action=[start|filter_tools|match_endpoints|validate|render|status|merge|scan_docs|link_docs|stale_docs]
 
 상세 플로우 → [`docs/mcp-reference.md`](./docs/mcp-reference.md)
 설정 레퍼런스 → [`docs/configuration.md`](./docs/configuration.md)
 코드 그래프 → [`docs/code-graph.md`](./docs/code-graph.md)
 로컬 PR → [`docs/local-pr.md`](./docs/local-pr.md)
+아키텍처 그림 → [`docs/architecture-view.md`](./docs/architecture-view.md)
 
 ## Role Agent 자동 라우팅
 
@@ -76,6 +79,7 @@ src/execute/       — ExecuteEngine, DAG Validator
 src/resilience/    — Stagnation Detector, Lateral Thinking Personas
 src/code-graph/    — CodeGraphEngine, BlastRadius, git 이력 co-change, 언어 플러그인 8개
 src/graph-viz/     — 코드 그래프 D3 시각화 (ges_graph_visualize 백엔드)
+src/architecture/  — 아키텍처 IR 스키마, 근거 검증, 이전 실행 병합, 분석 합치기, elkjs 레이아웃, HTML 렌더 (ges_architecture 백엔드)
 src/local-pr/      — 로컬 PR 도메인 (이벤트 소싱, git 연산, gestalt pr·ges_pr 백엔드)
 src/local-pr-web/  — 로컬 PR 읽기 전용 웹 UI (gestalt pr serve 백엔드)
 src/knowledge-base/— KB 생성·시맨틱 검색·동기화 (ges_generate_kb/ges_search/ges_sync 백엔드)
@@ -90,12 +94,12 @@ src/skills/        — Skill System 엔진 (SKILL.md 파서·실행기, 최상
 src/registry/      — 레지스트리 공통 베이스 클래스
 src/humanize/      — 룰북 읽기 + AI-tell 탐지기 + 윤문 코드 검사 (`gestalt humanize-check` 백엔드)
 src/explain/       — 대상별 설명 품질 검사 (`gestalt explain-check` 백엔드). 판정 구조만 humanize에서 빌려 쓴다
-src/utils/         — 알림 등 공용 유틸
+src/utils/         — 알림, 읽기 전용 도구 이름 걸러내기(read-only-tools), git remote로 ~/.claude/projects 메모리 묶기(claude-projects) 등 공용 유틸
 src/cli/           — commander 기반 CLI
 plugin/            — 배포 자산 전부. Claude Code와 Codex 플러그인이 이 디렉토리 하나를 공유한다
 plugin/role-agents/    — 내장 Role Agent 9개 (architect, frontend-developer, backend-developer, devops-engineer, qa-engineer, designer, product-planner, researcher, technical-writer) + 스킬 지원용 에이전트(jira-writer, slack-messenger, presentation-writer, code-review-writer, code-review-responder, suggestion-verifier, explainer 등) 총 23개 + `_shared/references/` 공유 룰북(author-voice, ai-tell-quick-rules, style-guide, comment-rules, truncation-rules)과 리뷰 절차 문서(rule-path-walk) — 에이전트 아님, 레지스트리가 건너뜀
 plugin/review-agents/  — 내장 Review Agent 7개 (security-reviewer, performance-reviewer, quality-reviewer, frontend-reviewer, comment-reviewer, writing-reviewer, harness-reviewer)
-plugin/skills/         — SKILL.md 21개 (interview, spec, execute, dispatch, agent, review, review-reply, review-loop, pr, local-pr, ship, build-graph, blast-radius, diff-radius, jira-create, slack-send, brief, presentation, explain, solve, setup) + `_shared/` 공유 규칙(스킬 아님, 레지스트리가 건너뜀)
+plugin/skills/         — SKILL.md 22개 (interview, spec, execute, dispatch, agent, review, review-reply, review-loop, pr, local-pr, ship, build-graph, blast-radius, diff-radius, architecture, jira-create, slack-send, brief, presentation, explain, solve, setup) + `_shared/` 공유 규칙(스킬 아님, 레지스트리가 건너뜀)
 plugin/agents/         — 파이프라인 에이전트 5개
 plugin/personas/       — Lateral Thinking 페르소나
 ```

package/README.ko.md

@@ -151,7 +151,7 @@ claude plugin install gestalt@gestalt
 
 | 항목 | 내용 |
 |------|------|
-| **MCP 도구** | `ges_interview`, `ges_generate_spec`, `ges_execute`, `ges_create_agent`, `ges_agent`, `ges_status`, `ges_code_graph`, `ges_graph_visualize`, `ges_benchmark`, `ges_generate_kb`, `ges_search`, `ges_sync`, `ges_pr` — [MCP 레퍼런스](./docs/mcp-reference.md) 참고 |
+| **MCP 도구** | `ges_interview`, `ges_generate_spec`, `ges_execute`, `ges_create_agent`, `ges_agent`, `ges_status`, `ges_code_graph`, `ges_graph_visualize`, `ges_benchmark`, `ges_generate_kb`, `ges_search`, `ges_sync`, `ges_pr`, `ges_architecture` — [MCP 레퍼런스](./docs/mcp-reference.md) 참고 |
 | **슬래시 커맨드** | 워크플로 스킬 — `/interview`, `/spec`, `/execute`, `/review`, `/pr`, `/brief`, `/jira-create`, `/slack-send` 등. 전체 목록은 [스킬](#스킬) |
 | **에이전트** | 파이프라인 에이전트, [Role 에이전트와 Review 에이전트](#6단계--code-review-코드-리뷰) |
 | **CLAUDE.md** | 프로젝트 컨텍스트 및 MCP 사용 가이드 자동 추가 |
@@ -606,6 +606,7 @@ Claude Code에서는 스킬마다 슬래시 커맨드로 불러요. Codex에서
 | `/build-graph` | 코드 지식 그래프만 빌드하거나 다시 빌드해요 |
 | `/blast-radius` | 코드를 고치기 전에 영향받을 파일을 찾아 그 파일만 컨텍스트에 올려요 |
 | `/diff-radius` | 커밋 안 한 변경과 스테이징한 변경이 어디까지 영향을 주는지 봐요 |
+| `/architecture` | 화면에서 DB까지, 또는 배포 경로를 그림으로 그려요. 실선은 전부 코드나 API 명세 근거가 있고 확인 못 한 연결은 점선이나 미해결 질문으로 남아요 |
 | `/review` | PR이나 브랜치, 커밋을 [Review 에이전트](#6단계--code-review-코드-리뷰)로 검토해요. 대상이 PR이면 인라인 코멘트까지 남겨요 |
 | `/review-loop` | 남의 GitHub PR을 리뷰어로 끝까지 따라가요. 리뷰하고 판정을 남긴 뒤 작성자 대응을 기다렸다가 approve가 날 때까지 재리뷰해요 |
 | `/review-reply` | 내 PR에 달린 리뷰 코멘트를 처리해요. 고치고 커밋한 뒤 `code-review-responder`가 쓴 답글을 남겨요 |

package/README.md

@@ -126,7 +126,7 @@ What you get:
 
 | Item | Details |
 |------|---------|
-| **MCP Tools** | `ges_interview`, `ges_generate_spec`, `ges_execute`, `ges_create_agent`, `ges_agent`, `ges_status`, `ges_code_graph`, `ges_graph_visualize`, `ges_benchmark`, `ges_generate_kb`, `ges_search`, `ges_sync`, `ges_pr` — see the [MCP reference](./docs/mcp-reference.md) |
+| **MCP Tools** | `ges_interview`, `ges_generate_spec`, `ges_execute`, `ges_create_agent`, `ges_agent`, `ges_status`, `ges_code_graph`, `ges_graph_visualize`, `ges_benchmark`, `ges_generate_kb`, `ges_search`, `ges_sync`, `ges_pr`, `ges_architecture` — see the [MCP reference](./docs/mcp-reference.md) |
 | **Slash Commands** | Workflow skills — `/interview`, `/spec`, `/execute`, `/review`, `/pr`, `/brief`, `/jira-create`, `/slack-send`, and more. Full list in [Skills](#skills) |
 | **Agents** | Pipeline agents, [role agents](#role-agents), and [review agents](#review-agents) |
 | **CLAUDE.md** | Project context and MCP usage guide auto-injected |
@@ -642,6 +642,7 @@ Each skill is a slash command in Claude Code. In Codex the same skill is `gestal
 | `/build-graph` | Build or rebuild the code knowledge graph only |
 | `/blast-radius` | Before changing code, find the files a change would reach and load only those |
 | `/diff-radius` | See how far uncommitted and staged changes reach |
+| `/architecture` | Draw a screen-to-DB or deploy-path architecture view where every solid line cites code or an API spec. Unproven links stay dashed or become open questions |
 | `/review` | Review a PR, branch, or commit with the [review agents](#review-agents), and post inline comments when the target is a PR |
 | `/review-loop` | Follow someone else's GitHub PR as reviewer — review, post a verdict, wait for the author, and re-review until approve |
 | `/review-reply` | Work through review comments on your own PR: fix, commit, and post replies written by `code-review-responder` |
@@ -968,6 +969,7 @@ Claude Code (you)
 - [Configuration Reference](./docs/configuration.md) — full config options
 - [Code Knowledge Graph](./docs/code-graph.md) — static analysis and blast-radius
 - [Local PR](./docs/local-pr.md) — in-repo pull requests for agent-to-agent review
+- [Architecture View](./docs/architecture-view.md) — evidence-backed architecture diagrams
 
 ---
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.88.0",
+  "version": "0.89.0",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "repository": {
     "type": "git",
@@ -58,6 +58,7 @@
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",
     "dotenv": "^17.3.1",
+    "elkjs": "^0.12.0",
     "gray-matter": "^4.0.3",
     "node-notifier": "^10.0.1",
     "node-pty": "^1.1.0",

package/dist/plugin/skills/_shared/proactive-routing.md

@@ -49,6 +49,7 @@
 | 슬라이드 Reveal.js 구조·템플릿·비주얼 디자인 자문 | `presentation-designer` |
 | 발표자료·슬라이드·프레젠테이션 제작 요청 ("발표자료 만들어줘", "슬라이드 만들어줘", "피치덱") | `presentation` 스킬 사용 (presentation-writer 콘텐츠 → 승인 단계 → presentation-designer 디자인 → Reveal.js HTML) |
 | 시스템 설계, 아키텍처 리뷰, 설계 패턴 | `architect` |
+| 근거 달린 아키텍처 그림 요청 ("아키텍처 그려줘", "화면에서 DB까지 그려줘", "배포 경로 그려줘") | `architecture` 스킬 사용 (맥락 소스 찾기 → 읽기 전용 걸러내기 → 탐색 → IR validate → 미해결 질문 → render). 설계 리뷰나 자문이면 `architect` |
 | 보안 취약점, 인증/인가, 시크릿 노출 검토 | `security-reviewer` |
 | 성능 병목, N+1, 메모리 누수 분석 | `performance-reviewer` |
 | 코드 가독성, SOLID, 에러 처리 리뷰 | `quality-reviewer` |