Skip to content

Create specification vs Update specification

Create specification is an open-source agent skill for developer tools. Update specification is an open-source agent skill for developer tools.

  • Create specification is best for write a specification for a new internal api before implementation.
  • Update specification is best for update a spec after a new feature requirement is added.
What it is
Create specification is an open-source agent skill for developer tools.
Update specification is an open-source agent skill for developer tools.
Best for
Write a specification for a new internal API before implementation
Update a spec after a new feature requirement is added
Kind
Skill
Skill
Pricing
Open source
Open source
Platforms
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
GitHub stars
41.3K
41.3K
Last commit
Nov 2026
Nov 2026
License
MIT
MIT
Open source
Good for
Write a specification for a new internal API before implementation; Draft a requirements document for a data pipeline; Create an architecture spec for a microservice
Update a spec after a new feature requirement is added; Revise a specification to match recent changes in the codebase; Restructure an existing design document into an AI-readable spec

What Create specification does

  • Structured specification template

    Provides a numbered Markdown template covering purpose, requirements, interfaces, acceptance criteria and validation.

  • Requirement identifiers

    Uses prefixed IDs such as REQ, SEC, CON and GUD so each requirement and constraint can be referenced.

  • Acceptance criteria format

    Encourages testable criteria written in Given-When-Then or shall-statement form.

  • Test strategy section

    Includes a section for test levels, frameworks, test data handling and CI integration.

  • Dependency classification

    Separates external systems, third-party services, infrastructure, data, platform and compliance dependencies.

  • Naming and front matter rules

    Sets a filename convention under /spec/ and a YAML header with title, dates, owner and tags.

What Update specification does

  • Structured specification template

    Provides a numbered template covering scope, requirements, interfaces, acceptance criteria and validation.

  • Labelled requirement identifiers

    Asks for IDs such as REQ, SEC, CON and GUD so each rule can be referenced unambiguously.

  • Given-When-Then acceptance criteria

    Guides writing testable acceptance criteria in a consistent behavioural format.

  • AI-ready writing rules

    Requires explicit wording, defined acronyms and self-contained sections that suit machine parsing.

  • Dependency classification

    Organises external systems, services, infrastructure, data and compliance dependencies into separate categories.

  • Test strategy outline

    Lays out test levels, frameworks, data handling, CI integration and coverage expectations.

Create specification vs Update specification: questions

Is Create specification or Update specification cheaper?

Both are open source. Compare current plans on each official site.

What is the difference between Create specification and Update specification?

Create specification is an open-source agent skill for developer tools. Update specification is an open-source agent skill for developer tools.

Keep comparing