light-html-plan

Light HTML Plan

light-html-plan は、計画の記録を、人が読んで確認できるオフラインページにまとめます。記録が正式な情報源であり、ページは日付付きのスナップショットです。Light プロジェクトでは、ページは .scratch/<feature>/plan.html に置き、以前のバージョンは .scratch/<feature>/plan-history/ に保存します。それ以外の場合は、呼び出し元とパスを決めてください。

ページは次の順序で5つのパートから構成されます

1. このプロジェクトについて：計画によって何が変わるのかを、フレームワーク図とともに示します。各ブロックにはコンポーネント名（スキルコレクションの場合は Skill の名前）と、その中で何が変わるのかを表示し、色とテキストで「主な変更」「小規模な変更」「新機能」「変更なし」のいずれかを示します。
2. どこまで進んだか：各作業項目について、「作業中」「完了」「未完了」「証拠」を示します。「記述済み」「受け入れ済み」「リリース済み」はそれぞれ別の状態です。
3. 判断を待っていること：ユーザーの判断待ちで停止しているチケット、proposed 状態の変更提案、未解決の質問、提案でまだ回答されていないレポートの Plan gap:、計画自体が原因の FAIL を、それぞれ何を妨げているのかとともに示します。
4. 承認時から変わったこと：各変更提案について、変更内容、ステータス、承認者を示します。
5. システムが代わりに判断したこと：記録された各判断について、まず平易な言葉で質問を示し、次に回答、確信度、判断者を示します。記録された reason が none ではない行を先に表示します。ID は情報源としてのみ表示します。

内容がないパートには「現時点ではありません」と記載します。パート名は読者の言語で記載してください。パート1の上には、記録の日付、作業の現在の状況、次のステップを示すステータス行を置きます。

各パート内のすべての見出しと主な文は主張です。読者がその箇所を指して「間違っている」と言える内容にしてください。関係性、進捗、数値は図、帯、表、グラフで示し、文章では各図表が何を裏付けているのかを説明します。

手順

1. 新規作成か更新かを判断します。資料、出力先、更新の場合は既存の HTML を確認します。完全な結果だと主張する前に、読み取れない入力を解決してください。
2. source-protocol.md を読み、すべてのコミットメントと記録を情報源およびパートに対応付けます。進捗が記録されている場合、または更新の場合は、progress-and-refresh.md を読みます。
3. writing.md を読みます。まずステータス行と各パートの主張を平易な文章で書きます。声に出して読み、全体の状況が伝わるまで修正します。
4. design-and-verification.md に従い、skeleton.html を基に、plan.css をインライン化してページを作成します。テキストが確定してからデザインに着手します。更新の場合は、ページの既存デザインを維持します。
5. 折りたたまれたセクションも含め、レンダリング後のページ全体を読みます。文言は CSS ではなくテキストを修正します。コミットメントの対応表と照合します。1440px と 390px の幅、ライトテーマとダークテーマ、オーバーフロー、ファイルが外部リクエストを行わないことを確認します。

返却と終了

HTML のパス、SHA-256 付きの情報源の場所、変更内容、実施した確認と未実施の確認を返します。実行が進行中の場合は、進捗リファレンスに記載された更新の引き継ぎ情報を含めます。

ページには情報源のパス、日付、SHA-256 を記載し、情報源の全文は埋め込みません。ページが読みやすく見栄えもよいかどうかは、ユーザーがページを読んで判断します。実施した確認を報告し、その評価はユーザーに委ねてください。

この機能は、計画の承認、チケットの分割、タスクや提案の状態変更、公開、インストールを行いません。情報源に関する質問は、その所有者に戻します。また、ユーザーが呼び出す別の Skill を起動することもありません。 ATTRIBUTION.md には、上流の参照元と Light による変更が記録されています。

呼び出し元との契約

• 任意です。 この機能がない場合や呼び出し元が利用を拒否した場合、呼び出し元は元の動作を維持し、ページも最後のバージョンを維持します。この機能がないことを理由に、誰も BLOCKED と報告したり、インストールを求めたりしません。
• 最初に呼び出し元が記録します。 呼び出し元は、更新を求める前にイベント（実装レポート、判定、提案）を書き込みます。ページは記録を読み取り、記入することはありません。
• 処理を引き継がず、応答して戻ります。 配信後に戻ります。
• 何も許可しません。 ページは状態を表示します。承認、受け入れ、リリースは行いません。