Add inception bundled extension

.github/workflows/community-smoke.yml

@@ -48,6 +48,7 @@ jobs:
           test -f .specify/extensions/arch/extension.yml
           test -f .specify/extensions/preview/extension.yml
           test -f .specify/extensions/discovery/extension.yml
+          test -f .specify/extensions/inception/extension.yml
           test -f .specify/extensions/intake/extension.yml
           test -f .specify/extensions/repository-governance/extension.yml
           test -f .specify/presets/workflow-preset/preset.yml
@@ -99,6 +100,8 @@ jobs:
           done
           test -f .claude/skills/speckit-preview-wireflow/SKILL.md
           test -f .claude/skills/speckit-discovery-contract/SKILL.md
+          test -f .claude/skills/speckit-inception-product/SKILL.md
+          test -f .claude/skills/speckit-inception-arch/SKILL.md
           test -f .claude/skills/speckit-intake-visual-design/SKILL.md
           test -f .claude/skills/speckit-intake-prd/SKILL.md
           test -f .claude/skills/speckit-intake-test-cases/SKILL.md
@@ -119,7 +122,7 @@ jobs:
           grep -q "Vertical Planner Agent" .claude/skills/speckit-implement/SKILL.md
           grep -q "Worker Agent" .claude/skills/speckit-implement/SKILL.md
 
-          for extension_id in arch discovery intake preview repository-governance; do
+          for extension_id in arch discovery inception intake preview repository-governance; do
             /tmp/specify-community-smoke-venv/bin/specify extension remove "$extension_id" --force
             test ! -d ".specify/extensions/$extension_id"
             case "$extension_id" in
@@ -132,6 +135,9 @@ jobs:
               discovery)
                 test "$(find .claude/skills -maxdepth 1 -type d -name 'speckit-discovery-*' | wc -l)" -eq 0
                 ;;
+              inception)
+                test "$(find .claude/skills -maxdepth 1 -type d -name 'speckit-inception-*' | wc -l)" -eq 0
+                ;;
               intake)
                 test "$(find .claude/skills -maxdepth 1 -type d -name 'speckit-intake-*' | wc -l)" -eq 0
                 ;;
@@ -141,7 +147,7 @@ jobs:
             esac
           done
 
-          for extension_id in arch discovery intake preview repository-governance; do
+          for extension_id in arch discovery inception intake preview repository-governance; do
             /tmp/specify-community-smoke-venv/bin/specify extension add "$GITHUB_WORKSPACE/extensions/$extension_id" --dev
             case "$extension_id" in
               arch)
@@ -157,6 +163,12 @@ jobs:
                 test -f .claude/skills/speckit-discovery-contract/SKILL.md
                 grep -q "interface-contract discovery facilitator" .claude/skills/speckit-discovery-contract/SKILL.md
                 ;;
+              inception)
+                test -f .claude/skills/speckit-inception-product/SKILL.md
+                test -f .claude/skills/speckit-inception-arch/SKILL.md
+                grep -q "Conversation Workflow" .claude/skills/speckit-inception-product/SKILL.md
+                grep -q "API POC Workflow" .claude/skills/speckit-inception-arch/SKILL.md
+                ;;
               intake)
                 test -f .claude/skills/speckit-intake-visual-design/SKILL.md
                 test -f .claude/skills/speckit-intake-prd/SKILL.md

README.md

@@ -24,7 +24,7 @@
 
 如果你只是想知道这个仓库相比基础流程多了什么，可以先看这三件事：
 
-- 默认扩展：`arch`、`discovery`、`intake`、`preview`、`repository-governance`。
+- 默认扩展：`arch`、`discovery`、`inception`、`intake`、`preview`、`repository-governance`。
 - 默认预设：`workflow-preset`。
 - 自动上下文扩展：`agent-context`。
 
