babarot/gh-infra/file-manifest

File Manifest Reference

Use this skill for file-distribution manifests. Keep the main body small and open references only when the request needs them.

Core Rules

• File is parsed as a one-repo FileSet internally, but you still author the simpler shape
• Each file entry requires path and exactly one of content or source
• via defaults to push
• reconcile defaults to additive
• patches are applied after template expansion

File

apiVersion: gh-infra/v1
kind: File
metadata:
  owner: my-org
  name: my-repo
spec:
  files:
    - path: .github/CODEOWNERS
      content: |
        * @username
    - path: LICENSE
      source: ./templates/LICENSE
  via: push
  commit_message: "ci: sync managed files"

Key fields:

• files: required
• via: push or pull_request
• commit_message, branch, pr_title, pr_body: delivery controls. commit_message, pr_title, pr_body accept <% .Repo.Name %>, <% .Repo.FullName %>, <% .Source.URL %> (env GH_INFRA_SOURCE_URL, set in CI); see references/reconcile-and-delivery.md
• files[].vars: template variables
• files[].patches: unified diff patches
• files[].reconcile: additive, authoritative, create_only
• files[].executable: true for mode 100755, false for 100644, omitted keeps the current mode

Read these references as needed:

• Sources and templating: references/sources-and-templating.md
• Reconcile and delivery: references/reconcile-and-delivery.md
• Patches: references/patches.md
• FileSet and overrides: references/fileset.md
• Import-into behavior: use the dedicated import-into skill

FileSet

Use FileSet to distribute shared files to many repositories.

apiVersion: gh-infra/v1
kind: FileSet
metadata:
  owner: my-org
  name: shared-ci          # optional; names the FileSet, does not select repos
 
spec:
  repositories:
    - gomi                # simple string
    - enhancd
    - name: gh-infra      # struct with overrides
      overrides:
        - path: .github/CODEOWNERS
          content: |
            * @username @co-maintainer
 
  files:
    - path: .github/CODEOWNERS
      content: |
        * @username
 
    - path: LICENSE
      source: ./templates/LICENSE
 
  via: push

Each repository entry is either:

• a simple repo name string
• an object with name and optional overrides

Overrides replace the matching base entry by path for that repository only.

High-Value Gotchas

• Prefer patch files over inline patch blocks for files with tabs
• Patch context must match template-expanded content, not raw template source
• github:// sources are import hard-skips because there is no local write target
• Shared local source files in FileSet often default to the patch write action in import --into
• create_only affects apply behavior, but import can still update the local master template

Verification

gh infra validate <path>
gh infra plan <path>