Public Edition
この文書はWebsite Operations Policyの公開版である。内部正本から非公開情報を除き、公式ホームページのPresentation Layer運用に必要な方針を掲載する。
本書は、Local AI Foundry公式ホームページに何を掲載し、いつ更新し、どの公開情報へ利用者を案内するかを定める。
公式ホームページはPresentation Layerであり、内部成果物、Publication Review、公開判断または公開Documentationの正本ではない。
公式ホームページは、初めてプロジェクトを知る閲覧者、継続的に開発状況を追う利用者、公開資料やGitHubへ進む技術者に対し、プロジェクトの価値、設計の概要、公開可能な現在地、主要な更新および公開情報への入口を提供する。
更新では、既存のブランド、情報構造、公開範囲を維持する。内部仕様を転載せず、公開する価値と導線に変更が生じた場合に必要な範囲を更新する。
Publicationの契約はdocs/governance/publication-governance.mdを参照する。
Internal Publication Review RegistryはInternal Repositoryで管理する。Human-controlled Private HistoryはPublication Executionの外部責務であり、Public Repositoryまたは公式ホームページへ配置しない。
| Layer / Document | Responsibility |
|---|---|
| Internal Repository | 唯一の正本 |
| Publication Governance | 公開契約・公開統制 |
| Internal Publication Review Registry | 各管理対象のCurrent Publication Review |
| Human-controlled Private History | Humanが必要に応じてPublication Executionの外部で保持する判断履歴 |
| Public Repository | 承認済み公開成果物 |
| Website | Presentation Layer、概要、告知、公開導線 |
本書はWebsiteの表示と公開導線だけを扱う。
公開可否、Mask / Generalization、Human-controlled Private Historyの管理またはCurrent Publication Reviewを本書で決定・保持しない。
Internal Publication Review RegistryおよびHuman-controlled Private Historyの内容をWebsiteへ複製しない。
公式サイトの正式リリースはvMAJOR.MINOR.PATCHの考え方で管理する。現在の表示形式に合わせ、Patchが0の場合はv2.9のように省略できる。
正式リリースは、対象変更と公開成果物が整合し、検証が完了した時点で付与する。複数の軽微な変更は、公開上の意味が一つになる単位へまとめてよい。
日付は、HTMLのdatetime属性とファイル名ではYYYY-MM-DD、画面表示ではYYYY.MM.DDを使用する。
Version更新の要否は変更量ではなく、公開上の意味が変化するかで判断する。利用者が認識すべき変更はVersion更新対象とし、判断に迷う場合はVersion更新側へ倒す。複数の軽微な修正をまとめて正式リリースとして扱うことは許容する。
Version更新を原則必要とする変更:
Version更新を原則不要とする変更:
| 変更内容 | Version更新 |
|---|---|
| Public Documentation追加・大幅更新 | 必要 |
| 公開Architecture変更 | 必要 |
| 公開Contract・Workflow仕様変更 | 必要 |
| 公式サイト構成変更 | 必要 |
| Typo・表記揺れ修正 | 原則不要 |
| 軽微なリンク修正 | 原則不要 |
| CSS微調整 | 原則不要 |
Version更新を伴う場合は、公式トップページ、Releases一覧、個別Releaseページを同時更新する。
Commitは公開準備であり公開完了ではない。承認されたPublic RepositoryへのPushとGitHub Pages反映確認まで完了した時点をRelease Completeとする。
トップページには、閲覧者がプロジェクトの現在を理解するために重要な更新だけを掲載する。
掲載対象:
原則として掲載しないもの:
例外として、リンク監査のように公開情報の信頼性へ広く影響する保守作業は、正式リリースとして記録できる。
releases/index.htmlは、公式サイトの正式リリースを時系列で一覧化する。各正式リリースは、日付、バージョン、Theme、Keywords、要約および詳細ページへの導線を持つ。
詳細ページには、公開利用者へ影響する変更、改善理由、検証結果を簡潔に記載する。内部実装値、Prompt、非公開Evidence、環境固有情報、Internal Publication Review RegistryまたはHuman-controlled Private Historyの内容は掲載しない。
ReleasesページはGit履歴、Internal Publication Review RegistryまたはHuman-controlled Private Historyの複製ではない。
Gitが技術的な変更記録、Internal Publication Review RegistryがCurrent Publication Reviewを保持するのに対し、Releasesページは公開上意味のある変更を人間が理解できる単位で説明する。Human-controlled Private Historyはこの責務分担およびPublication Executionの外部にある。
Historical Releaseは、そのRelease時点で公開された内容を保持する。後続変更によって過去Releaseの事実を自動的に書き換えない。
現在のPublication構造に変更が生じた場合は、必要に応じて後続Releaseとして記録する。
Git Commitは、Public Repositoryに反映されたファイル単位の変更内容と差分を追跡する技術記録である。
Git Commitだけでは、Publication Review、公開判断またはGitHub Pages反映完了を証明しない。
GitHub Releasesは、配布物、タグ、外部利用者へ固定して告知する成果物がある場合に使用する。すべてのサイト更新に必須とはしない。作成する場合は、公式サイトのバージョンと説明を整合させる。
公式サイトは、プロジェクトの価値、公開可能な設計、公開上の現在地、主要な更新および次に進む導線を示す。
Commit一覧、Internal Publication Review Registry、Human-controlled Private History、内部変更履歴またはPublic Documentation本文の代替にはしない。
内部DocumentationはInternal Repositoryに保持し、実装、運用、構成管理、詳細契約、検証Evidenceの唯一の正本を構成する。
内部DocumentationをPublic Repositoryまたは公式サイトから直接リンクしない。
Internal Publication Review Registryは内部Documentationとして扱う。Human-controlled Private HistoryもPublic Repositoryまたは公式サイトへ公開しない。
Public Documentationは、Internal Repositoryの正本からPublication Governanceに従って生成または管理された公開成果物である。
公開可能なArchitecture、Principles、Status、ADR、Operational Reviewその他の公開成果物を保持できるが、Internal Repositoryの正本性を代替しない。
公開時はPublic版だけを公式導線へ掲載し、内部文書への導線を含めない。
公式サイトは概要と入口を担当する。Public Documentationの全文を重複掲載せず、閲覧者が必要な深さへ進める導線を提供する。
同じ事実を複数箇所へ記載する場合、詳細は対応する公開成果物へ置き、公式サイトは要約とリンクに限定する。
Internal Artifact
↓
Publication Classification
↓
Mask / Generalization要否判定
↓
Human Review
↓
Human-approved Current Publication Decision
↓
Internal Publication Review Registry Update
↓
Public Artifact作成
↓
Public Repository Reflection
↓
GitHub Read Verify
↓
Website Presentation Reflection
↓
Version / Releaseページ更新
↓
GitHub Pages反映確認
↓
Release Complete
Internal Publication Review Registryは、各管理対象のCurrent Publication Reviewを保持する。
Human-controlled Private HistoryはPublication Executionの外部責務である。Humanが必要に応じて保持する場合も、Publication Executionの入力、Gate、依存または完了条件として扱わない。
工程の一部が対象外の場合は省略できるが、公開内容とInternal Repositoryの正本との対応確認、必要なPublication Review、Human-approved Current Publication DecisionおよびWebsiteの導線確認は省略しない。
Internal Publication Review RegistryはInternal Repositoryで管理する。Human-controlled Private HistoryはPublication Executionの外部責務とし、Public RepositoryまたはWebsiteへ配置しない。
Push未実施のCommitは公開されていない。正式リリースは、承認されたPush後のGitHub Pages反映確認をもって完了する。
Documentation編集のみを目的とする作業では、Humanが指定した停止点に従う。Releaseまたは公開を目的とする作業でも、Push権限を作業指示や本書から推測してはならない。
Website Reflectionは次をすべて満たした場合に完了とする。