@@ -66,6 +66,7 @@ specify init my-project --integration codex --ignore-agent-tools
 | 自动扩展 | `agent-context` | `extensions/agent-context` | 维护 AGENTS、CLAUDE、Copilot 等 agent context 文件里的 Spec Kit 受管段。 |
 | 默认扩展 | `arch` | `extensions/arch` | 生成或反向生成面向 `/speckit.plan` 的架构规划契约。 |
 | 默认扩展 | `discovery` | `extensions/discovery` | 在正式计划前做可行性、技术选型、旧代码评估、接口理解、PoC 和场景化技术决策。 |
+| 默认扩展 | `inception` | `extensions/inception` | 在正式 SDD 前通过对话收敛产品 UC、wireflow、架构边界和真实 API POC 证据。 |
 | 默认扩展 | `intake` | `extensions/intake` | 把 PRD、设计稿、Figma、视觉规格资产包、preview 覆盖证据、测试用例等来源归一化为 SDD 可消费的证据包。 |
 | 默认扩展 | `preview` | `extensions/preview` | 从规格和计划生成低、中、高保真 Markdown 或自包含 HTML 预览。 |
 | 默认扩展 | `repository-governance` | `extensions/repository-governance` | 生成仓库治理 SSOT，帮助 agent 明确目录责任、读取顺序和事实证据。 |
@@ -75,6 +76,38 @@ specify init my-project --integration codex --ignore-agent-tools
 
 ## 默认扩展
 
+### `inception`
+
+`inception` 是正式规格化和工程迭代之前的启动设计阶段。它通过对话确认推进，不新增 workflow 命名层；命令会引导用户确认产品和架构前置材料，并用模板生成 `/inception/` 下的产物。
+
+常用命令：
+
+```text
+/speckit.inception.product
+/speckit.inception.arch
+```
+
+主要产物：
+
+```text
+inception/product/uc.md
+inception/product/wireflow-medium.html
+inception/product/wireflow-high.html
+inception/arch/api-capability.md
+inception/arch/api-poc.md
+inception/arch/system-boundary.md
+inception/arch/domain-model.md
+inception/arch/arch.md
+inception/arch/api-poc-runs/
+```
+
+使用建议：
+
+- 先跑 `/speckit.inception.product`，把产品想法收敛成 UC 和 medium/high wireflow。
+- 再跑 `/speckit.inception.arch`，只从 UC 出发做能力、边界、领域和架构前置设计。
+- API POC 不是伪代码；运行前必须确认目标能力、验证假设、环境、依赖、配置、样例输入、外部访问、允许副作用和停止条件，运行资产只写入 `inception/arch/api-poc-runs/`。
+- `inception` 不生成 `spec.md`、`plan.md`、`tasks.md`、OpenAPI、数据库 schema、生产代码或测试套件变更。
+
 ### `arch`
 
 `arch` 给项目补一层架构记忆。它不是 feature 计划，也不是实现设计；它负责把项目级边界、约束、已定决策、禁止方向、开放问题和 plan review checklist 写成唯一的规划契约。
@@ -157,35 +190,25 @@ specs/<feature>/intake/test-cases/
 
 ### `preview`
 
-`preview` 在实现前生成评审产物。它不改应用源码，不替代实现；它用当前 feature 的规格、计划和契约生成可以讨论的 wireflow 或 HTML 预览。
+`preview` 在实现前生成评审产物。它不改应用源码，不替代实现；它用当前 feature 的规格、计划和契约生成可以讨论的自包含 HTML wireflow。
 
 常用命令：
 
 ```text
-/speckit.preview.low-md
-/speckit.preview.low-html
-/speckit.preview.mid-md
-/speckit.preview.mid-html
-/speckit.preview.high-md
-/speckit.preview.high-html
+/speckit.preview.wireflow <low|mid|high> [design focus]
 ```
 
 主要产物：
 
 ```text
-specs/<feature>/preview/wireflow-low.md
-specs/<feature>/preview/wireflow-low.html
-specs/<feature>/preview/wireflow-mid.md
-specs/<feature>/preview/wireflow-mid.html
-specs/<feature>/preview/wireflow-high.md
-specs/<feature>/preview/wireflow-high.html
+specs/<feature>/preview/wireflow.html
 ```
 
 使用建议：
 
