Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ specify init my-project --integration codex --ignore-agent-tools
| 默认扩展 | `arch` | `extensions/arch` | 生成或反向生成面向 `/speckit.plan` 的架构规划契约。 |
| 默认扩展 | `discovery` | `extensions/discovery` | 在正式计划前做可行性、技术选型、旧代码评估、接口理解、PoC 和场景化技术决策。 |
| 默认扩展 | `inception` | `extensions/inception` | 在正式 SDD 前通过对话收敛产品 UC、wireflow、架构边界和真实 API POC 证据。 |
| 默认扩展 | `intake` | `extensions/intake` | 把 PRD、设计稿、Figma、视觉规格资产包、preview 覆盖证据、测试用例等来源归一化为 SDD 可消费的证据包。 |
| 默认扩展 | `intake` | `extensions/intake` | 把 PRD、设计稿、Figma、最终静态 HTML 交付、测试用例等来源归一化为 SDD 可消费的证据包。 |
| 默认扩展 | `preview` | `extensions/preview` | 从规格和计划生成低、中、高保真 Markdown 或自包含 HTML 预览。 |
| 默认扩展 | `repository-governance` | `extensions/repository-governance` | 生成仓库治理 SSOT,帮助 agent 明确目录责任、读取顺序和事实证据。 |
| 默认预设 | `workflow-preset` | `presets/workflow-preset` | 强化 BDD、NFR、UIF、设计产物、任务验证策略和 implement handoff 编排。 |
Expand Down Expand Up @@ -173,16 +173,16 @@ inception/arch/api-poc-runs/

- PRD、产品说明、Markdown、PDF、导出的文档。
- 图片、线框图、设计 PDF、Figma 文件、Figma 页面或节点。
- 视觉规格结构化资产包,以及 Figma 派生的组件矩阵 preview 覆盖证据
- 设计稿派生的视觉 IR、操作回放、动效锚点、视口截图和最终静态 HTML 交付证据
- 既有测试、Gherkin、手工测试用例、QA 导出、测试管理表格。

主要产物:

```text
specs/<feature>/intake/prd/
specs/<feature>/intake/visual-design/
specs/<feature>/intake/visual-design/visual-spec-package/
specs/<feature>/intake/visual-design/previews/
specs/<feature>/intake/visual-design/visual-ir/
specs/<feature>/intake/visual-design/delivery/
specs/<feature>/intake/test-cases/
```

