architecture — index

folio は、人間と AI agent が同じ architecture spec を読み書きするための spec-writing framework です。仕様は HTML + JSON-LD で記述され、機械検証 (folio validate) と人間可読性 (P-14) の両方を恒久ゲートで保ちます。

まずここから — 導入手順 (repo README)

Key documents

constitutionfolio の 14 不変原則。すべての設計判断の最上位根拠 (編集禁止)
rulesspec の書き方の規範 — markup・命名・EARS 要件・検証の universal rules
folio-self-specfolio 自身の architecture spec (framework の self-host 実例)
verification仕様がどう機械検証されるか — validate / sandbox framework の contract
glossaryfolio 用語集 — 本文の用語 hover 解説と同じ定義から生成

spec — design intent (WHAT)

stable (1)

folio self-spec self-spec

active (4)

folio framework spec index cluster-readme
folio relations spec spec
folio rules rules
folio verification spec spec

decisions — ADR (WHY)

active (1)

folio decisions index cluster-readme

accepted (33)

research — exploration

active (3)

folio research index cluster-readme
文書規律エンジン (C) B0 設計 design-of-record research
SRS 部品 taxonomy — 要件定義書ビジュアル design system の接地 (epic c5g / S2) research

draft (2)

folio plugin sandbox verification research research
folio presentation design patterns research research

superseded (3)

folio constitution X4 amendment proposal planning
spec/README 作業ログ archive research
folio Phase X4 分解 + 着手計画 planning