Skip to content

[Extension]: Add Intake #3110

Description

@bigsmartben

Extension ID

intake

Extension Name

Intake

Version

0.1.2

Description

Normalize PRD, design, and test-case evidence into SDD-ready intake artifacts.

Author

bigsmartben

Repository URL

https://github.com/bigsmartben/spec-kit-intake

Download URL

https://github.com/bigsmartben/spec-kit-intake/archive/refs/tags/v0.1.2.zip

License

MIT

Homepage

https://github.com/bigsmartben/spec-kit-intake

Documentation URL

https://github.com/bigsmartben/spec-kit-intake/blob/main/README.md

Changelog URL

https://github.com/bigsmartben/spec-kit-intake/blob/main/CHANGELOG.md

Required Spec Kit Version

=0.8.10.dev0

Required Tools

  • figma-mcp - optional, used only for Figma metadata capture
  • Python validator dependencies: PyYAML and jsonschema

Number of Commands

3

Number of Hooks

1

Tags

intake, sdd, requirements, validation, figma

Key Features

  • Capture and validate PRD evidence into prd-intake.yaml with source refs, acceptance signals, and clarification gaps.
  • Capture and validate visual-design evidence from images, PDFs, Markdown briefs, and Figma sources into visual-requirements.yaml.
  • Capture and validate existing test-case evidence into test-case-intake.yaml with assertions, fixtures, coverage gaps, and traceability.
  • Provide schemas, contracts, evidence packet templates, and readiness validators for each intake domain.
  • Add an optional before_specify hook to validate visual-design intake before downstream SDD projection.

Testing Checklist

  • Extension installs successfully via download URL
  • All commands execute without errors
  • Documentation is complete and accurate
  • No security vulnerabilities identified
  • Tested on at least one real project

Submission Requirements

  • Valid extension.yml manifest included
  • README.md with installation and usage instructions
  • LICENSE file included
  • GitHub release created with version tag
  • All command files exist and are properly formatted
  • Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Tested on:

  • Windows with specify 0.11.3.dev0
  • Local spec-kit checkout manifest parser
  • Fresh temporary Spec Kit project initialized via specify init demo --integration generic --integration-options="--commands-dir .codex/commands/" --ignore-agent-tools

Test project:

  • Fresh temporary Spec Kit project at %TEMP%/spec-kit-intake-submit-test3/demo

Test scenarios:

  1. Parsed extension.yml with specify_cli.extensions.ExtensionManifest; result: manifest ok intake 0.1.2 3 True.
  2. Ran repository contract tests with python -m pytest; result: 27 passed.
  3. Installed the release archive with specify extension add intake --from https://github.com/bigsmartben/spec-kit-intake/archive/refs/tags/v0.1.2.zip --force; result: Extension installed successfully.
  4. Verified specify extension list reports Intake (v0.1.2), 3 commands, 1 hook, enabled.
  5. Verified installed command files exist under .specify/extensions/intake/commands/.

Example Usage

# Install extension from the release archive
specify extension add intake --from https://github.com/bigsmartben/spec-kit-intake/archive/refs/tags/v0.1.2.zip

# Capture and validate PRD intake
/speckit.intake.prd capture <prd source and scope>
/speckit.intake.prd validate

# Capture and validate visual design intake
/speckit.intake.visual-design capture <image|pdf|markdown|figma source and scope>
/speckit.intake.visual-design validate

# Capture and validate test-case intake
/speckit.intake.test-cases capture <test source and scope>
/speckit.intake.test-cases validate

Proposed Catalog Entry

{
  "intake": {
    "name": "Intake",
    "id": "intake",
    "description": "Normalize PRD, design, and test-case evidence into SDD-ready intake artifacts",
    "author": "bigsmartben",
    "version": "0.1.2",
    "download_url": "https://github.com/bigsmartben/spec-kit-intake/archive/refs/tags/v0.1.2.zip",
    "repository": "https://github.com/bigsmartben/spec-kit-intake",
    "homepage": "https://github.com/bigsmartben/spec-kit-intake",
    "documentation": "https://github.com/bigsmartben/spec-kit-intake/blob/main/README.md",
    "changelog": "https://github.com/bigsmartben/spec-kit-intake/blob/main/CHANGELOG.md",
    "license": "MIT",
    "category": "docs",
    "effect": "read-write",
    "requires": {
      "speckit_version": ">=0.8.10.dev0",
      "tools": [
        {
          "name": "figma-mcp",
          "required": false
        }
      ]
    },
    "provides": {
      "commands": 3,
      "hooks": 1
    },
    "tags": ["intake", "sdd", "requirements", "validation", "figma"],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-06-23T00:00:00Z",
    "updated_at": "2026-06-23T00:00:00Z"
  }
}

Additional Context

This extension focuses on high-information source restoration before downstream Spec Kit workflows project evidence into requirements. It keeps source references and uncertainty explicit across PRDs, visual designs, and existing test cases.

Metadata

Metadata

Assignees

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions