Skip to content
@open-spek

Open Specification Knowledge

A Spek captures the complete knowledge needed to create software.

Open-Spek

Open Specification Knowledge

Source is no longer code. Source is knowledge.

Open-Spek is an open standard for sharing the complete knowledge required to create software.


Software is no longer written first. It is described first.

Knowledge
    ↓
  Spek
    ↓
    AI
    ↓
   Code
    ↓
Software

What is a Spek?

A Spek captures the complete knowledge required to create software.

A Spek may include:

  • Vision
  • Requirements
  • Domain Knowledge
  • Architecture
  • Design Decisions (ADRs)
  • Data Models
  • Algorithms
  • Constraints
  • API Contracts
  • Examples
  • Acceptance Criteria
  • Evaluation Rules
  • Prompts

Code is only one possible implementation of a Spek.

Why Open-Spek?

Open Source made implementations open.

Open-Spek makes knowledge open.

As AI becomes the primary software producer, sharing knowledge becomes more valuable than sharing a single implementation.

Principles

  • Knowledge is the source.
  • Spek is the source artifact.
  • Code is generated.
  • Software can have many implementations.
  • A Spek should outlive its implementations.

Vision

Open Source transformed how software is shared.

Open-Spek aims to transform how software is created.

Manifesto

  • Knowledge is the source.
  • Spek is the source artifact.
  • Software is described before it is implemented.
  • A single Spek can produce many implementations.
  • Implementations evolve.
  • Speks endure.
  • Knowledge should remain open.

Popular repositories Loading

  1. loop loop Public

    Reference method of the Open-Spek standard: a test-gated autonomous agent loop that turns a Spek into verified code.

    Shell 2

  2. maintainer-loop maintainer-loop Public

    Autonomous, test-gated maintenance for existing repos: fresh-context agent loop over a public issue tracker - untrusted-input firewall, moderation protocol, adversarial review, functional smoke. Si…

    Shell 2

  3. spek spek Public

    The Open-Spek standard: what a Spek is, and what makes one complete. v0.1 draft.

    1

  4. jsonq jsonq Public

    The query engine where an invalid query does not compile. Every line generated from a frozen Spek by an autonomous agent loop.

    TypeScript 1

  5. .github .github Public

  6. open-spek.github.io open-spek.github.io Public

    The Open-Spek organization site: source is no longer code, source is knowledge.

    HTML

Repositories

Showing 6 of 6 repositories

Top languages

Loading…

Most used topics

Loading…