ADR-0002 — folio repo を scratch 中心の試作層に整理

§1. Context

PR #1 (ADR-0001 v3) で architecture-rules.html を rules.html + folio-self-spec.html に split し、 decisions/ dir + ADR-0001 を root 直下に新設した。 v0.4.2-draft 状態。

ユーザーは v0.4.2-draft の状態を check し、以下を指摘:

FOLIO.md の存在意義が曖昧: README.md / CLAUDE.md と identity 情報が重複。
ルート直下のばらつき: project meta / 規範文書 / 一時的自己説明 / styling / Layer 1 規範構造名 (architecture/) / ADR cluster / plugin harness が同階層に混在。
architecture/ の二重意味: rules.html §2 で「Layer 1 consumer の規範構造名」と規定しつつ、 folio 自身は architecture/assets/mermaid.min.js (vendor 置き場) として利用。
永続性レベルの混在: 永続 (constitution / rules) と一時的 (folio-self-spec) が同 location。

議論の末、 folio framework は「自身を縛る rule で自身を書く」 self-application paradox を抱えており、試作段階では folio rule に従わない 工事用の一時的な箱 (scratch) で作業し、完成後に正式 location (architecture/) に移植する方針を採用。

§2. Decision

§2.1 Scratch 中心の試作層を採用

folio repo の整理:

root 直下の constitution.html、 rules.html、 folio-self-spec.html を scratch/ 配下に移動。
root の decisions/ dir を scratch/decisions/ に移動。
root の architecture/assets/mermaid.min.js を scratch/assets/mermaid.min.js に移動。
architecture/ dir を 完全削除。 Phase X3 で plugin 完成後に user 主導で作成予定。
FOLIO.md を削除 (identity marker 役は CLAUDE.md に統合)。
scratch/README.html を新設 (scratch dir の目的・構成・運用説明)。

§2.2 CLAUDE.md を簡素化

必読 file を scratch/constitution.html のみに削減。
caller marker bash export 説明を削除 (architecture/ に触らないため不要)。
5 層防御 table を削除 (Identity 1 行で代替)。
plugin 構造説明を削除 (試作段階で固定不要)。
編集禁止 list を明示。
Directory Layout section を追加 (5 行以内、 dir 名と注意のみ)。

§2.3 .claude-plugin/{skills,agents,scripts,static}/README.md を minimal placeholder 化

試作段階では plugin sub-README は詳細記述不要。各 file を 1-2 行の placeholder に置換 (「Placeholder。試作 plugin は scratch/ で開発中」)。

§2.4 README.md を簡素化

Entry points を scratch/ 中心に書き換え、 status を「試作段階 (Phase X2)」に更新、 tailnet URL を scratch/ 配下に。

§2.5 SemVer bump

PATCH bump (v0.4.2-draft 維持)。 constitution 不変原則 + rules.html / folio-self-spec.html の semantic 不変 (移動 + cross-ref 更新のみ)。 P-10 user 承認: 本 dialog (2026-05-22 evening) で取得済。

§3. Consequences

Positive

ルート直下が clean (3 file + 3 dir のみ: README.md / CLAUDE.md / common.css + scratch/ / .claude-plugin/ / .gitignore)、ばらつき解消。
architecture/ という名前を Layer 1 consumer の正規構造名として予約、二重意味解消。
永続性レベルの分離 (永続 = root + .claude-plugin/、一時的 = scratch/)。
self-application paradox の現実的回避: 試作中は folio rule に縛られず作業。
CLAUDE.md 簡素化 (101 行 → 50 行程度)、 Claude が誤動作する risk 低減。

Negative

cross-ref 一括更新コスト (移動した HTML の stylesheet + mermaid + 内部 link 等)。
Phase X3 で scratch → architecture/ への再 refactor が必要 (将来 cost)。
scratch/ 配下の HTML は folio rule に従わない混在状態に。

Neutral

FOLIO.md 削除で 5 層防御の L2 (root marker) は CLAUDE.md が兼ねる (folio-self-spec.html §7.4 の table は試作段階では参照不要として保留)。
ADR-0001 v3 §2.1 の section 帰属表は scratch/ 配下の状態を反映していないが、内容 semantic は不変 (rules.html / folio-self-spec.html という file 名は維持)。

§4. Alternatives Considered

案	採用しなかった理由
案 A: `core/` dir に Layer 0 を隔離	folio 自身が folio rule に従わない (Layer 1 は architecture/、 folio は core/)、 self-application 移行が将来必要。
案 B: 最初から self-application (architecture/spec/ に folio 自身を入れる)	bootstrap paradox。試作段階で「未完成の framework で自身を縛る」のは現実的でない。 user 指摘で却下。
案 C: 現状維持 + 命名で区別	ばらつき未解消、 user 指摘に応えない。
案 D: scratch を別 repo として分離	cross-ref が複雑化、開発 workflow 悪化。