メインコンテンツへスキップ

ロードマップ

XTL 1.0(仕様)および xl3 1.0(リファレンス実装)に到達するために何が必要かをまとめます。

0.x の期間中は依然として破壊的変更が発生し得ます。ADR-0079 により、1.0 は技術的安定性と 90 日のソークをゲートとします。G13・G14・G15・G18 は公開された 1.x 採用トラックとして継続しますが、1.0 をブロックしません。

詳細なバージョン計画docs/internal/blueprint-to-1.0.md にまとめてあります — ギャップ分析、設計思想の境界(xl3 ≠ JXLS)、バージョンごとのステップ計画です。本書はエレベーターピッチであり、ブループリントは根拠そのものです。

1.0 ゲートの唯一の正典は下記のテーブルです。 本書とブループリントが矛盾する場合はこのテーブルが優先され、ブループリントの方をそれに合わせて更新します。

xl3 における 1.0 の意味

1.0 の目標は オペレーターにとって信頼できる読みやすさ です。すなわち、ぐらつかない仕様、サプライズのないリファレンス実装、そしてコードを読まなくてもオペレーターがテンプレートをレビューできる程度に小さい表面積です。これは JXLS との機能比較における網羅性の話では ありません — xl3 は意図的に小さな表面でリリースしています(ADR-0043 + ADR-0048)。想定する利用層は 多数の顧客固有の請求書フォーマット(거래명세서、정산서、발주서)を扱う韓国のオペレーションチーム です。エンジンはこのニッチを越えて一般化できますが、ニッチがくさびとなります。

1.0 技術ゲートと 1.x 採用トラック

各ゲートにはオーナー、ゲートをクローズさせる成果物、合否基準、ゲートが到達不能となった場合のフォールバック、そしてターゲットマイルストーンが定められています。下の各バージョンごとのステップ計画はゲートを ID で参照します。