-- 需求还早期：用 `low-md` 或 `low-html` 看主路径和分支。
-- 产品、设计和工程需要一起评审：用 `mid-md` 或 `mid-html`。
-- 交互、状态、权限、响应式和错误反馈要确认：用 `high-md` 或 `high-html`。
+- 需求还早期：用 `low` 看主路径和分支。
+- 产品、设计和工程需要一起评审：用 `mid`。
+- 交互、状态、权限、响应式和错误反馈要确认：用 `high`。
 
 ### `repository-governance`
 
@@ -409,12 +432,14 @@ specify bundle build --path ./my-bundle
 
 ```text
 /speckit.constitution
+/speckit.inception.product
+/speckit.inception.arch
 /speckit.arch.generate
 /speckit.specify
 /speckit.clarify
 /speckit.discovery.feasibility
 /speckit.plan
-/speckit.preview.mid-html
+/speckit.preview.wireflow mid
 /speckit.tasks
 /speckit.analyze
 /speckit.implement
@@ -449,9 +474,9 @@ specify bundle build --path ./my-bundle
 ```text
 /speckit.intake.visual-design
 /speckit.specify
-/speckit.preview.low-md
+/speckit.preview.wireflow low
 /speckit.plan
-/speckit.preview.mid-html
+/speckit.preview.wireflow mid
 /speckit.tasks
 /speckit.implement
 ```
@@ -501,8 +526,10 @@ specify extension add bug
 | --- | --- | --- |
 | `.specify/memory/architecture.md` | `arch` | 面向 `/speckit.plan` 的架构规划契约。 |
 | `.specify/memory/repository-governance.md` | `repository-governance` | 内部仓库治理 SSOT。 |
+| `inception/product/` | `inception` | 产品 UC 和 medium/high wireflow 启动设计产物。 |
+| `inception/arch/` | `inception` | 架构前置设计、真实 API POC 证据和运行资产。 |
 | `specs/<feature>/intake/` | `intake` | PRD、视觉设计、测试用例的结构化证据包。 |
-| `specs/<feature>/preview/` | `preview` | Markdown wireflow 和自包含 HTML 预览。 |
+| `specs/<feature>/preview/` | `preview` | 单一自包含 HTML wireflow 预览。 |
 | `specs/<feature>/contracts/bdd/` | `workflow-preset` | BDD 行为契约。 |
 | `specs/<feature>/contracts/uif/` | `workflow-preset` | UI flow / interface fidelity 契约。 |
 | `specs/<feature>/contracts/behavior/` | `workflow-preset` | 行为场景、fixture、assertion 等正式契约。 |

docs/quickstart.md

@@ -14,13 +14,15 @@
 
 ```text
 /speckit.constitution
+/speckit.inception.product
+/speckit.inception.arch
 /speckit.arch.generate
 /speckit.repository-governance.generate
 /speckit.specify
 /speckit.clarify
 /speckit.plan
 /speckit.checklist
-/speckit.preview.mid-html
+/speckit.preview.wireflow mid
 /speckit.tasks
 /speckit.analyze
 /speckit.implement
@@ -178,16 +180,16 @@ specs/<feature>/checklists/behavior-testability.md
 对 UI、流程或交互有不确定性时，先生成保真度合适的预览产物：
 
 ```text
-/speckit.preview.mid-html mobile album browsing and reorder flow
+/speckit.preview.wireflow mid mobile album browsing and reorder flow
 ```
 
 打开输出文件评审：
 
 ```text
-specs/<feature>/preview/wireflow-mid.html
+specs/<feature>/preview/wireflow.html
 ```
 
