@@ -7,10 +7,10 @@ This guide explains the core ideas behind OpenSpec and how they fit together. Fo
77OpenSpec is built around four principles:
88
99```
10- fluid not rigid — no phase gates, work on what makes sense
10+ fluid not rigid — no phase gates, work on what makes sense
1111iterative not waterfall — learn as you build, refine as you go
12- easy not complex — lightweight setup, minimal ceremony
13- brownfield-first — works with existing codebases, not just greenfield
12+ easy not complex — lightweight setup, minimal ceremony
13+ brownfield-first — works with existing codebases, not just greenfield
1414```
1515
1616### Why These Principles Matter
@@ -28,19 +28,19 @@ brownfield-first — works with existing codebases, not just greenfield
2828OpenSpec organizes your work into two main areas:
2929
3030```
31- ┌─────────────────────────────────────────────────────────────────┐
32- │ openspec/ │
33- │ │
34- │ ┌─────────────────────┐ ┌──────────────────────────────┐ │
35- │ │ specs/ │ │ changes/ │ │
36- │ │ │ │ │ │
37- │ │ Source of truth │◄─────│ Proposed modifications │ │
38- │ │ How your system │ merge│ Each change = one folder │ │
39- │ │ currently works │ │ Contains artifacts + deltas │ │
40- │ │ │ │ │ │
41- │ └─────────────────────┘ └──────────────────────────────┘ │
42- │ │
43- └─────────────────────────────────────────────────────────────────┘
31+ ┌──────────────────────────────────────────────────────────────────── ┐
32+ │ openspec/ │
33+ │ │
34+ │ ┌─────────────────────┐ ┌───────────────────────────────┐ │
35+ │ │ specs/ │ │ changes/ │ │
36+ │ │ │ │ │ │
37+ │ │ Source of truth │◄─────│ Proposed modifications │ │
38+ │ │ How your system │ merge│ Each change = one folder │ │
39+ │ │ currently works │ │ Contains artifacts + deltas │ │
40+ │ │ │ │ │ │
41+ │ └─────────────────────┘ └───────────────────────────────┘ │
42+ │ │
43+ └──────────────────────────────────────────────────────────────────── ┘
4444```
4545
4646** Specs** are the source of truth — they describe how your system currently behaves.
@@ -558,11 +558,11 @@ openspec/
558558## How It All Fits Together
559559
560560```
561- ┌─────────────────────────────────────────────────────────────────────────────┐
561+ ┌────────────────────────────────────────────────────────────────────────────── ┐
562562│ OPENSPEC FLOW │
563563│ │
564564│ ┌────────────────┐ │
565- │ │ 1. START │ /opsx:propose (core) or /opsx:new (expanded) │
565+ │ │ 1. START │ /opsx:propose (core) or /opsx:new (expanded) │
566566│ │ CHANGE │ │
567567│ └───────┬────────┘ │
568568│ │ │
@@ -587,13 +587,13 @@ openspec/
587587│ └───────┬────────┘ │
588588│ │ │
589589│ ▼ │
590- │ ┌────────────────┐ ┌──────────────────────────────────────────────┐ │
591- │ │ 5. ARCHIVE │────►│ Delta specs merge into main specs │ │
592- │ │ CHANGE │ │ Change folder moves to archive/ │ │
593- │ └────────────────┘ │ Specs are now the updated source of truth │ │
594- │ └──────────────────────────────────────────────┘ │
590+ │ ┌────────────────┐ ┌──────────────────────────────────────────────┐ │
591+ │ │ 5. ARCHIVE │────►│ Delta specs merge into main specs │ │
592+ │ │ CHANGE │ │ Change folder moves to archive/ │ │
593+ │ └────────────────┘ │ Specs are now the updated source of truth │ │
594+ │ └──────────────────────────────────────────────┘ │
595595│ │
596- └─────────────────────────────────────────────────────────────────────────────┘
596+ └────────────────────────────────────────────────────────────────────────────── ┘
597597```
598598
599599** The virtuous cycle:**
0 commit comments