Skip to content

Commit 5eaba4b

Browse files
tbitcsoz-agent
andcommitted
chore: normalize doc filenames + update spec references
- Rename docs/architecture.md → docs/ARCHITECTURE.md (match scaffolder convention) - Rename docs/governance/epistemic-axioms.md → EPISTEMIC-AXIOMS.md - Update AGENT-WORKFLOW-SPEC.md: WORKFLOW.md → SESSION-PROTOCOL.md + LIFECYCLE.md - Fix AGENTS.md reference to EPISTEMIC-AXIOMS.md Co-Authored-By: Oz <oz-agent@warp.dev>
1 parent 0754628 commit 5eaba4b

4 files changed

Lines changed: 8 additions & 4 deletions

File tree

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ and local Ollama models.
4646
## Governance
4747
This project follows its own specification. See:
4848
- [Agent Workflow Specification](docs/AGENT-WORKFLOW-SPEC.md) — the full spec (H1–H13, session lifecycle, proposal format, ledger format)
49-
- [Epistemic Axioms](docs/governance/epistemic-axioms.md) — AEE axioms applied to specsmith
49+
- [Epistemic Axioms](docs/governance/EPISTEMIC-AXIOMS.md) — AEE axioms applied to specsmith
5050

5151
Note: modular governance files are not generated for specsmith's own repo since
5252
AGENTS.md is < 200 lines. Run `specsmith upgrade --full` to generate them if needed.

docs/AGENT-WORKFLOW-SPEC.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -84,9 +84,13 @@ Project overview, architecture summary, component descriptions, repository struc
8484

8585
System architecture: components, boundaries, interfaces, runtime modes, platform expectations, constraints, and design principles.
8686

87-
### 2.5 docs/WORKFLOW.md
87+
### 2.5 docs/governance/SESSION-PROTOCOL.md
8888

89-
Development workflow: the work loop, proposal rules, PR expectations, cross-platform rules, documentation rules, verification rules, and milestones.
89+
Session lifecycle: session types (start, resume, save, commit, sync), proposal format, ledger entry format.
90+
91+
### 2.5.1 docs/governance/LIFECYCLE.md
92+
93+
Project lifecycle: the 7 AEE phases (inception → release), readiness gates, phase artifacts.
9094

9195
### 2.6 docs/services.md (if applicable)
9296

@@ -112,7 +116,7 @@ When documents conflict, precedence is resolved top-down:
112116
4. **docs/ARCHITECTURE.md** — how the system is structured
113117
5. **docs/TEST_SPEC.md** — how the system is verified
114118
6. **LEDGER.md** — what has been done and what remains (sole authority for session state)
115-
7. **docs/WORKFLOW.md** — how work proceeds
119+
7. **docs/governance/SESSION-PROTOCOL.md** — how sessions work
116120
8. **docs/services.md** — platform-specific startup/service behavior
117121

118122
If a requirement contradicts the architecture, the requirement wins. If AGENTS.md contradicts a requirement, AGENTS.md wins.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)