Expand Down
2 changes: 1 addition & 1 deletion docs/community/extensions.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ The following community-contributed extensions are available in [`catalog.commun
| GitHub Issues Integration 2 | Creates and syncs local specs from an existing GitHub issue | `integration` | Read+Write | [spec-kit-issue](https://github.com/aaronrsun/spec-kit-issue) |
| Golden Demo | Extracts acceptance criteria from specs, builds test vectors, and produces a behavioral drift report — complementary to Architecture Guard and CDD | `docs` | Read+Write | [spec-kit-golden-demo](https://github.com/jasstt/spec-kit-golden-demo) |
| Improve Extension | Audits any codebase as a senior advisor and writes prioritized, self-contained spec prompts under specs/ that the spec-kit lifecycle can process | `process` | Read+Write | [spec-kit-improve](https://github.com/d0whc3r/spec-kit-improve) |
| Intake | Normalize PRD, visual design/spec packages, preview evidence, and test-case evidence into SDD-ready intake artifacts | `docs` | Read+Write | [spec-kit-intake](https://github.com/bigsmartben/spec-kit-intake) |
| Intake | Normalize PRD, visual design, final static HTML delivery, and test-case evidence into SDD-ready intake artifacts | `docs` | Read+Write | [spec-kit-intake](https://github.com/bigsmartben/spec-kit-intake) |
| Intelligent Agent Orchestrator | Cross-catalog agent discovery and intelligent prompt-to-command routing | `process` | Read+Write | [spec-kit-orchestrator](https://github.com/pragya247/spec-kit-orchestrator) |
| Iterate | Iterate on spec documents with a two-phase define-and-apply workflow — refine specs mid-implementation and go straight back to building | `docs` | Read+Write | [spec-kit-iterate](https://github.com/imviancagrace/spec-kit-iterate) |
| Jira Integration | Create Jira Epics, Stories, and Issues from spec-kit specifications and task breakdowns with configurable hierarchy and custom field support | `integration` | Read+Write | [spec-kit-jira](https://github.com/mbachorik/spec-kit-jira) |
Expand Down
9 changes: 5 additions & 4 deletions extensions/catalog.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"schema_version": "1.0",
"updated_at": "2026-07-06T00:00:00Z",
"updated_at": "2026-07-07T00:00:00Z",
"catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/extensions/catalog.json",
"extensions": {
"agent-context": {
Expand Down Expand Up @@ -95,8 +95,8 @@
"intake": {
"name": "Intake",
"id": "intake",
"version": "0.1.5",
"description": "Normalize PRD, visual design/spec packages, preview evidence, and test-case evidence into SDD-ready intake artifacts",
"version": "0.2.0",
"description": "Normalize PRD, visual design, final static HTML delivery, and test-case evidence into SDD-ready intake artifacts",
"author": "bigsmartben",
"repository": "https://github.com/bigsmartben/spec-kit-intake",
"license": "MIT",
Expand All @@ -113,7 +113,8 @@
"sdd",
"requirements",
"validation",
"figma"
"figma",
"static-html"
]
},
"preview": {
Expand Down
66 changes: 13 additions & 53 deletions extensions/intake/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,62 +1,22 @@
# Changelog
# Changelog

## [0.1.5] - 2026-07-03
## [0.2.0] - 2026-07-07

### Added

- Added `capture_figma_metadata_shards.py` to stage sharded Figma `get_metadata` captures into canonical raw metadata shards, index, and node inventory artifacts without passing large provider responses through agent context.
- Added `normalize_figma_layout.py`, `figma-normalized-tree.yaml`, and schema-backed readiness checks for Figma rename, grouping, and visual re-sort normalization after raw metadata parity passes.
- Added HTML mock readiness checks that require rendered mock page surfaces, page visual-state enumerations, page IA matrices, component visual-state enumerations, component IA matrices with interaction refs, and coverage evidence conclusions.
- Added HTML mock readiness checks for adjacent visual spec package readiness, `visual-spec-package/visual-spec.yaml` refs, visualized component node kinds, and preview-local screenshot refs.
- Added structured UI/visual asset source-of-truth checks that block evidence packets, preview HTML, screenshots, and visual diffs from being used as `source_refs` or `evidence_refs`.

### Changed

- Repositioned `previews/preview.html` as the static HTML/CSS mock equivalent for the visual input design generated from upstream intake artifacts, with coverage YAML preserving machine-checkable traceability.
- Kept Figma layout normalization as a derived artifact that does not rewrite raw metadata or replace `visual-requirements.yaml` source-backed facts.

## [0.1.4] - 2026-07-01

### Added

- Added visual-design visual spec package artifacts for CI-friendly DOM, ARIA, token, state, locator, relation, and assertion evidence.
- Added visual spec package schemas and `validate_visual_spec_package.py` for source readiness, cross-reference, provider-evidence, product-ambiguity, locator, downstream-ownership, and CI assertion checks.
- Added `visual-design/previews/` with `preview.html` as the visual-equivalent HTML delivery and `component-coverage.yaml` / `viewport-coverage.yaml` for machine-checkable coverage evidence under `/speckit.intake.visual-design`.

## [0.1.3] - 2026-06-29

### Added

- Added Figma-derived HTML mock coverage evidence with component-state, page, asset, viewport, screenshot, and known-gap readiness checks.
- Added bounded visual inference statuses for irregular Figma and visual-design sources, including `candidate` and `unsupported` claim handling.
- Added readiness blocking for unbounded visual inference and unsupported visual claims.

## [0.1.2] - 2026-06-23

### Changed

- Added release installation and runtime dependency documentation.
- Shortened manifest description and reduced tags for community catalog submission.

## [0.1.1] - 2026-06-23

### Changed

- Added community catalog metadata for category and effect.
### Breaking Reset

## [0.1.0] - 2026-06-23
- Rebuilt `/speckit.intake.visual-design` as the only external visual-intake entrypoint. Workflow phases are internal orchestration only; users do not invoke visual subcommands.
- Removed legacy preview/mock and visual spec package delivery surfaces from the extension source. The final visual deliverable is now `specs/<feature>/intake/visual-design/delivery/index.html`.
- Replaced preview/spec-package readiness with static HTML delivery readiness across `README.md`, `extension.yml`, `config-template.yml`, contracts, schemas, validators, and tests.

### Added

- Initial Spec Kit extension manifest.
- Intake commands for visual design, PRD, and test-case sources.
- Intake contracts and evidence packet templates for visual design, PRD, and test-case sources.
- Local readiness validators for PRD, test-case, visual design, and Figma metadata intake artifacts.
- Added `templates/intake-static-html-delivery-contract.md` as the static HTML delivery contract.
- Added `templates/schemas/static-html-delivery.schema.json` for `delivery/render-replay-report.yaml`.
- Added `scripts/python/validate_static_html_delivery.py` for static HTML delivery readiness.
- Added validator checks for visual IR readiness, exact `visual_ir_refs` parity, IR fragment resolution, source-intake ref resolution, typed HTML anchor namespaces, clarification-log structure, asset resolution, operation replay, motion anchors, viewport screenshots, visual diffs, and delivery evidence packets.

### Changed

- Repositioned the extension as the generic `intake` extension with domain commands for visual design, PRD, and test-case sources.
- Expanded the extension goal from Figma-only metadata intake to visual design requirement intake.
- Added support contracts for image, PDF, Markdown, and Figma sources across low, medium, and high-fidelity drafts.
- Added readiness concepts for source integrity, visual requirement traceability, fidelity rules, and delivery parity planning.
- Updated the validator to support generic visual sources while preserving Figma metadata parity validation.
- Visual intake now requires source-backed visual IR artifacts for assets/resources, layout/boxes, component states, page/route/IA states, user-operation replay, motion/event anchors, and clarification questions.
- Static delivery readiness now blocks when user-confirmed operation behavior, route behavior, responsive rules, resource substitutions, or motion timing is missing.
- Source refs now reject generated delivery HTML, delivery screenshots, visual diff outputs, and evidence packets as source-of-truth records.
Loading
Loading