Skip to content

v3.2.0 Specification Architecture

Choose a tag to compare

@gmelli gmelli released this 05 Jan 00:08
· 615 commits to main since this release

v3.2.0 "Specification Architecture"

Theme: Comprehensive specification and validator expansion

Highlights

  • 7 New Specifications: Testing, Release, Documentation, Organization, Error, Security, Project Plan
  • Naming Convention Expansion: 4 → 10 categories (Categories F-J)
  • Specification Index System: INDEX.md (30 specs) + REQUIREMENTS_MATRIX.md (78 CAP requirements)
  • 6 New Validators: License, Agent Structure, Release Gate, L-doc Index, SOP, Homepage Messaging

New Specifications

Spec CAP Requirements
AGET_TESTING_SPEC.md CAP-TEST-001 to CAP-TEST-009
AGET_RELEASE_SPEC.md CAP-REL-001 to CAP-REL-006
AGET_DOCUMENTATION_SPEC.md CAP-DOC-001 to CAP-DOC-007
AGET_ORGANIZATION_SPEC.md CAP-ORG-001 to CAP-ORG-003
AGET_ERROR_SPEC.md CAP-ERR-001 to CAP-ERR-005
AGET_SECURITY_SPEC.md CAP-SEC-001 to CAP-SEC-004
AGET_PROJECT_PLAN_SPEC.md CAP-PP-001 to CAP-PP-011

Naming Convention Categories

Category Pattern Example
F Standard Open-Source README.md, LICENSE
G Requirement Documents R-REL-001.md
H Change Proposals CP-001_feature.md
I Protocol Documents SESSION_PROTOCOL.md
J Checklists RELEASE_CHECKLIST.md

Learnings Captured

  • L439: Standard Open-Source Files as Category F
  • L440: "A checkbox is not a verification. A passing test is."
  • L443: Theater Ratio Paradox (new specs increase denominator)

Validators

30 implemented validators (theater ratio 33%, target <10% for v3.3.0)

See CHANGELOG.md for complete details.