正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

AI principles distillation flow

一貫した開発プロセスとドキュメントを確保するため、GitLabへのすべての貢献は英語で提出する必要があります。そのため、GitLabへの貢献に関するドキュメント（https://docs.gitlab.com/development/に掲載）も英語でのみ提供されています。

以下を希望される場合：

  • コードの貢献を提出する
  • バグの報告または修正
  • 機能や改善の提案
  • ドキュメントへの貢献

これらのページの英語版のガイドラインに従ってください。

このページの英語版にアクセスしてください。

The weekly sync distills AI development principles from documentation. Review this flow before changing the manifest, the distiller gem, or the sync schedule.

For the step-by-step description, see How the sync works.

Distillation flow

Each sync run starts with drift detection and ends with a merge request that updates the distilled files.

%%{init: { "fontFamily": "GitLab Sans" }}%%
flowchart TD
    accTitle: AI principles distillation flow
    accDescr: Flowchart of the weekly sync run, from drift detection through merge request creation
    Start([Weekly scheduled CI job]) --> Load

    Load[Load manifest.yml] --> Drift

    Drift{Checksum matches<br/>distilled file front matter?}
    Drift -->|Yes| UpToDate[Principle is up to date]
    Drift -->|No| Affected[Principle needs an update]

    UpToDate --> AnyAffected
    Affected --> AnyAffected

    AnyAffected{Any principles<br/>need an update?}
    AnyAffected -->|No| Done([Exit: nothing to do])
    AnyAffected -->|Yes| Validate

    Validate{Source and baseline<br/>files exist?}
    Validate -->|No| Fail([Fail: missing source path])
    Validate -->|Yes| Distill

    Distill[Call GitLab Duo Agent Platform<br/>Workflow API per principle] --> Assemble

    Assemble[Assemble distilled file<br/>and absolutize links] --> Meaningful

    Meaningful{Content changed?}
    Meaningful -->|No| NoChange[Skip principle]
    Meaningful -->|Yes| Write[Write file with<br/>new checksum front matter]

    NoChange --> Collected
    Write --> Collected

    Collected[Collect updated files] --> MR

    MR[Open merge request<br/>targeting the default branch] --> Review([Human approval and merge])