IDゲートオーナー成果物合格基準フォールバックターゲット
G1適合性コーパス ≥ 140メンテナconformance/fixtures/ls conformance/fixtures/ | wc -l ≥ 140完了(160 件; ADR-0066 が 0.7.x 途中で 141-145 を追加、ADR-0067〜0069 が 0.8.0 で 146-155 を追加、156(#49 ネイティブ値の保持)と 157(#51 グループ化時のサイドセル)を 0.8.1 以降に追加、158(#52 算術の結合性)を 0.9.0 で、159-161(ADR-0073/0074 の小計エラー)を 0.10.0 で追加。番号 098 は欠番のため、最大インデックスは 161 だが件数は 160。ADR-0051〜0065 が 0.7.1 向けにさらに番号を予約)
G2Stage 2 OOXML 正規化を仕様化メンテナADR-0006 + src/ 配下のカノニカライザフィクスチャ 024-027, 093 と ADR-0006 の改訂で網羅完了
G3エラーコードカタログの凍結メンテナimpl/js/src/__tests__/error-codes.test.ts スナップショットカタログのスナップショットが 30 日間変更なし✅ 2026-06-23 にチェック(最後のカタログ変更は 2026-05-24 a8f7ad3 の 3 コード追加 xl3/block/overlapxl3/block/empty-tablexl3/directive/orphan;89bee51 が 2026-05-23 に xl3/expression/bracket-outside-block を追加。30 日のフリーズ期間を経過 — 05-24 以降のコミットはコメント/JSDoc のみで EXPECTED_CODES は不変)
G4JXLS との境界を公開メンテナADR-0048ファイルが存在し、PORTERS_GUIDE を参照していること完了
G5先送り実装の ADR を着地メンテナADR-0038 実装 ✅(2026-05-18)+ ADR-0040 PE 実装✅ 完了 — ADR-0038 はフィクスチャ 132-135、ADR-0040 の CF/DV 範囲拡張と outline level はフィクスチャ 171・172 で実装・検証済み完了(2026-08-16)
G6公開 API サーフェスの凍結メンテナimpl/js/src/__tests__/api-surface.test.ts スナップショットスナップショットが 30 日間変更なし✅ 2026-06-17 にチェック(スナップショットは 2026-05-18 16f0608 以降変更なし)
G7@stable エクスポートに JSDoc 例メンテナTypeDoc 出力すべての @stable シンボルに @example ブロックが存在✅ 2026-06-21 完了 — @stable な callable 13/13 に @example あり(PR #59);0.11.0 で convertJson / previewJson が追加された後、15/15 で再検証(previewJson@example なしで出荷されており 2026-07-27 に修正)
G8性能の特性化メンテナscripts/BENCH.md1k/10k/100k 行 × 5/10/20 列のマトリクス + メモリ上限 + parse/eval/write の内訳を公開0.7.1
G9性能リグレッションフィクスチャメンテナ適合性コーパス比率ベースのアサーションを含む大規模フィクスチャを 2 件以上0.7.1
G10クロスブラウザのスモークメンテナci.ymlSafari + Firefox で共有マニフェストの 19 runtime export を確認し、各 1 回 convert()✅ 完了
G11CI での Stage 2 実行メンテナci.ymlすべての PR で npm run conformance:stage2 が走る0.7.1
G12未確定挙動の固定(ピボット/スパークライン/ListObject/改ページ)メンテナ適合性フィクスチャ + 項目ごとの ADR各項目について:現状挙動を固定するフィクスチャ、または明示的に 1.x に先送りする ADRADR と共に 1.1 へ先送り0.7.1 / 0.8
G131.x 採用・非ブロッキング: 第二言語実装による検証外部(xl3-py)conformance/reports/*.json現行コーパスに対して Stage 1 または Stage 2 を 80% 以上通過新しいレポート待ち
G141.x 採用・非ブロッキング: 外部コントリビューターによる ADR外部spec/decisions/NNNN-*.md著者がメンテナ以外の ADR が 1 件以上オープン
G151.x 採用・非ブロッキング: 本番リファレンス事例外部(メンテナ協力可)IMPLEMENTATIONS.md の「Production users」行公開許諾のある名指しユーザーが 1 件以上オープン
G16メンテナ集合の拡大メンテナGOVERNANCE.mdADR と実装 PR に対し承認/却下権を持つ人が 2 人以上GOVERNANCE への改訂で単一メンテナ 1.0 ガバナンスを明示的に受容0.8
G17韓国語クックブック i18n の完了メンテナwebsite/i18n/ko/.../guides/すべてのクックブックレシピに韓国語訳が存在レシピ 01-18 は完了(0.6) — 1.0 前の未決事項: docs/guides/19-jxls-to-xl3.md は後から追加され、ko / ja / zh-CN 訳がない。移行ガイドを「クックブックレシピ」に数えるかを決める必要があり、数えるなら G17 は再チェックが必要
G181.x 採用・非ブロッキング: README に本番利用ケースを掲載メンテナREADME.mdG15 後に具体的な本番事例を掲載オープン
G190.x → 1.0 移行ガイドメンテナdocs/migration-0.x-to-1.0.mdすべての挙動変更を記述、または追加のみであることを確認追加のみと確認できれば CHANGELOG の注記に格下げ0.8
G20SECURITY.md + 脅威モデルメンテナSECURITY.md + 仕様改訂ZIP 爆弾 / 超巨大ワークブック / 数式実行に対するスタンスと制限 API を文書化0.7.1
G21ハードリミットを文書化(1.1 までストリーミングなし)メンテナspec/evaluation.md行数 / メモリのハードリミット値と AbortSignal API を文書化0.7.1
G22API サーフェス — 内部モデル型を分離メンテナimpl/js/src/index.ts のエクスポート + STABILITY.mdconvert/preview/analyze + 安定インターフェイスのみが @stable 指定、モデル/パーサ型は @experimentalxl3/internal に移動完了(0.6)
G23RC ソークメンテナgit タグRC を公開し、21 日以上のソーク(レビューフィードバックを受けて 7 日から延長)、クリティカル課題ゼロ✅ 2026-06-16 にチェック(rc.1 2026-05-26 から 21 日ソーク;クリティカルゼロ — ソーク期間の修正 #49–52 は 0.9.0 に統合、G23 の破壊的変更定義によりクロックはリセットされず)
G24技術的安定性ウィンドウメンテナリリースカレンダー最後のブロッキング技術ゲートまたは最後の破壊的変更の遅い方から 90 日。採用トラックは除外破壊的変更があれば再スタート2026-08-30 → 2026-11-28OutputFile.data の公開型を実際の Uint8Array ランタイム契約に修正したため再スタート

定義(テスト可能なかたちで)

  • 外部コントリビューター(G14): PR オープン時点で GOVERNANCE.md のメンテナ集合に含まれず、かつマージ済み ADR コミットの Co-authored-by 履歴にも含まれない人物。誤字修正の「ドライブバイ」編集は対象外。ADR フロントマターに著者として記載され、Context/Decision セクションを行数比 60% 以上執筆していること。
  • 破壊的変更(G24、G23): (a) 公開 API サーフェスのスナップショット、(b) エラーコードカタログ(改名/削除/再利用)、(c) ADR の acceptedrejected への変更や矛盾するステータス反転、のいずれかへの変更。パッチリリースおよび追加のみの ADR は四半期クロックをリセットしません。
  • クリティカルバグ修正(G23 の RC 例外): (a) convert() における暗黙のデータ損失、(b) ドキュメントとランタイム間のエラーコードカタログの不整合、または (c) 文字通りには実装できない accepted ADR の MUST 条項。メンテナは PR で (a)/(b)/(c) のいずれかを引用します。
  • データ損失テスト(G24 のテスト可能形式): コーパスに専用の data-loss/ フィクスチャグループ(8 件以上)を持ち、暗黙の文字列化、numFmt の欠落、数式の書き換え、日付ラウンドトリップの経路を網羅し、すべてがリファレンス実装で合格すること。
  • 四半期クロックの起点(G24 と G23 の関係): 90 日の四半期は最後のゲートが ✅ となった日からカウント開始します。RC の公開時点ではクロックは始まりません — RC を公開する前にクロックが始まっている必要があります。RC ソーク中に破壊的変更が発生した場合、ソーク(G23)も四半期(G24)もリセットされます。

バージョン別ステップ計画

ゲートベースであり、日付ベースではありません。カレンダー見積もりは削除しました — 各マイルストーンは、列挙されたゲートがクローズした時点でクローズします。

0.6.0 — 先送り実装、狭いスコープ

テーマ: もっともインパクトの大きい先送り実装ゲートをクリーンにクローズする。

クローズしたゲート: G5(@group/@subtotal 実装のみ — ADR-0040 PE の残りは 0.6.1 へ)、G17(韓国語クックブックの未翻訳 16/17 件)、G22(@group が新たな内部型を露出する前に API サーフェスを整理)。

以前の「0.6.0 ですべてを片付ける」計画はエンジニアリング実現性レビューに照らしてスコープが過大でした。ADR-0038 の実装単体でも、新しいディレクティブ、グループ境界のステートマシン、トランスフォームパスの分割、レンダラーの書き換え、グループスコープの集計評価という、パイプライン全体への組み込みを伴います。0.6.0 を分割することでマイルストーンを出荷可能なサイズに保ちます。

0.6.1 — 残りの先送り実装(計画中、未出荷)

クローズしたゲート: G5 の完成(ADR-0040 PE の CF/DV sqref 拡張)、G12 に向けたピボット/改ページ挙動のフィクスチャ。

0.7.0 出荷時点のステータス: このマイルストーンは仕様監査バッチ(0.7.0)によってスキップされました。G5/G12 の作業は 0.7.1 に統合されます。

0.7.0 — 仕様監査バッチ(2026-05-22 出荷)

テーマ: 字句解析、セル分類、ディレクティブ合成、集計引数、予約シートのセマンティクスを深く監査して浮かび上がった 17 件の構文上の矛盾ギャップを解消する。元のゲートテーブルには予定されていなかった追加作業で、本来 0.7.0 として予定されていた perf/CI/制限まわりの作業は 0.7.1 に移動します。

出荷した成果物:

  • 新規 ADR 15 件(0051–0065)に加え、ADR-0021 改訂(group-order カタログエントリ)と ADR-0041 改訂(ヘッダーセルの複数行正規化)。
  • 新規エラーコード 4 件 — xl3/parser/unbalanced-literalxl3/lists/invalid-usexl3/eval/bad-aggregate-argxl3/expression/unknown-name
  • 文法の追加: positive_integergroup_directivesubtotal_directiveaggregate_call、字句的曖昧性解消ノート。
  • src/directive-parser.ts における先頭ゼロ整数の厳格化。
  • 二段並列レビュー(claude-general + codex);タグ付けの前に CRITICAL/HIGH の所見はすべてクローズ済み。

ゲートへの影響:

  • G1 — 現在 139 件のフィクスチャ。0.7.0 の ADR がフィクスチャ番号 141–187 を予約していますが、実装は保留中です。これらが 0.7.1 で着地した時点で G1 はクローズします。
  • G3 — 30 日のエラーコードカタログクロックは、新規 4 コードにより 2026-05-22 にリセット されました。
  • G6 — 公開 API サーフェスの変更はなく、G6 のクロックには影響しません。

0.7.1 — 性能 + 外部検証の開始(旧 0.7.0 を改名)

クローズするゲート: G5 の完成(ADR-0040 の CF/DV sqref 範囲)、G8(性能ベンチマーク)、G9(性能リグレッションフィクスチャ)、G10(クロスブラウザ)、G11(CI での Stage 2)、G20(SECURITY.md ドラフト + 脅威モデル)、G21(ハードリミット + AbortSignal ドキュメント)。

また 0.7.0 の ADR が予約していたフィクスチャ 141–187 を着地させることで、G1 ≥ 140 フィクスチャ のフロアもクローズします。

進行中: G12(未確定挙動の固定)、G13(xl3-py)。

ラベルの変更: G8 公開後、かつ xl3-py が Stage 1 の 50% 以上に到達した時点で alphabeta

0.8.0 — データブロック設計の全面見直し(2026-05-23 出荷)

テーマ: 元のゲートテーブルには予定されていなかった追加作業。0.7.x 後期にデータブロック展開を監査したところ、構造的なバグが 2 件(#46 共有数式のオーナー重複、#47 押し出されたサイドセルの参照が古くなる)見つかり、これ以上の機能追加の前に列スコープでの書き換えが必要になりました。元の「0.8.0 = 社会的ゲート」計画は 0.8.x パッチ に移動します。

出荷した成果物:

  • ADR-0066 — データブロックを列スコープ化: {{...}} マーカーのバウンディングボックスを、連続する非空セルまで拡張する。ブロックが展開しても、その範囲外のセルは行位置を保ちます。#46 / #47 を構成的に解消。
  • ADR-0067 — 明示的な @block ディレクティブを 3 形式で(ベア、A:D の列範囲、A2:D7 の矩形)。
  • ADR-0068 — オプトインしたシートでの厳格な複数ブロック検出: すべての [Column] マーカーはいずれかのブロック内にあり、ブロックの矩形同士は重なってはいけません。
  • ADR-0069 — 近接性によるブロック単位のディレクティブスコープ: @filter/@sort/@top/@source/@join/@group/@repeat は、そのディレクティブの列と列範囲が重なる最も近いデータブロックに紐づきます。
  • 新規エラーコード 4 件: xl3/expression/bracket-outside-blockxl3/block/overlapxl3/block/empty-tablexl3/directive/orphan
  • 適合性フィクスチャ 146-155(複数ブロック、異なるソースを持つ横並びブロック、縦積みブロック、ブロック単位のフィルタ、ブロック単位の ROW() スコープ、新規エラー経路 3 件)。

ゲートへの影響:

  • G1 — コーパスは 139 → 154 件。フロアを再びクリア。
  • G3 — 30 日のエラーコードカタログクロックは、新規 4 コードにより 2026-05-23 にリセット。最短のチェックは 2026-06-22 で、0.8.x パッチ期間中にコードの追加/改名がないことが条件。

0.8.x — 社会的ゲート(進行中)

クローズするゲート: G14(外部 ADR)、G15(本番事例;メンテナの雇用主でのデプロイ経由で進行中)、G16(メンテナ拡大、または単一メンテナの明示的受容)、G19(移行ガイド)、G20 の完了。

リクルート期間中に黙って待つのではなく、その間 0.8.x のパッチをこまめにリリースしていく計画です。G3 の四半期規律: 社会的ゲートが進行している間、エラーコードの追加と改名は先送りします — 追加が起きるたびに G3 のクロックがリセットされ、0.9-rc のターゲットが後ろにずれます。0.8.x の窓の期間中に追加してよいのは、本書の定義に沿ったクリティカルバグ修正のコードのみです。

0.9.0-rc.x — 1.0 前のフリーズ

クローズするゲート: G3G6G7G23(21 日以上の RC ソーク)。

G23 が始まると、G24 の四半期クロックがカウント開始します(上記の定義のとおり、G3/G6/G7 などがクローズしていく間にクロックは既に動いている必要があります)。

0.9.0 — 最終フリーズカット(2026-06-23)

1.0 前のフリーズゲート 4 件すべてがチェックされました: G3(2026-06-23 — 最後のカタログ変更 2026-05-24 + 30 日)、G6(2026-06-17)、G7(2026-06-21、PR #59)、G23(2026-06-16 — 21 日ソーク、クリティカルゼロ)。RC ソーク中の修正 #49–52 を統合;#54/#56/#57 は post-1.0 マイルストーンに先送り(POST-1.0 の追加機能 — このカット時点でのマイルストーン名は「0.10.0」でしたが、0.10.0 と 0.11.0 がどちらもこれらを含まずに出荷されたため 2026-07-27 に改名。#57 は #82 のホスト駆動 __inputs__ ソースメタデータに置き換えられクローズ)。G24 の 90 日四半期クロックは最後のゲートチェック(2026-06-23、G3 経由)から開始;仕様/API/エラーコードの破壊的変更がなければ 1.0 は最短 2026-09-21。

0.10.0 — 組織移管 + @subtotal の正しさ(2026-07-19 出荷)

リポジトリを xl3-lang GitHub 組織に移管し、npm パッケージを @jinyoung4478/xl3@xl3-lang/xl3 に改名しました(インストール名のみの変更。旧パッケージは npm 上で新名称へのポインタ付きで deprecated)。あわせて @subtotal の正しさに関する修正 #66(ADR-0073)と #69(ADR-0074)を統合しました: 現在行の [Column] 参照を持つ @subtotal 行、および明示的 @block モードでのグループ + 小計は、どちらも 無言で もっともらしいが誤った出力を出していました — それぞれ専用のエラーを送出するようになりました。

ゲートへの影響:

  • G1 — コーパスは 157 → 160 件(159 mixed-row エラー、160 数式キャッシュはマーカーではない保証、161 明示的ブロックの拒否)。
  • G3 / G24 — エラーコードを 2 件 追加(xl3/subtotal/mixed-rowxl3/subtotal/explicit-block-unsupported);改名・削除・再利用はありません。上記の破壊的変更の定義では追加のみなので、四半期クロックはリセット されません
  • G6 — 公開 API サーフェスのスナップショットは不変。改名はインストール名のみに影響し、convert / preview / analyze、サブパスエクスポート、xl3-conformance bin は同一です。

0.11.0 — JSON ソース入力(2026-07-19 出荷)

convertJson / previewJsondata.xlsx の代わりに言語非依存の xl3-source-json/0.1 ワイヤフォーマットを受け取れるようになり、Excel 以外のホスト(Python、DB/ETL サービス)はワークブックの往復を省略できます(ADR-0075、#71、実装は #80)。あわせて JS リファレンス実装をルートの npm workspace 配下の impl/js/ に移動しました(#79) — レイアウトのみで、挙動の変更はありません。

ゲートへの影響:

  • G3 / G24 — エラーコードを 1 件 追加(xl3/source-json/invalid);追加のみでクロックはリセットされません。
  • G6 — 凍結されたサーフェスに 2 つのエクスポート(convertJsonpreviewJson)が加わり、spec/STABILITY.md に記録済みです。追加のみで、既存エクスポートの削除やシグネチャ変更はなく、.xlsx 経路も無変更です。
  • G24 の窓 — どちらのカットも、2026-06-23 に始まった四半期の内側である 2026-07-19 に着地しました。いずれも上記定義の破壊的変更ではないため、1.0 の最短は ≈ 2026-09-21 のままです。

1.0.0 — 最終リリース

クローズするゲート: G24(最後のゲート完了から 90 日の四半期を消化済み)。

採用とアウトリーチ

社会的ゲート(G13/G14/G15/G16)はコードではなく人手を必要とします。プロジェクトには区別された二つの採用接面があります。

韓国オペレーション層(G15、将来のクックブックコントリビューター)

チャネル: 韓国のデベロッパーコミュニティ(Naver Café、Kakao 오픈톡、LinkedIn KR)、社内向けまたはベンダー向けのテンプレート作成者アンケート。マイナーリリースごとに、リリースの瞬間に紐づく韓国語ポストを公開します(0.6 = 請求書の小計パターン向け @group/@subtotal デモ、0.7 = 性能数値、0.8 = ケーススタディ)。

英語 OSS 層(G13、G14)

チャネル: HN、lobste.rs、r/excel、カンファレンス CFP(JSConf、xl3-py 向けには EuroPython)。メジャーな節目ごとに、特定の外部成果物を 1 つ出荷します。

  • 0.7.0 リリース: 「Show HN: xl3 0.7 — 100k 行対応の Excel テンプレートエンジン」
  • 0.8.0 リリース: ケーススタディ + xl3-py 適合性ダッシュボード
  • 1.0.0 リリース: 仕様 + 複数実装による検証

1.0 のノンゴール

これらは意図的に先送りしています。それぞれ理由を説明する ADR があります。

  • Y/M/D/EOMONTH/EDATE/DATEDIF を超える日付演算 — その他のファミリーは ADR-0019 改訂 により先送り。
  • ロケール対応の文字列照合ADR-0020
  • マルチ結合、左結合、複数行マッチADR-0014 のスコープ外セクション。
  • XLOOKUP のワイルドカード / 近似 / 逆方向検索ADR-0013 のスコープ外セクション。
  • 動的画像挿入ADR-0037
  • 実行時のセル変更ADR-0042
  • ADR-0043 ゲートにより却下された関数群 — 数学関数の拡張、型テスト(ISBLANK は ADR-0047 で例外的に採用)、NOW / WEEKDAY 等、条件付き集計、TEXT() 書式トークンの拡張。ADR-0045 を参照。
  • ストリーミング出力 / SXSSF 相当機能。 1.1+ に先送り。1.0 では代わりに、メモリ/行数のハードリミットを文書化(G21)します。
  • テンプレートコンパイルキャッシュ API。 1.1+ に先送り。
  • PDF / HTML 出力。 スコープ外。xl3 は xlsx 入力 - xlsx 出力に特化します。
  • 093 を超えるクロスライター Stage 2 フィクスチャADR-0006 改訂。
  • 出力側のテンプレートスキーマ(produces)と設計時チェイニング — xl3#109 の入力検証提案(validateSource(): 「このソースはこのテンプレートを満たすか」を既存の xl3/source/* コードを再利用して答えるもの)は、まず入力側のみにスコープします。その対となる出力側 — 出力列ラベルを持つ TemplateModel.produces、すなわち変換を実行せずに templateA → templateB のエッジをホストが検証できるようにするもの — は先送りです。これはプロジェクトがまだ固めていない規約を必要とします: シートテンプレートのどのリテラル行が出力ヘッダーなのか。requires と違ってこれはパーサが解決した結果から導出できないため、各エンジンが個別に推測するのではなく、決めて文書化する必要があります。ADR はまだありません。設計の議論は xl3#109 にあります。

これらは需要に応じて XTL 1.1、1.2、1.x の候補として残ります。

項目クローズへの貢献方法

項目貢献の仕方
G13 第二実装 ≥ 80%xl3-py に貢献するか、新たな移植(Rust、Java、Go)を始める。PORTERS_GUIDE.md を参照。
G14 外部 ADR先送り項目(ピボットテーブル保持、改ページ、ADR-0045 で除外された関数)を一つ選び、spec/decisions/ に ADR を起草する。GOVERNANCE.md の「How changes enter the project」を参照。いくつかの「スターター ADR スタブ」が GitHub の good-first-ADR イシューとして用意されています。
G15 本番事例xl3 を内部で利用し、うまくいったこと/いかなかったことを共有する。適切であれば IMPLEMENTATIONS.md に行を追加する。メンテナ自身の雇用主(Snack24h)も、公開ケーススタディを出せば対象となります。
G17 ガイドの i18ndocs/guides/19-jxls-to-xl3.md(JXLS → xl3 移行ガイド)に ko / ja / zh-CN 訳がない。レシピ 01-18 は完了済み。
G8 ベンチマーク代表的なテンプレートで npm run bench を回し、結果を共有する。
G10 クロスブラウザSafari + Firefox をバンドルスモークテストに追加する。
関数の再提案ADR-0045 で却下された関数が必要な場合は、Function re-proposal のイシューテンプレートを使ってください。

このロードマップの更新方法

本書は公開エレベーターピッチであり、ゲートテーブルが唯一の正典です。より深い docs/internal/blueprint-to-1.0.md が、ギャップ分析、設計思想の境界、バージョンごとの根拠を扱います。ゲートがチェックされるごとに、両方のドキュメントを更新します。新たなギャップが浮かべば、両方に追記します。

1.0 ゲートテーブルへの追加や削除は、他のすべてと同じく ADR / イシュープロセスを通して議論されます。