Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
docs: add scenario-first README chooser
ketpatil776f0ccebc801e
diff --git a/README.md b/README.mdindex ffbb93e6..435a48c8 100644--- a/README.md+++ b/README.md@@ -137,13 +137,13 @@ Continue with focused requests such as `add Redis`, `move auth to the left`, or## Choose the right diagram-| Type | Best for | Include in your prompt |+| Type | Copyable prompt | Example ||---|---|---|-| **Architecture** | Components, services, storage, boundaries | Scope, core components, primary path |-| **Workflow** | CI/CD, approvals, tool calls, runbooks | Participants, order, branches, exceptions |-| **Sequence** | API calls, cache fallback, auth, async traces | Callers, callees, returns, timing |-| **Data Flow** | Pipelines, lineage, PII, consumers | Sources, transforms, stores, boundaries |-| **Lifecycle** | States, retries, waits, terminal outcomes | States, events, retry and cancellation paths |+| **Architecture** | `Map runtime components, boundaries, and primary path with Archify.` | [Production deployment](https://tt-a1i.github.io/archify/gallery/artifacts/production-deployment.architecture.html) |+| **Workflow** | `Map participants, branches, approvals, and retries with Archify.` | [Agent tool-call workflow](https://tt-a1i.github.io/archify/gallery/artifacts/agent-tool-call.workflow.html) |+| **Sequence** | `Map API request, responses, and failure paths with Archify.` | [Async job round trip](https://tt-a1i.github.io/archify/gallery/artifacts/async-job-roundtrip.sequence.html) |+| **Data Flow** | `Map sources, transforms, stores, and boundaries with Archify.` | [Event stream dataflow](https://tt-a1i.github.io/archify/gallery/artifacts/event-stream.dataflow.html) |+| **Lifecycle** | `Map states, events, retries, and terminal outcomes with Archify.` | [Agent run lifecycle](https://tt-a1i.github.io/archify/gallery/artifacts/agent-run.lifecycle.html) |Architecture's optional `deployment-ownership` profile fails closed when authored owners, region placement, private database scope, or named crossings are missing; it is never implicit and does not inspect live infrastructure. See the [checked deployment proof](https://tt-a1i.github.io/archify/gallery.html#proof-deployment-ownership).diff --git a/README_EN.md b/README_EN.mdindex ffbb93e6..435a48c8 100644--- a/README_EN.md+++ b/README_EN.md@@ -137,13 +137,13 @@ Continue with focused requests such as `add Redis`, `move auth to the left`, or## Choose the right diagram-| Type | Best for | Include in your prompt |+| Type | Copyable prompt | Example ||---|---|---|-| **Architecture** | Components, services, storage, boundaries | Scope, core components, primary path |-| **Workflow** | CI/CD, approvals, tool calls, runbooks | Participants, order, branches, exceptions |-| **Sequence** | API calls, cache fallback, auth, async traces | Callers, callees, returns, timing |-| **Data Flow** | Pipelines, lineage, PII, consumers | Sources, transforms, stores, boundaries |-| **Lifecycle** | States, retries, waits, terminal outcomes | States, events, retry and cancellation paths |+| **Architecture** | `Map runtime components, boundaries, and primary path with Archify.` | [Production deployment](https://tt-a1i.github.io/archify/gallery/artifacts/production-deployment.architecture.html) |+| **Workflow** | `Map participants, branches, approvals, and retries with Archify.` | [Agent tool-call workflow](https://tt-a1i.github.io/archify/gallery/artifacts/agent-tool-call.workflow.html) |+| **Sequence** | `Map API request, responses, and failure paths with Archify.` | [Async job round trip](https://tt-a1i.github.io/archify/gallery/artifacts/async-job-roundtrip.sequence.html) |+| **Data Flow** | `Map sources, transforms, stores, and boundaries with Archify.` | [Event stream dataflow](https://tt-a1i.github.io/archify/gallery/artifacts/event-stream.dataflow.html) |+| **Lifecycle** | `Map states, events, retries, and terminal outcomes with Archify.` | [Agent run lifecycle](https://tt-a1i.github.io/archify/gallery/artifacts/agent-run.lifecycle.html) |Architecture's optional `deployment-ownership` profile fails closed when authored owners, region placement, private database scope, or named crossings are missing; it is never implicit and does not inspect live infrastructure. See the [checked deployment proof](https://tt-a1i.github.io/archify/gallery.html#proof-deployment-ownership).diff --git a/README_ZH.md b/README_ZH.mdindex 1676447e..68d61d43 100644--- a/README_ZH.md+++ b/README_ZH.md@@ -130,13 +130,13 @@ DeepSeek Harness(社区集成、显式启用):运行 `dsh plugin --profile## 选择合适的图表-| 类型 | 最适合 | Prompt 中应包含 |+| 类型 | 可复制的 Prompt | 已验证示例 ||---|---|---|-| **Architecture** | 组件、服务、存储和系统边界 | 范围、核心组件、主要路径 |-| **Workflow** | CI/CD、审批、工具调用、Runbook | 参与者、顺序、分支、异常 |-| **Sequence** | API 调用、缓存回源、鉴权、异步链路 | 调用方、被调用方、返回、时序 |-| **Data Flow** | 数据管线、血缘、PII、下游消费者 | 来源、转换、存储、边界 |-| **Lifecycle** | 状态、重试、等待、终态 | 状态、事件、重试与取消路径 |+| **Architecture** | `使用 Archify 梳理运行时组件、边界和主要路径。` | [生产部署架构](https://tt-a1i.github.io/archify/gallery/artifacts/production-deployment.architecture.html) |+| **Workflow** | `使用 Archify 梳理参与者、分支、审批和重试。` | [Agent 工具调用工作流](https://tt-a1i.github.io/archify/gallery/artifacts/agent-tool-call.workflow.html) |+| **Sequence** | `使用 Archify 梳理这个 API 请求、响应和失败路径。` | [异步任务往返序列](https://tt-a1i.github.io/archify/gallery/artifacts/async-job-roundtrip.sequence.html) |+| **Data Flow** | `使用 Archify 梳理来源、转换、存储和边界。` | [事件流数据流](https://tt-a1i.github.io/archify/gallery/artifacts/event-stream.dataflow.html) |+| **Lifecycle** | `使用 Archify 梳理状态、事件、重试和终态。` | [Agent 运行生命周期](https://tt-a1i.github.io/archify/gallery/artifacts/agent-run.lifecycle.html) |做生产部署评审时,Architecture 可以按需启用 `deployment-ownership`工程画像:负责人、单一区域归属、数据库私有边界或边界穿越机制缺失时会直接阻断。