Skip to content
@specscore

SpecScore - an open standard for AI-readable software specifications

README.md

SpecScore

An open standard for AI-readable software specifications.

Structured Markdown + YAML for features, requirements, acceptance criteria, plans, and tasks — designed so AI agents can read a spec and execute against it without losing information to ambiguity. Specs are plain files in spec/. Lint runs in CI and in pre-commit hooks. Status transitions are CLI-driven.

A SpecScore feature on cream drafting paper: two requirements pass lint (green checks), one fails (red mark).

SpecScore.md — the open format

The open Markdown + YAML format for software specifications. Portable by construction: adopt with any AI-coding tool, or none. Your specs come with you.

curl -fsSL https://specscore.md/install/get-cli | sh

specscore spec lint              # validate the current spec tree
specscore feature list           # list features
specscore feature show <slug>    # inspect a feature

SpecStudio Skill — the Claude Code plugin

The fastest way to write strongly-formatted, lintable SpecScore specifications with an AI agent. An opinionated spec-driven-development workflow: /ideate → /specify → /plan → /implement.

/plugin marketplace add specscore/ai-marketplace
/plugin install specstudio@specscore

SpecScore.Studio — the hosted authoring surface

The first-party web UI for SpecScore: browse spec graphs from any GitHub repo, view documents and dependencies, and (soon) author specs collaboratively.

Used by

Projects and tools built on SpecScore:

  • specscore-cli — reference CLI: lint, query, and scaffold SpecScore specifications
  • rehearse — Markdown-native test framework that turns SpecScore specs into executable scenarios
  • spec-driven-todo-app — demo todo app specified end-to-end with SpecScore
  • inGitDB — open-source Git-backed versioned database, specified with SpecScore
  • dal-go/dalgo — (planned) Go data access layer, SpecScore specification in progress

Using SpecScore in your project? Open a PR.

Quick links
📐 Format specscore.md · feature spec · plan spec
🛠 Tools CLI · SpecStudio Skill · Rehearse
🎼 Hosted specscore.studio
📦 Install curl -fsSL https://specscore.md/install/get-cli | sh

Popular repositories Loading

  1. specscore specscore Public

    Open standard for AI-readable software specifications — Markdown+YAML features, requirements, acceptance criteria, plans and tasks, validated by CI lint

    Astro 4

  2. rehearse rehearse Public

    Markdown-native test framework that turns specifications into executable scenarios. Write human-readable steps, compose acceptance criteria, run with rehearse run. No DSL, no glue code — your specs…

    Go 1

  3. specscore-cli specscore-cli Public

    SpecScore CLI — lint, query, and scaffold SpecScore specifications.

    Go 1

  4. specstudio-skills specstudio-skills Public

    Claude Code plugin: skills, commands, and tooling for SpecScore-driven specification authoring (specstudio:ideate, specstudio:specify, …)

  5. ai-plugin-specscore ai-plugin-specscore Public

    SpecScore CLI plugin for Claude Code — skills wrapping the specscore CLI. Ships via synchestra-io/ai-marketplace.

  6. spec-driven-todo-app spec-driven-todo-app Public

    A demo specifications driven ToDo app that uses SpecScore.md

Repositories

Showing 10 of 15 repositories
View all repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…