-这个文件只用于实现前评审 flow、信息架构、状态和交互假设，不会修改生产代码。也可以按需要使用 `/speckit.preview.low-md`、`/speckit.preview.low-html`、`/speckit.preview.high-md` 或 `/speckit.preview.high-html`。
+这个文件只用于实现前评审 flow、信息架构、状态和交互假设，不会修改生产代码。也可以按需要使用 `/speckit.preview.wireflow low` 或 `/speckit.preview.wireflow high`。
 
 ## 7. 生成计划与行为契约
 
@@ -289,6 +291,7 @@ specify workflow search
 
 ```bash
 specify extension add arch
+specify extension add inception
 specify extension add preview
 specify extension add repository-governance
 specify preset add workflow-preset

extensions/catalog.json

@@ -69,6 +69,29 @@
         "core"
       ]
     },
+    "inception": {
+      "name": "SDD Inception",
+      "id": "inception",
+      "version": "1.0.0",
+      "description": "Guide pre-iteration product and architecture inception through conversational workflows before formal Spec Kit stages",
+      "author": "bigsmartben",
+      "repository": "https://github.com/bigsmartben/spec-kit",
+      "license": "MIT",
+      "bundled": true,
+      "requires": {
+        "speckit_version": ">=0.8.10.dev0"
+      },
+      "provides": {
+        "commands": 2
+      },
+      "tags": [
+        "inception",
+        "sdd",
+        "product",
+        "architecture",
+        "workflow"
+      ]
+    },
     "intake": {
       "name": "Intake",
       "id": "intake",

extensions/inception/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 1.0.0
+
+- Add product and architecture inception workflow commands.
+- Add template-backed inception artifacts under `inception/product/` and `inception/arch/`.
+- Require user-confirmed preparation before running real API POC code.

extensions/inception/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bigsmartben
+
+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.

extensions/inception/README.md

@@ -0,0 +1,69 @@
+# SDD Inception Extension
+
+Run the pre-iteration inception stage before formal Spec Kit specification and planning.
+
+This extension provides two conversational workflow commands:
+
+```text
+/speckit.inception.product
+/speckit.inception.arch
+```
+
+The commands guide the user through confirmation points, then write only inception artifacts under the project root `inception/` directory.
+
+## Product Inception
+
+`/speckit.inception.product` converges product ideas into:
+
+```text
+inception/product/uc.md
+inception/product/wireflow-medium.html
+inception/product/wireflow-high.html
+```
+
+`wireflow-medium.html` and `wireflow-high.html` are derived from `uc.md`. They must not create new product facts and must not overwrite the product boundary established in `uc.md`.
+
+## Architecture Inception
+
+`/speckit.inception.arch` uses one formal input:
+
+```text
+inception/product/uc.md
+```
+
+It writes:
+
+```text
+inception/arch/api-capability.md
+inception/arch/api-poc.md
+inception/arch/system-boundary.md
+inception/arch/domain-model.md
+inception/arch/arch.md
+inception/arch/api-poc-runs/
+```
+
+`api-capability.md` includes a technology selection matrix that compares candidate options for high-value or high-risk capabilities, then records recommended, backup, and rejected options with tradeoff rationale.
+
+`api-poc.md` records real code execution evidence. Before running any POC code, the command must confirm the target capability, validation hypothesis, runtime environment, dependencies, credential/config needs, sample input, external service access, allowed side effects, and stop conditions with the user.
+
+POC code and outputs are confined to:
+
+```text
+inception/arch/api-poc-runs/<capability-slug>/
+```
+
+## Boundaries
+
+The inception commands do not create formal Spec Kit artifacts:
+
+```text
+spec.md
+plan.md
+tasks.md
+OpenAPI
+database schema
+application implementation
+test suite changes
+```
+
+Use `/speckit.specify` after product inception, and use `/speckit.plan` after formal specs and architecture context are ready.