By shuu5
folio Layer 0 META FRAMEWORK — universal architecture spec-writing rules + Claude Code plugin harness. minimal scope = ADR-0003/0007: 1 skill + 6 hook + 7 script + 1 CLI.
生成された単一 SRS プレゼン HTML が機械 SSoT (contract YAML) の求める構成要素・意味内容を **意味的に満たしているか** — 存在するが空 / 存在するが的外れ / 意味カバレッジ欠落が無いか — を contract と anchor manifest を突合して検査する ceiling subagent (SRS taxonomy §5.3 ceiling を §5.2.6 集合完全性の軸へ拡張する第 3 lens 候補・有効化には ceiling 翼数の 2→3 amendment が前提)。floor gate A/G (部品・slot の *存在* を数える) が通っても中身が意味的に空・的外れな箇所、 goals↔requirements の意味カバレッジ欠落、 nfr/constraint/actor に該当章が実質空、 acceptance の跨り漏れ、 RTM 要約が拾うべき upper_need の脱落を read-only で検査し構造化 findings を返す。捏造/歪み (fidelity-srs = gate J)・読みやすさ (persona-walk-srs = gate I)・構造存在の数え (floor verify-srs)・cross-doc graph 完全性 には使わない (それぞれの領分)。
生成された ADR (設計判断記録) プレゼン HTML が機械 SSoT (ADR contract YAML) の **正確な要約**か — 情報落ち / 歪み / **捏造** が無いか — を contract と突合して検査する ceiling subagent (ADR-pack ceiling・SRS taxonomy §5.3 gate J と同型)。opus 生成 prose スロット (cover-summary / chapter-lead / plain-OPTx / decision-plain / decision-rationale) の捏造、 ADR の hallmark (採用案を持ち上げ却下案を歪める = 比較の不公平・rationale の因果作文) の毀損、 派生ビュー (plain-language-term-inline) の SSoT 一致、 cross-doc 照会 (前方 = decision.justifies → SRS 要件 / 後方 = research approaches からの leads_to の受け手) の意味的妥当性を read-only で検査し構造化 findings を返す。要件定義書の fidelity-srs・調査記録の fidelity-research・folio 自身の dual-audience spec 検査 (spec-review-fidelity)・読書体験 (persona-walk-adr)・構造存在/集合一致の floor 検査には使わない。
生成された architecture (アーキテクチャ記述・「何がどう組み合わさって動くか」= 記述型) プレゼン HTML が機械 SSoT (architecture contract YAML) の **正確な要約**か — 情報落ち / 歪み / **捏造** が無いか — を contract と突合して検査する ceiling subagent (arch-pack ceiling・SRS taxonomy §5.3 gate J と同型)。opus 生成 prose スロット (cover-summary / chapter-lead-01..08 / plain-AD-x / rationale-AD-x) の捏造、 arch の hallmark (arc42 章立て + C4 図 + runtime flows + AD カードで構造の WHAT を *記述する* = 決めない〔採否の比較検討は照会先 ADR に委ねる・案A〕・探索しない) の毀損、 **band 見出しの件数 fidelity (可視 exotic 表記面まで)** (band h2「N つの部品」== |components| を機械 floor は honest best-effort で守るが、 可視 exotic 表記〔丸数字/数学用数字/homoglyph/々〇中点/結合文字〕は自由文の意味 fidelity ゆえ機械列挙不能 = 全面 ceiling 領分・folio-bhe 申送り・machine/LLM 境界)、 図 caption と派生ビュー (plain-language-term-inline) の SSoT 一致、 cross-doc 照会 (decisions→SRS 要件〔claim・充足照会〕/ decisions→ADR 判断〔rationale・根拠照会〕/ principle 終端 / quality→SRS) の意味的妥当性を read-only で検査し構造化 findings を返す。要件定義書の fidelity-srs・設計判断記録の fidelity-adr・調査記録の fidelity-research・不変原則の fidelity-principle・「なぜ作るか」の fidelity-vision・folio 自身の dual-audience spec 検査 (spec-review-fidelity)・読書体験 (persona-walk-architecture)・構造存在/集合一致/round-trip の floor 検査には使わない。
生成された changelog (変更履歴 = 版ごとに何を追加/変更/修正したかを version-keyed で記録する・indexed 型) プレゼン HTML が機械 SSoT (changelog contract YAML) の **正確な要約**か — 情報落ち / 歪み / **捏造** が無いか — を contract と突合して検査する ceiling subagent (changelog-pack ceiling・SRS taxonomy §5.3 gate J と同型)。opus 生成の自由文スロットは 3 種 (cover-summary ×1 + chapter-lead-01..04 + latest-highlight ×1 + 各変更項目の plain-Cx = data-prose-slot="cover-summary"/"chapter-lead"/"highlight"/"plain") で、 floor (verify-changelog.sh) はそれらの *非空* しか見ず内容真正性は全て ceiling へ委譲される (CEILING=PENDING)。 各スロットが要約する contract フィールドを歪めず捏造しない平易化か (cover-summary ↔ 種別/収録版数/照会先の要旨・chapter-lead-NN ↔ 各章の主旨・latest-highlight ↔ 最新版で実際に変わったこと・plain-Cx ↔ 該当変更項目の text)、 章リード/ハイライトの述べる件数 (可視 exotic 数字偽装含む) が版数や categories 件数と一致するか (floor は prose の件数を parse しない = critical 級)、 changelog の hallmark (version-keyed の *事実記録* ゆえ変更内容の脚色・誇張・因果の作文・区分〔追加/変更/非推奨/削除/修正/セキュリティ〕の取り違え・版順の意味的乱れをしないこと) の毀損、 cross-doc 後方照会 (各変更の refs.srs=どの要件 FR / refs.adr=なぜ ADR の *意味的* 妥当性) を read-only で検査し構造化 findings を返す。件数・id 一意・semver 順序・照会集合一致 (捏造0+脱落0)・参照先 SRS/ADR への FR/doc_id 実在・href 遷移先・全 class/data-component の占有数・cover-meta の値・prose スロット充填 (非空) は fabrication-free floor が既に担保ゆえ数えない — 意味面のみ。要件定義書の fidelity-srs・設計判断記録の fidelity-adr・テストケースの fidelity-testcases・調査記録の fidelity-research・folio 自身の dual-audience spec 検査 (spec-review-fidelity)・読書体験 (persona-walk-changelog)・構造存在/集合一致/semver 順序/ID 実在の floor 検査には使わない。
生成された data-model (データモデル・「何を持つか・どうつながるか」= entity catalog + ER 図の hybrid 型) プレゼン HTML が機械 SSoT (data-model contract YAML) の **正確な要約**か — 情報落ち / 歪み / **捏造** が無いか — を contract と突合して検査する ceiling subagent (datamodel-pack ceiling・SRS taxonomy §5.3 gate J と同型)。opus 生成 prose スロット (cover-summary / chapter-lead-01..06 / plain-<entity-id>×6) の捏造、 datamodel の hallmark (「何を持つか・どうつながるか」*だけ* を決める = 画面・処理の流れは arch へ・要件は SRS へ委譲) の毀損、 **inline principle (PRIN-DATA-MINIMUM) の genuine 性** (grill 裁定で fidelity ceiling へ明示的に課された B3 graph-filler 弁別)、 **band 見出し + prose の件数 fidelity (可視 exotic 表記面まで)** (「6 つ」「5 つ」「最大 1 件」— 機械 floor は不可視クラスのみ閉塞・machine/LLM 境界)、 **ER 図 (mermaid erDiagram) ↔ entities/relationships カタログの構造対応** (D1 lines は contract 内の手書きリテラルで floor は DSL echo しか守れない = 図とカタログの意味対応は ceiling 領分)、 派生ビュー (plain-language-term-inline) の SSoT 一致と entity↔glossary 近接概念 (識別子/参照/区分 等) の取り違え、 cross-doc 照会 (entities/relationships/data_policy → SRS 要件・claim) の意味的妥当性を read-only で検査し構造化 findings を返す。要件定義書の fidelity-srs・設計判断記録の fidelity-adr・調査記録の fidelity-research・不変原則の fidelity-principle・「なぜ作るか」の fidelity-vision・アーキテクチャ記述の fidelity-architecture・インターフェース仕様の fidelity-interface・folio 自身の dual-audience spec 検査 (spec-review-fidelity)・読書体験 (persona-walk-datamodel)・構造存在/集合一致/per-row 束縛の floor 検査には使わない。
folio spec edit の唯一の正規 author entry point (7-Phase PR Cycle orchestrator)。design-intent/spec/ 配下の spec HTML を編集する際に user が明示起動する。Phase A で adoption-state を検出し greenfield (onboarding grilling → constitution/overview を lazy materialize) / maintenance に分岐、Phase C で refs/grilling-protocol.md に沿い gap-driven に grill、Phase E で caller marker を set→編集→folio validate→unset、Phase F で 5 review agent (folio:spec-review-ears/vocabulary/ssot/temporal/fidelity) を並列 spawn して品質検証する。folio-self-spec.html §7.1 準拠。
既存 spec ページを人間層プレゼン圧縮 (ADR-0040) へ batch migration する道具。readability-floor warn (人間層可視 prose 上限/章要旨不在/図ゼロ×長文) が出ているページに対し、章要旨案・audience 仕分け案・mermaid 章図案を章単位で一括起草して適用し、user の Pages walk で検収する。圧縮基準の SSoT は rules §11.5 (本 SKILL は複製しない)。新規/改訂編集の恒久規律は folio-architect の presentation pass が担い、本 SKILL は既存 corpus の一括変換専用。user が明示起動する。
生成された SRS プレゼン pack (generated.html + contract.yaml) の ceiling 検証を回す唯一の正規 entry point。folio-architect Phase F と同型の main-session orchestrator (skill→subagent 一段=nesting 制約下で唯一配布可能な形) で、floor(verify-srs)→precheck→anchors→3 lens 並列 spawn (fidelity-srs ∥ persona-walk-srs ∥ completeness-critic-srs)→dedup→Pass2 finding-refuter→severity remap→LLM verdict 合成→ceiling-commit-check (機械の default-block gate)→3 バンド verdict card + 5-state (STALE / FLOOR-FAIL / CEILING-FAIL / READY / GREEN) を出し、--accept で人間が fail-closed に toppling する。findings は synth 鵜呑みせず各 lens 返り値を raw 一次監査する。user が明示的に起動する (disable-model-invocation)。
Modifies files
Hook triggers on file write and edit operations
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
This plugin requires configuration values that are prompted when the plugin is enabled. Sensitive values are stored in your system keychain.
spec_pathRelative path (from consumer project root) where folio-managed spec HTML files live. canonical default = design-intent/spec/ (folio self-host、 X4-C で scratch/ から物理移植済、 ADR-0023)。
${user_config.spec_path}review_modelLLM model for Phase F specialist review agents. Overridable per consumer project.
${user_config.review_model}caller_marker_envEnvironment variable name that AI agent must set before editing files under spec_path.
${user_config.caller_marker_env}caller_marker_valueExpected value of the caller marker env var. Hook denies edit if env var is unset or differs.
${user_config.caller_marker_value}A clean-slate, AI-Agent-first architecture spec-writing framework + Claude Code plugin harness (META FRAMEWORK, Layer 0). HTML-only, future-anchor philosophy.
Status: Phase X5-γ (選択的完成)。 現行 v1.2.0、 v1.0 昇格基準は ADR-0030 (accepted) で定義。 試作層 (scratch/) は X4-C (ADR-0023) で canonical layout へ物理移植済 (HOW-test dir は X4-F/ADR-0026 で verification/ → tests/ に、 design-intent 空間 dir は X4-G/ADR-0048 で architecture/ → design-intent/ に rename、 概念「verification」「architecture」は dir 名と独立に存続)。 folio は自身の rules を self-host する。
Ecosystem — folio は Claude Code plugin エコシステム(cc-session / scribe / scriptorium / folio)で 別軸の独立系統に立つ(他 plugin 無依存・自前 hook + architecture-doc 生成で自己完結)。命名二層での役割は architect。
cc-session → scribe → scriptoriumの単方向スタックとは別レイヤに位置する。4 plugin の層・役割・依存の俯瞰は sibling scriptorium repo のdocs/ecosystem-overview.md(命名二層表 + 依存図)に集約。
Prerequisites: bash + jq + yq (mikefarah v4.x) + GNU realpath (Linux 標準)。 Supported: Linux canonical (sandbox + CI 共に ubuntu-latest で検証)。 macOS / Windows は post-1.0 で fix 予定の best-effort 状態。
Claude Code 内で:
/plugin marketplace add shuu5/folio
/plugin install folio@folio
reload 後、~/.claude/plugins/folio/ に install され、 /folio-architect SKILL と canonical CLI path (~/.claude/plugins/folio/.claude-plugin/bin/folio) が available になります。
First run — greenfield consumer project:
mkdir my-project && cd my-project
# Claude Code を起動して:
/folio-architect この project に folio を導入し、 最初の design-intent spec を整備せよ
adoption-aware Phase A が greenfield 検出 → folio init で構造生成 → onboarding grill (1 問ずつ + 推奨回答) で実体を引き出し → Phase E で非 hollow な constitution / overview を materialize → Phase F で 4-agent quality review (ADR-0031 protocol-only authoring 吸収)。
Layer 0 — folio (this repo) : rules + plugin harness 一体配布
↓ provides rules + harness (via folio.config.yaml)
Layer 1 — <consumer-project>/ : design-intent/ spec + implementation in same repo
| file / dir | role |
|---|---|
design-intent/spec/constitution.html | folio の 14 不変原則 (編集禁止) |
design-intent/ | design-intent 空間 (spec / decisions / research / assets、 self-host) |
tests/ | sandbox verification framework (scenarios / fixtures / golden / runner.sh、 X4-F で verification/ から rename) |
CLAUDE.md | Claude Code project instructions |
.claude-plugin/ + hooks/ | plugin harness (manifest + CLI + hook 宣言 / script) |
Published spec site (canonical): https://shuu5.github.io/folio/ — GitHub Pages, always available.
Local preview (offline / pre-publish): serve the repo root, then open /design-intent/:
# repo root から (specs の ../../common.css 等を解決するため root 配信が必須)
python3 -m http.server 8000 --bind 127.0.0.1 # localhost のみ
# tailnet 経由で見る場合は tailscale IP を bind:
# python3 -m http.server 8000 --bind "$(tailscale ip -4)"
Not the twill plugin (~/projects/local-projects/twill/、 frozen historical artifact). folio is a clean-slate framework.
MIT © 2026 shuu5. OSS — 誰でも自由に利用・改変・再配布できます。
npx claudepluginhub shuu5/folio --plugin folio汎用 Claude Code セッション管理プラグイン(spawn/fork/ready-compaction/enforce)
per-project・Claude Code ネイティブの実装 administrator(ユーザー代理 AI)プラグイン。substrate(cc-session/beads/doobidoo)を compose し、spawn/監視/gate/role 別文脈注入を担う orchestration 層。v0 = 堀なし軽量モード(成文化 + 道具 + 3 role SessionStart 注入)。
Ultra-compressed communication mode. Cuts 65% of output tokens (measured) while keeping full technical accuracy by speaking like a caveman.
Multi-model consensus engine integrating OpenAI Codex CLI, Gemini CLI, and Claude CLI for collaborative code review and problem-solving.
Memory compression system for Claude Code - persist context across sessions
Comprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Unified capability management center for Skills, Agents, and Commands.
45% cost reduction measured. Cache expiry prevention, SubTask auto-delegation, zero-cost context restoration, real-time cost dashboard. The only Claude Code plugin built from CC source analysis.