oh-my-patent 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 oh-my-patent contributors
+
+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/README.md

@@ -0,0 +1,298 @@
+# oh-my-patent
+
+[![npm version](https://img.shields.io/npm/v/oh-my-patent.svg)](https://www.npmjs.com/package/oh-my-patent)
+[![npm downloads](https://img.shields.io/npm/dm/oh-my-patent.svg)](https://www.npmjs.com/package/oh-my-patent)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
+[![Tests](https://img.shields.io/badge/tests-87%20passing-brightgreen.svg)](https://github.com/zengbods/oh-my-patent)
+
+> Your idea → a full patent disclosure document, without you herding 11 AI agents into a task queue.
+
+## One-Liner
+
+Install. Type `/archimedes`. Describe what you want. The rest is handled by 11 patent-specialized AI agents.
+
+```bash
+npm install -g oh-my-patent
+oh-my-patent adapt setup --workspace-dir .
+```
+
+Then:
+
+```text
+/archimedes
+> Create a patent project about homomorphic encryption in privacy-preserving computing.
+```
+
+It will search, brainstorm, assess, draft, review, and generate patent figures on its own.
+Every decision is recorded — you can roll back to any round, fork to explore alternatives, or revive a discarded innovation.
+
+---
+
+## 🎬 Quick Demo
+
+### Before oh-my-patent
+![Manual Patent Workflow](https://via.placeholder.com/800x400/2d3748/ffffff?text=Manual+workflow%3A+Switch+between+10+tools%2C+lose+context%2C+manually+merge+outputs)
+
+### After oh-my-patent
+![Automated Patent Workflow](https://via.placeholder.com/800x400/48bb78/ffffff?text=oh-my-patent%3A+One+command%2C+11+agents%2C+auditable+path%2C+auto-figures)
+
+> **Note**: GIF demonstrations will be added in v0.1.1. Screenshots show the conceptual workflow difference.
+
+---
+
+## Your Pain vs. What This Does
+
+| Your Pain | In Other Tools | In oh-my-patent |
+|---|---|---|
+| You have to prompt 10 different AIs, then consolidate everything yourself | You cut up the work, paste chat logs across windows, manually merge | **Archimedes**, the primary orchestrator, routes everything to 11 specialist agents. Outputs are auto-saved to `references/`, context passes between rounds automatically |
+| After 3 rounds of brainstorming, you scroll up and the rejected gems are gone | Chat history scrolls away, and you can't find that one great idea from round 2 | **.brainstorm/ decision-path tracking** persists every round's scores, innovations, and pass/reject decisions as an auditable DAG. Roll back, fork, or revive at will |
+| Patent figures are a cycle of Visio → screenshot → paste into Word | You draw by hand, export, format, lose the source | **Mermaid/PlantUML figure generation** extracts the architecture from MAIN.md, renders to SVG+PNG, and **auto-updates** the figure references in MAIN.md |
+| Every new teammate who uses Claude Code or Codex needs a different, hand-written config | Claude Code settings, Codex settings, separate and manual for each project | **`oh-my-patent adapt setup`** — one command generates configs for **both** Claude Code (`.claude/` + CLAUDE.md) and Codex (`.codex/` + codex.json). Uninstall is also one command, and it **only** removes what we generated |
+| Halfway through, your machine crashes or the conversation breaks | Scrambling through screenshots, starting over from zero | **Workflow state machine**. All stages are written to `state.json`, and the decision tree is in `path.json`. Resume from the exact point of failure |
+| After 6 review rounds, you have no idea what "done" looks like | A mess of loose documents | **Quantitative threshold model** auto-decides if brainstorming is mature enough. The QA loop has a clear exit: 2 consecutive rounds with no new issues |
+
+## The Full Feature Set (For When You Want It)
+
+The table above handles 90% of real use cases. Here's everything, for when you need to come back to check:
+
+|  | Feature | What it means in one sentence |
+|---|---|---|
+| 🧠 | **Brainstorm decision-path tracking** | `.brainstorm/` records every round's scores, innovations, and pass/reject decisions. Roll back to any node, fork to explore alternatives, or revive discarded ideas |
+| 🤖 | **End-to-end 11-agent pipeline** | Search → ideation → patentability → draft → review → rebuttal → diagrams. The full patent lifecycle, with zero hand-holding between stages |
+| ⚡ | **`/archimedes` one-liner entry** | Regardless of what you want, start with Archimedes. He reads your state, routes to specialists, waits for output, and moves to the next stage |
+| 🔗 | **Zero-config cross-tool adapters** | `oh-my-patent adapt setup` generates configs for both Claude Code and Codex in one shot |
+| 🛡️ | **Safe uninstall** | Exact-file cleanup — we only delete files we auto-generated. No `readdir + unlink` traversing your workspace |
+| 📊 | **Auto figure rendering** | Parses MAIN.md for technical architecture, renders Mermaid/PlantUML to SVG+PNG, and auto-rewrites references |
+| 🎯 | **Scoring thresholds & QA loops** | Quantitative model decides if a brainstorming round is ripe. Up to 6 review-rebuttal loops, exiting on 2 consecutive clean rounds |
+| 💻 | **Interactive terminal blueprint** | Ink+React TUI for locally browsing the decision path, node details, and branch overviews with zero internet dependency |
+| 🔄 | **Resumable workflow** | `INIT → RESEARCH → BRAINSTORM → DRAFT → QA_LOOP → FINAL_REVIEW → DIAGRAM → DONE`. Crashes or session breaks are non-destructive; resume from `state.json` |
+
+## Full Installation
+
+### Global install (after npm publish)
+
+```bash
+npm install -g oh-my-patent
+```
+
+### Local development
+
+```bash
+git clone <your repo>
+cd oh-my-patent
+npm install
+npm run build
+```
+
+Use `node dist/cli.js` or `npx -p . oh-my-patent` after building.
+
+### Install editor configs into your workspace
+
+Run this from your project root (where `projects/` lives):
+
+```bash
+# All adapters (Claude Code + Codex)
+oh-my-patent adapt setup --workspace-dir .
+
+# Or one at a time
+oh-my-patent adapt setup --tool claude-code --workspace-dir .
+```
+
+The CLI will automatically print the matching `uninstall` command on completion.
+
+```bash
+oh-my-patent adapt install   # alias for setup
+oh-my-patent adapt generate  # only writes to ./plugins/<tool>/, does not touch workspace
+```
+
+---
+
+## Full Usage
+
+```
+oh-my-patent <domain> <subcommand> [options]
+```
+
+### Brainstorm Path (`path`): track, branch, evaluate
+
+| Subcommand | What it does |
+|------------|--------------|
+| `path init <project>` | Initialize `.brainstorm/` and `state.json` |
+| `path record <project> --round <N> --data <json\|@file>` | Record round N with full scores, decisions, and innovation snapshots |
+| `path overview <project>` | Path summary: from start to finish, where you are now, whether the project is done |
+| `path node <project> <round-N>` | Details of a specific round: who said what, innovation scores, final decision |
+| `path innovation(s) <project> [ID]` | Full history of one innovation — when it was proposed, how it was rated, where it ended up |
+| `path branch <project> --from-node <id> --reason <text>` | **Fork** from any historical node to explore an alternative path with a different reason |
+| `path branches <project>` | List all branches |
+| `path restore <project> --node <id> --innovation <id>` | **Revive** a previously abandoned innovation and bring it back into the discussion |
+| `path threshold <project> --round <N>` | Evaluate whether the round's scores pass the threshold, with a recommendation (iterate or proceed) |
+| `path visualize <project> [--mode overview\|node\|innovation\|branch\|dashboard] --target <id>` | Terminal box-drawing visualization |
+| `path markdown <project> [--mode overview\|node\|innovation\|branch] --target <id>` | Export a Markdown report |
+
+### Patent Diagrams (`diagram`): extract, render, rewrite
+
+| Subcommand | What it does |
+|------------|--------------|
+| `diagram render <project> --specs <json\|@file> --phase draft\|final` | Batch render into `figures/` (SVG+PNG), and auto-update MAIN.md figure references |
+| `diagram status <project>` | Get the list of rendered figures (figureNumber, phase, file paths) |
+| `diagram rerender <project> --figure <ID> --source <mmd\|@file> --engine mermaid\|plantuml` | Update single figure (use after editing Mermaid/PlantUML source) |
+
+### Adapters (`adapt`): one command, all editors
+
+| Subcommand | What it does |
+|------------|--------------|
+| `adapt setup [--tool claude-code\|codex] [--workspace-dir .]` | Recommended entry. Installs editor configs, then shows the exact `uninstall` command |
+| `adapt install` | Behavior identical to `setup` |
+| `adapt uninstall [--tool <name>] [--workspace-dir .]` | **Exact-file removal only**. We do not touch your custom files |
+| `adapt generate` | Writes to `plugins/<tool>/` only, does not write to the workspace |
+
+### Interactive TUI (`tui`)
+
+```bash
+oh-my-patent tui [project-path]
+```
+
+Launches an Ink+React terminal UI. Navigate the decision path, view scores, switch branches, and revive innovations — all locally, no internet needed.
+
+---
+
+## The Workflow
+
+```
+User proposes a topic
+       ↓
+ [INIT]  Generate `projects/{NN}-{topic_slug}/`
+         Initialize .patent/state.json + .brainstorm/path.json
+       ↓
+ [RESEARCH] Patent search
+            → references/landscape.md (generated by landscape-analyst)
+       ↓
+ [BRAINSTORM_R1] Round 1
+            Head-to-head: innovation-architect generates candidates + adversarial-examiner attacks them
+            Scores are recorded, innovation snapshots saved to .brainstorm/nodes/round-1.json
+       ↓
+ [BRAINSTORM_R2] Round 2
+            Deep assessment by security-engineer, compliance-analyst, and evaluator
+       ↓ (threshold passed / 2 rounds done)
+ [DRAFT]  Generate initial disclosure
+            → MAIN.md (generated by patent-disclosure-writer)
+       ↓
+ [QA_LOOP] Review-rebuttal loop
+            Reviewer raises issues → technical-responder writes revisions
+            ≤ 6 rounds, exiting on 2 consecutive rounds with no new issues
+       ↓
+ [FINAL_REVIEW] Final pass, can loop back to QA_LOOP
+       ↓
+ [DIAGRAM] Automatically render patent figures
+            → figures/ (SVG + PNG, with automatic references rewritten in MAIN.md)
+       ↓
+ [DONE]   Quality gate: quality-gate check → finished
+
+           If the agent crashes mid-sentence: read state.json → resume from the exact stage
+           If you regret a round: `path branch --from-node round-{N}` → explore an alternative
+           If a long-forgotten innovation was actually good: `path restore` → bring it back
+```
+
+## Architecture
+
+The system is split into four layers:
+
+| Layer | What it governs | Key files |
+|-------|-----------------|-----------|
+| **Orchestration** | Agent/skill/command definitions. Defined once, consumed everywhere | `plugin.jsonc`, `opencode.jsonc`, `.opencode/skills/` |
+| **Engine** | Path tracking, state machine, figure rendering, threshold logic | `src/core/` |
+| **Command** | Unified CLI layer wrapping the engine's capabilities | `src/cli.ts`, `src/commands/` |
+| **Adapter** | Converts orchestration definitions into Claude Code / Codex -ready configs | `src/adapters/claude/`, `src/adapters/codex/` |
+
+Data flow between the layers:
+
+```
+  plugin.jsonc (orchestration layer definition)
+           ↓
+    [Adapters] generate automatically
+           ↓
+  .claude/ (Claude Code)    <—— one file, consumed all tools
+  .codex/ (Codex)           <——
+  AGENTS.md / CLAUDE.md
+  codex.json
+           ↓
+  AI in your editor invokes 11 specialist agents
+           ↓
+  Output → .brainstorm/ decision-path records
+  Output → state.json workflow state machine
+  Output → references/ with standardized filenames
+  Output → MAIN.md + figures/
+
+  CLI commands = automated operations on .brainstorm/ + .patent/ + references/
+  TUI = visualized browsing of .brainstorm/
+```
+
+## Directory Structure
+
+```
+oh-my-patent/              # Core repo: configs and engine; no project deliverables
+├── src/
+│   ├── cli.ts             # CLI entry point
+│   ├── core/
+│   │   ├── brainstorm-path.ts    # Decision-path data model + scoring thresholds
+│   │   ├── path-persistence.ts # Atomic writes + rollback
+│   │   ├── path-graph.ts       # Graph structure + forking algorithms
+│   │   ├── diagram-renderer.ts # Mermaid/PlantUML → SVG/PNG
+│   │   └── threshold-config.ts # Quantitative threshold model
+│   ├── commands/          # path init/record/overview/branch/restore...
+│   ├── adapters/          # Zero-config cross-tool adapters
+│   │   ├── claude/        # → .claude/ + CLAUDE.md
+│   │   └── codex/         # → .codex/ + AGENTS.md + codex.json
+│   └── tui/               # Ink+React interactive UI
+├── plugin.jsonc
+├── opencode.jsonc
+└── dist/ (compiled output)
+
+projects/{NN}-{topic_slug}/   # One Git repo per patent
+├── .brainstorm/
+│   ├── path.json             # Metadata + edges + current node + final decision
+│   ├── nodes/
+│   │   └── round-{n}.json    # Round detail: scores, innovations, decisions, timestamps
+│   ├── snapshots/
+│   │   └── round-{n}-innovations.json  # Innovation history snapshots
+│   └── branches/
+│       └── {branchId}/       # Branch steps — independent node copies
+├── .patent/
+│   └── state.json            # Workflow state machine: at DRAFT? QA round 3?
+├── references/
+│   ├── landscape.md          # Search results
+│   ├── brainstorm_round1_archimedes.md
+│   ├── argue_round2_adversarial-examiner.md
+│   └── ...                   # Every agent output follows a strict naming convention
+├── figures/
+│   ├── 001-system-overview.png
+│   ├── 001-system-overview.svg
+│   └── figures-manifest.json # Version management
+├── MAIN.md                   # Final disclosure (auto-updated by diagram inserter)
+└── conversation.md           # Chronological conversation log
+```
+
+## Script Quickref
+
+```bash
+npm run build  # Compile TypeScript → dist/
+npm test       # Run the vitest test suite
+npm run lint   # tsc --noEmit type checking
+```
+
+---
+
+## Acknowledgments
+
+Special thanks to:
+
+- **[LINUX DO Community](https://linux.do/)** 
+- All contributors who helped improve this project
+- The open-source community for the amazing tools and libraries that made this possible
+
+---
+
+## License
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,303 @@
+# oh-my-patent
+
+[![npm version](https://img.shields.io/npm/v/oh-my-patent.svg)](https://www.npmjs.com/package/oh-my-patent)
+[![npm downloads](https://img.shields.io/npm/dm/oh-my-patent.svg)](https://www.npmjs.com/package/oh-my-patent)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
+[![Tests](https://img.shields.io/badge/tests-87%20passing-brightgreen.svg)](https://github.com/zengbods/oh-my-patent)
+
+> 你的创意 → 完整的专利交底书，不需要你组织 11 个 AI 的智能体排队干活。
+
+## 一句话
+
+安装。写作 `/archimedes`，说你要什么。剩下的交给 11 个专利专用 AI 智能体。
+
+```bash
+npm install -g oh-my-patent
+oh-my-patent adapt setup --workspace-dir .
+```
+
+然后：
+
+```text
+/archimedes
+> 基于同态加密在隐私计算中的应用，新建一个专利项目。
+```
+
+它会自己检索、头脑风暴、评估可专利性、撰写、审查、生成附图。
+每一步的决策都被记录下来——你能回退到任意一轮、分叉探索替代方案、复活已放弃的创新点。
+
+---
+
+## 🎬 快速演示
+
+### oh-my-patent 之前
+![手动专利工作流](https://via.placeholder.com/800x400/2d3748/ffffff?text=手动工作流：在10个工具间切换，丢失上下文，手动合并输出)
+
+### oh-my-patent 之后
+![自动化专利工作流](https://via.placeholder.com/800x400/48bb78/ffffff?text=oh-my-patent：一条命令，11个智能体，可审计路径，自动附图)
+
+> **注意**: GIF 动画演示将在 v0.1.1 版本中添加。截图展示了工作流差异的概念。
+
+---
+
+## 你遇到的痛点 vs 这里怎么解决
+
+| 你的痛苦 | 别的工具怎么做 | oh-my-patent 怎么做 |
+|---|---|---|
+| 要问 10 个 AI 不同的提示词，再人工整理输出 | 你需要自己切分任务、粘贴对话、手动归并 | **Archimedes 主编排器**自动路由到 11 个专业智能体，每轮产出自动写入 `references/`，上下文在各轮间自动传递 |
+| 多轮头脑风暴翻完页就失忆了 | 对话历史丢失，放弃的创新点再也找不到 | **.brainstorm/ 决策路径系统**把每轮的评分、创新点、淘汰/通过决策持久化成有向无环图，支持回退、分叉、恢复 |
+| 写专利附图要画 Visio/PPT 再贴图 | 手动作图、另存为图片再插入 Word | **Mermaid/PlantUML 自动渲染**从交底书提取技术架构，输出 SVG+PNG 并自动回写 `MAIN.md` |
+| 帮同事安装 Claude Code 或 Codex 后，都给他写不同的配置 | Claude Code 一套，Codex 另一套，手抄 | **一条命令自动适配** Claude Code（.claude/ + CLAUDE.md）和 Codex（.codex/ + codex.json），卸载也是一条命令，且只删自己生成的文件 |
+| 写了一半机器崩了/对话断了 | 从 jpg 里翻截图，从零重来 | **工作流状态机**。所有阶段写入 `state.json` + 决策树写入 `path.json`，断点即续 |
+| 审查 6 轮后不知道自己到哪一关了 | 混乱的文档拼凑 | **量化阈值模型**自动判断头脑风暴是否成熟，QA 循环有明确的退出条件（连续 2 轮无新问题） |
+
+## 还有很多，但你不需要先读
+
+上表提到的功能已经够你跑完 90% 的用例。以下是完整的亮点怕你以后回来查：
+
+### 全部亮点
+
+| 图标 | 名称 | 一句话解释 |
+|-----:|:------|:------|
+| 🧠 | **头脑风暴决策路径追踪** | `.brainstorm/` 里自动保存每轮的评分、创新点、淘汰/通过决策。能回退到任意节点、分叉探索替代方向、复活已放弃创新点 |
+| 🤖 | **11 智能体端到端流水线** | 检索 → 创意激发 → 可专利性评估 → 撰写 → 审查 → 答辩 → 附图，覆盖交底书全生命周期 |
+| ⚡ | **`/archimedes` 一句话启动** | 不管什么命令，先找 Archimedes。他判断阶段、分配任务、传递上下文、等待产出、推进下一关 |
+| 🔗 | **零配置跨工具适配器** | `oh-my-patent adapt setup` 一条命令给 Claude Code 和 Codex 同时注册配置 |
+| 🛡️ | **安全卸载** | 精确文件级清理——只删自动生成的文件，绝不 `readdir + unlink` 遍历你工作区 |
+| 📊 | **自动附图渲染** | 解析 MAIN.md 中的技术架构描述，Mermaid/PlantUML → SVG/PNG，自动回写 |
+| 🎯 | **评分阈值与 QA 循环** | 量化阈值模型自动判断头脑风暴够不够深入；审查阶段最多 6 轮 QA 循环，直到连续 2 轮无新问题 |
+| 💻 | **交互式终端蓝草图** | 基于 Ink+React 的 TUI，本地可视化浏览决策路径、节点详情、分支概览 |
+| 🔄 | **可恢复工作流** | `INIT → RESEARCH → BRAINSTORM → DRAFT → QA_LOOP → FINAL_REVIEW → DIAGRAM → DONE`，机器崩溃也能从 `state.json` 接上 |
+
+## 完整安装
+
+### 全局安装（发布到 npm 后）
+
+```bash
+npm install -g oh-my-patent
+```
+
+### 本地开发
+
+```bash
+# 克隆项目
+git clone <你的仓库地址>
+cd oh-my-patent
+npm install
+npm run build
+```
+
+构建后使用 `node dist/cli.js` 或 `npx -p . oh-my-patent`。
+
+### 为工作区安装编辑器配置
+
+进入你的项目根目录（即 `projects/` 所在目录）：
+
+```bash
+# 安装全部适配器（Claude Code + Codex）
+oh-my-patent adapt setup --workspace-dir .
+
+# 或只装一个
+oh-my-patent adapt setup --tool claude-code --workspace-dir .
+```
+
+安装完后会给你对应的 `uninstall` 命令提示。
+
+更多安装方式：
+
+```bash
+oh-my-patent adapt install   # 与 setup 相同
+oh-my-patent adapt generate  # 仅生成到 ./plugins/<tool>/ 不写入工作区
+```
+
+---
+
+## 完整用法
+
+```
+oh-my-patent <域> <子命令> [选项]
+```
+
+### 头脑风暴路径（`path`）：追踪、分叉、评估
+
+| 子命令 | 用途 |
+|--------|------|
+| `path init <项目>` | 初始化 `.brainstorm/` 目录结构和 `state.json` |
+| `path record <项目> --round <N> --data <json\|@文件>` | 记录第 N 轮完整数据（评分、决策、创新点快照） |
+| `path overview <项目>` | 路径概览：从哪到哪、当前在哪、是否完成 |
+| `path node <项目> <round-N>` | 查看某轮详情：谁说了什么、创新点评分、最终决策 |
+| `path innovation(s) <项目> [ID]` | 一个创新点的全部历史（哪轮提出、哪轮评估、后来去哪了） |
+| `path branch <项目> --from-node <id> --reason <原因>` | **分叉**——从任意历史节点，用不同理由跑替代方案 |
+| `path branches <项目>` | 列出所有分支 |
+| `path restore <项目> --node <id> --innovation <id>` | **复活**——把一个已放弃的创新点重新带回讨论 |
+| `path threshold <项目> --round <N>` | 该轮评分是否通过阈值，给出建议（继续迭代 / 进入撰写） |
+| `path visualize <项目> [--mode overview\|node\|innovation\|branch\|dashboard] --target <id>` | 终端 box-drawing 可视化 |
+| `path markdown  <项目> [--mode overview\|node\|innovation\|branch] --target <id>` | 导出 Markdown 报告 |
+
+### 专利附图（`diagram`）：自动提取、渲染、回写
+
+| 子命令 | 用途 |
+|--------|------|
+| `diagram render <项目> --specs <json\|@文件> --phase draft\|final` | 批量渲染，输出 SVG+PNG，自动更新 MAIN.md 的图表引用 |
+| `diagram status <项目>` | 查看已渲染图表清单（含 figureNumber、phase、文件路径） |
+| `diagram rerender <项目> --figure <ID> --source <mmd\|@文件> --engine mermaid\|plantuml` | 更新单图（修改 Mermaid/PlantUML 源码后使用） |
+
+### 适配器（`adapt`）：一条命令适配所有编辑器
+
+| 子命令 | 用途 |
+|--------|------|
+| `adapt setup [--tool claude-code\|codex] [--workspace-dir .]` | 推荐入口。安装编辑器配置，带卸载提示 |
+| `adapt install` | 与 `setup` 行为一致 |
+| `adapt uninstall [--tool <name>] [--workspace-dir .]` | **只删自动生成的文件**。绝不碰你的自定义文件 |
+| `adapt generate` | 只生成到 `plugins/<tool>/`，不写入工作区 |
+
+### 交互式 TUI（`tui`）
+
+```bash
+oh-my-patent tui [项目路径]
+```
+
+启动 Ink+React 终端界面，键盘浏览决策路径、查看评分、切换分支、恢复创新点。
+
+---
+
+## 工作流
+
+```
+用户提出选题
+       ↓
+ [INIT]  生成 `projects/{NN}-{topic_slug}/`
+         初始化 .patent/state.json + .brainstorm/path.json
+       ↓
+ [RESEARCH] 专利检索
+            → references/landscape.md（由 landscape-analyst 产出）
+       ↓
+ [BRAINSTORM_R1] 第 1 轮
+            多头对战：innovation-architect 生成创意 + adversarial-examiner 砸漏洞
+            评分 ↔ 创新点快照 → .brainstorm/nodes/round-1.json
+       ↓
+ [BRAINSTORM_R2] 第 2 轮
+            深度评估：security-engineer + compliance-analyst + evaluator
+       ↓ (threshold 评估通过 / 2 轮)
+ [DRAFT]  生成交底书初稿
+            → MAIN.md（由 patent-disclosure-writer 产出）
+       ↓
+ [QA_LOOP] 审查-答辩循环
+            reviewer 提问题 → technical-responder 写修订
+            ≤ 6 轮，连续 2 轮无新 issue 则退出
+       ↓
+ [FINAL_REVIEW] 最终审查，决定通过或退回 QA_LOOP
+       ↓
+ [DIAGRAM] 自动渲染专利附图
+            → figures/（SVG + PNG + 回写 MAIN.md）
+       ↓
+ [DONE]   质量闸门：quality-gate 检查 → 完成
+
+           任意阶段崩溃后：读取 state.json 可精确定位断点
+           我不满意某轮结果：path branch --from-node round-{N} 开新分支
+           很久以前的创新点其实不错：path restore 复活它
+```
+
+## 架构
+
+这个系统分为四层：
+
+| 层 | 按照什么规则运转 | 关键文件 |
+|---|---|---|
+| **编排层** | 智能体/技能/命令的端口定义，一次定义，到处跑 | `plugin.jsonc`、`opencode.jsonc`、`.opencode/skills/` |
+| **引擎层** | 路径追踪、状态机、图表渲染、阈值评估 | `src/core/` |
+| **命令层** | 把引擎能力封装为统一的 CLI 命令 | `src/cli.ts`、`src/commands/` |
+| **适配层** | 把编排层的定义自动转成 Claude Code / Codex 需要的格式 | `src/adapters/claude/`, `src/adapters/codex/` |
+
+三层之间的数据流：
+
+```
+  plugin.jsonc（编排层定义）
+           ↓
+    [适配器] 自动生成
+           ↓
+  .claude/ (Claude Code)    <——一个文件，多处消费
+  .codex/ (Codex)           <——
+  AGENTS.md / CLAUDE.md
+  codex.json
+           ↓
+  编辑器中的 AI 调用 11 个专业智能体
+           ↓
+  产出 → .brainstorm/ 决策路径记录
+  产出 → state.json 工作流状态机
+  产出 → references/ 标准命名文件
+  产出 → MAIN.md + figures/
+
+  CLI 命令 = 对 .brainstorm/ + .patent/ + references/ 的自动化操作
+  TUI = 对 .brainstorm/ 的可视化浏览
+```
+
+## 目录结构
+
+```
+oh-my-patent/              # 核心仓库：配置与引擎，不存项目交付物
+├── src/
+│   ├── cli.ts             # CLI 入口
+│   ├── core/
+│   │   ├── brainstorm-path.ts    # 决策路径数据模型 + 分数阈值
+│   │   ├── path-persistence.ts # 原子写入 + 回滚
+│   │   ├── path-graph.ts       # 图结构 + 分叉算法
+│   │   ├── diagram-renderer.ts # Mermaid/PlantUML → SVG/PNG
+│   │   └── threshold-config.ts # 量化阈值模型
+│   ├── commands/          # path init/record/overview/branch/restore...
+│   ├── adapters/          # 零配置适配器
+│   │   ├── claude/        # → .claude/ + CLAUDE.md
+│   │   └── codex/         # → .codex/ + AGENTS.md + codex.json
+│   └── tui/               # Ink+React 交互界面
+├── plugin.jsonc
+├── opencode.jsonc
+└── dist/ (编译产物)
+
+projects/{NN}-{topic_slug}/   # 每个专利 = 独立 Git 仓库
+├── .brainstorm/
+│   ├── path.json             # 元数据 + 边 + 当前节点 + 最终决策
+│   ├── nodes/
+│   │   └── round-{n}.json    # 评分、创新点、决策、时间戳
+│   ├── snapshots/
+│   │   └── round-{n}-innovations.json  # 创新点历史快照
+│   └── branches/
+│       └── {branchId}/       # 分支独立节点副本
+├── .patent/
+│   └── state.json            # 工作流阶段机：到 DRAFT 了？第 3 轮 QA？
+├── references/
+│   ├── landscape.md          # 检索结果
+│   ├── brainstorm_round1_archimedes.md
+│   ├── argue_round2_adversarial-examiner.md
+│   └── ...                   # 所有产出都遵循命名规范
+├── figures/
+│   ├── 001-system-overview.png
+│   ├── 001-system-overview.svg
+│   └── figures-manifest.json # 版本管理
+├── MAIN.md                   # 最终交底书（随时被 diagram 回写）
+└── conversation.md           # 编年体对话记录
+```
+
+## 脚本速查
+
+```bash
+npm run build  # 编译 TypeScript → dist/
+npm test       # 运行 vitest 测试
+npm run lint   # tsc --noEmit 类型检查
+```
+
+---
+
+## 致谢
+
+特别感谢：
+
+- **[LINUX DO 社区](https://linux.do/)** - 在开发过程中提供了宝贵的反馈和支持
+- 所有帮助改进此项目的贡献者
+- 开源社区提供的出色工具和库，使这个项目成为可能
+
+---
+
+## 许可证
+
+MIT

package/dist/adapters/claude/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Claude Code Adapter
+ *
+ * Generates configuration files for Anthropic's Claude Code CLI from
+ * the portable oh-my-patent definitions.
+ *
+ * Outputs:
+ * - CLAUDE.md              → Project instructions with agent routing, commands, workflow rules
+ * - .claude/agents/*.md    → Per-agent prompt files (full prompt content, no OpenCode frontmatter)
+ * - .claude/settings.json  → MCP server configuration in Claude Code format
+ */
+import { PortableDef, ToolAdapter, GenerateResult } from '../types.js';
+export declare class ClaudeCodeAdapter implements ToolAdapter {
+    readonly name = "claude-code";
+    generate(def: PortableDef, config: Record<string, unknown>): Promise<GenerateResult>;
+    private generateAgentPrompt;
+    /**
+     * Build YAML frontmatter for ccb/Claude Code agent recognition.
+     * Must appear at the very top of the .md file as `--- ... ---`.
+     */
+    private buildAgentFrontmatter;
+    /**
+     * Build a concise HTML comment header for human readability.
+     * This appears after the YAML frontmatter, not as frontmatter itself.
+     */
+    private buildAgentCommentHeader;
+    private generateCommandFile;
+    private generateSettings;
+    private generateClaudeMd;
+    getGeneratedFilePaths(def: PortableDef): string[];
+    uninstall(def: PortableDef, workspaceDir: string): Promise<{
+        filesRemoved: string[];
+        filesSkipped: string[];
+        success: boolean;
+        message: string;
+    }>;
+}