Skip to content

README.md

Latest commit

 

History

History
28 lines (18 loc) · 1.47 KB

README.md

File metadata and controls

28 lines (18 loc) · 1.47 KB

MaintenancePolicy

Central maintenance policy for PrPlanIT repositories. Enforced by StageFreight.

How it works

This repo IS a StageFreight-managed repo. Its .stagefreight.yml declares governance clusters — groups of repos that share lifecycle policy. When CI runs, stagefreight governance reconcile resolves presets, generates managed configs, and commits directly to satellite repos.

Structure

  • preset/ — section-scoped config fragments (one top-level StageFreight key per file)
  • claude-code/ — Claude Code project settings distributed to governed repos
  • docs/ — documentation and rationale
  • precommit/ — pre-commit hook configs (future)
  • renovate/ — Renovate bot configs (future)

Governed files

Governance distributes files to satellite repos. Which files are governed and how drift is handled is policy-declared per file:

  • governed + replace — machine-owned, drift is overwritten (e.g., .stagefreight/stagefreight-managed.yml, .gitlab-ci.yml)
  • governed + warn — governance-seeded, drift emits warning but still replaces
  • local-friendly + warn — seeded as starter, local edits tolerated
  • local-friendly + ignore — seeded once, never touched again

.stagefreight.yml may itself be governance-seeded or governance-enforced when policy declares it governed. Governance ownership is policy-declared per file, not hardcoded by filename.

Detaching from governance is always possible.