Wiki / entities / wiki

OpenSpec

A command-line tool plus a set of agent skills for spec-driven-development. It installs with Homebrew, puts its skills into the coding harness's directory and supports a couple dozen harnesses.

The workflow, as tim-berglund describes it:

  • explore an unclear change with the agent, or propose one directly
  • a change holds a proposal, a design document, a task list and specs in "when ... then ... shall" language, all Markdown
  • apply writes the code and runs what verification the agent can; a newer verify command brings in a different model
  • archive closes the change, keeps its documents in the OpenSpec directory, and merges its specs into a master spec

Project conventions the agent learns, such as trunk-based development, go into its config.yaml. michael-carducci uses it on a production SaaS and says it remembers the project better than a CLAUDE.md file.

Source: report

Linked from

Michael CarducciProgramming as theory buildingSpec-driven developmentTim Berglund