@tienne/gestalt 0.120.1 → 0.120.2

package/README.ko.md

@@ -593,7 +593,7 @@ ges_create_agent  →  action: "submit", sessionId: "<id>", agentContent: "..."
 
 ### 스킬
 
-Claude Code에서는 스킬마다 슬래시 커맨드로 불러요. Codex에서는 같은 스킬이 `gestalt:<이름>`이고 하려는 일을 말로 설명하면 Codex가 골라 읽어요.
+Claude Code에서는 스킬마다 슬래시 커맨드로 불러요. Codex에서는 같은 스킬이 `gestalt:<이름>`이고 하려는 일을 말로 설명하면 Codex가 골라 읽어요. 비슷한 스킬 중 뭘 써야 할지 헷갈리면 [스킬 고르기](./docs/choosing-skills.md)를 보세요.
 
 | 스킬 | 언제 쓰나요 |
 |------|-------------|
@@ -617,8 +617,13 @@ Claude Code에서는 스킬마다 슬래시 커맨드로 불러요. Codex에서
 | `/ship` | 로컬 PR로 리뷰를 수렴시킨 뒤 GitHub에 draft PR로 올리고 Copilot 리뷰까지 받아요 |
 | `/brief` | 성과 보고, 제안서, RFC, 의사결정 메모를 이해관계자가 읽을 산문으로 써요 |
 | `/presentation` | 발표 자료를 만들어요. `presentation-writer`가 콘텐츠를 쓰고 `presentation-designer`가 Reveal.js HTML로 조립해요 |
-| `/video-digest` | 유튜브 영상으로 요약 뷰어를 만들어요. 불릿마다 근거가 된 스크립트 문장이 달리고 목차와 플레이어, 재생 위치를 따라가는 스크립트가 붙어요. 마크다운으로도 내요 |
-| `/lens` | 논문 PDF나 웹 글, 팟캐스트를 같이 읽어 주는 뷰어를 만들어요. 문장마다 원문 쪽과 문단 출처가 달리고 원문 표 숫자와 어긋나는 주장에는 의심 표시가, 끝에는 검증 안 된 부분이 붙어요. 선행 연구 카드와 내 노트 연결, 원문 표로 그린, 눌러 보면 바뀌는 그림도 붙여요 |
+| `/video-digest` | 유튜브 영상이나 영상 파일로 요약 뷰어를 만들어요. 불릿마다 근거가 된 스크립트 문장이 달리고 목차와 플레이어, 재생 위치를 따라가는 스크립트가 붙어요. 마크다운으로도 내요. [영상 요약 뷰어](./docs/video-digest.md) 참고 |
+| `/lens` | 논문 PDF나 웹 글, 팟캐스트를 같이 읽어 주는 뷰어를 만들어요. 문장마다 원문 쪽과 문단 출처가 달리고 원문 표 숫자와 어긋나는 주장에는 의심 표시가, 끝에는 검증 안 된 부분이 붙어요. 선행 연구 카드와 내 노트 연결, 원문 표로 그린, 눌러 보면 바뀌는 그림도 붙여요. [읽기 렌즈](./docs/lens.md) 참고 |
+| `/research` | 경쟁사 조사부터 화면 캡처, 비교표, 판단, 열린 질문까지 한 문서로 내요. 근거 없는 칸은 채우지 않고 확인 못함으로 적어요. [경쟁사 리서치](./docs/research-pipeline.md) 참고 |
+| `/market-scan` | 같은 기능을 하는 서비스 지형을 훑어 레퍼런스 후보를 골라요. 화면 캡처와 분석은 하지 않아요 |
+| `/screen-ref` | 경쟁 서비스의 화면만 수집해요. 화면 지도를 만들고 개인정보를 가짜 값으로 바꿔 캡처하며 결제 직전에서 멈춰요. 해석은 쓰지 않아요 |
+| `/ux-research` | 모아 둔 화면을 사용자와 비즈니스 관점으로 읽고 와우 포인트와 페인 포인트를 써요. 관찰은 캡처에 연결하고 효과 예측에는 해석 표시를 붙여요 |
+| `/reverse-plan` | 경쟁 서비스의 화면이 왜 그렇게 만들어졌는지 본업에서 거꾸로 짚고 가져올 것과 안 가져올 것을 갈라요. 전부 해석으로 써요 |
 | `/explain` | 개념이나 에러, 코드를 정한 대상에게 맞춰 설명하고 `explain-check`로 판정해요 |
 | `/jira-create` | `jira-writer`로 지라 티켓을 쓰고 미리보기를 승인하면 생성해요 |
 | `/slack-send` | 슬랙 메시지를 작성자 어투로 다듬고 승인하면 보내거나 예약해요 |

package/README.md

@@ -629,7 +629,7 @@ The review `context-collector` uses `blastRadius()` from the Code Knowledge Grap
 
 ## Skills
 
-Each skill is a slash command in Claude Code. In Codex the same skill is `gestalt:<name>`, and Codex picks it from your description of the task.
+Each skill is a slash command in Claude Code. In Codex the same skill is `gestalt:<name>`, and Codex picks it from your description of the task. Not sure which of two similar skills to use? See [Choosing a skill](./docs/choosing-skills.md).
 
 | Skill | Use it to |
 |-------|-----------|
@@ -653,8 +653,13 @@ Each skill is a slash command in Claude Code. In Codex the same skill is `gestal
 | `/ship` | Converge review on a local PR, then open a draft GitHub PR and collect Copilot review |
 | `/brief` | Performance reports, proposals, RFCs, and decision memos written as prose for stakeholders |
 | `/presentation` | Slide decks — `presentation-writer` writes the content and `presentation-designer` builds Reveal.js HTML |
-| `/video-digest` | Turn a YouTube video into a summary viewer where every bullet cites transcript sentences, with a table of contents, player, and a script that follows playback. Also exports Markdown |
-| `/lens` | Read a paper PDF, web article, or podcast with a companion viewer. Every sentence cites the source page and paragraph, claims that disagree with the source's own tables get a doubt mark, and unverified parts are collected at the end. Adds prior-work cards, links to your own notes, and interactive figures drawn from the source tables |
+| `/video-digest` | Turn a YouTube video or a video file into a summary viewer where every bullet cites transcript sentences, with a table of contents, player, and a script that follows playback. Also exports Markdown. See [Video digest](./docs/video-digest.md) |
+| `/lens` | Read a paper PDF, web article, or podcast with a companion viewer. Every sentence cites the source page and paragraph, claims that disagree with the source's own tables get a doubt mark, and unverified parts are collected at the end. Adds prior-work cards, links to your own notes, and interactive figures drawn from the source tables. See [Reading lens](./docs/lens.md) |
+| `/research` | Competitor research in one document: sources, products, screen captures, comparison, judgment, and open questions. Cells without evidence say "unconfirmed" instead of being filled in. See [Competitor research](./docs/research-pipeline.md) |
+| `/market-scan` | Survey the landscape of services that do the same job and pick reference candidates. Stops before screen capture and analysis |
+| `/screen-ref` | Collect only the competitor's screens. Builds a screen map, captures with personal data swapped for fake values, and stops before payment. No interpretation |
+| `/ux-research` | Read collected screens from the user's and the business's point of view and write wow points and pain points. Observations link to captures and predictions carry an interpretation mark |
+| `/reverse-plan` | Work backward from the competitor's core business to why the screen was built that way, then split what to bring over from what not to. Everything is marked as interpretation |
 | `/explain` | Explain a concept, error, or code for a chosen audience, then check it with `explain-check` |
 | `/jira-create` | Draft a Jira ticket with `jira-writer` and create it after you approve the preview |
 | `/slack-send` | Draft a Slack message in the author's voice and send or schedule it after you approve |
@@ -975,6 +980,10 @@ Claude Code (you)
 - [Getting Started](./docs/getting-started.md) — 5-minute walkthrough
 - [Configuration Reference](./docs/configuration.md) — full config options
 - [Code Knowledge Graph](./docs/code-graph.md) — static analysis and blast-radius
+- [Choosing a skill](./docs/choosing-skills.md) — which skill to use when several look alike
+- [Competitor research](./docs/research-pipeline.md) — the five research skills and the order to run them
+- [Reading lens](./docs/lens.md) — paper, article, and podcast viewer with source citations
+- [Video digest](./docs/video-digest.md) — YouTube or local video summary viewer with sourced bullets
 - [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
 - [Design Proposals](./docs/proposals/README.md) — planned work to tighten verification from interview to evaluate

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.120.1",
+  "version": "0.120.2",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "repository": {
     "type": "git",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.120.1",
+  "version": "0.120.2",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "repository": {
     "type": "git",

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "gestalt",
-  "version": "0.120.1",
+  "version": "0.120.2",
   "description": "Gestalt psychology-driven AI development harness. Transforms scattered requirements into structured, validated specifications through interactive interviews.",
   "author": {
     "name": "tienne"

package/plugin/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "gestalt": {
       "command": "npx",
-      "args": ["-y", "@tienne/gestalt@0.120.1", "serve"],
+      "args": ["-y", "@tienne/gestalt@0.120.2", "serve"],
       "startup_timeout_sec": 180,
       "tool_timeout_sec": 900
     }

package/plugin/mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "gestalt": {
       "command": "npx",
-      "args": ["-y", "@tienne/gestalt@0.120.1", "serve"],
+      "args": ["-y", "@tienne/gestalt@0.120.2", "serve"],
       "startup_timeout_sec": 180,
       "tool_timeout_sec": 900
     }