Skip to content

Instantly share code, notes, and snippets.

@thomashartm

thomashartm/openspec-101.md

Created October 31, 2025 08:58
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save thomashartm/3ac8af0d39cc8651f7105d6dd308205e to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save thomashartm/3ac8af0d39cc8651f7105d6dd308205e to your computer and use it in GitHub Desktop.
Download ZIP
Spec driven development 101 with openspec
Raw
openspec-101.md

Openspec 101

Init your project

cd <project-directory>
openspec init

The instruct your agent to create an AGENTS.md inside your openspec directory. Please check https://agents.md

Working with your project

Create a feature

/openspec-proposal <Create your project proposal>

This will result in you first feature proposal e.g. 001-add-serverless-handler

Validate the proposal

Now check if it has been created correctly and validate it afterwards

openspec list

openspec validate 001-add-serverless-handler --strict

Review the proposal details

openspec show 001-add-sqs-lambda-handler

Implementation

Show diff between task plan and status quo

openspec show <task> --json --deltas-only
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment