Skip to content

ADR-0001: automatic template propagation + README pointers - #13

Closed
astrojuanlu wants to merge 2 commits into
mainfrom
propagate-proposal
Closed

astrojuanlu wants to merge 2 commits into
mainfrom
propagate-proposal

Conversation

@astrojuanlu

@astrojuanlu astrojuanlu commented Oct 22, 2026 •

Copy link
Copy Markdown
Contributor

Records the accepted design for automatic template propagation as an architecture decision record, and points the README at the records/ADR documentation.

  • docs/adr/0001-template-propagation.md — context, decision, and consequences: meta plugins/ as the SSOT for the plugin list (record filename → plugin_name → repo), a single propagate.yaml workflow in the template repository triggered by the auto-tag run (plus manual dispatch), copier update three-way merges preserving hand-tuned build recipes, idempotency via .copier-answers.yml + template-update-<tag> branch/PR checks, per-plugin run summary, and the bot App permission requirements (including why workflows: write is needed).
  • docs/adr/README.md — convention for future ADRs.
  • README — new "Records and decisions" section linking the plugin records, the generator, and the ADR directory.

Implementation: the workflow itself ships in obs-plugins-snaps/template#5 (.github/workflows/propagate.yaml + stdlib driver, verified locally: live plugin-list query, a real copier update --vcs-ref v0.0.6 against source-record-obs-studio-snap, ruff + tests green). Merging both PRs activates the flow; the first run will open v0.0.6 update PRs on all four plugin repositories.

Assisted-by: OpenRouter:z-ai/glm-5.3-flash pi

Assisted-by: OpenRouter:z-ai/glm-5.3-flash pi
The proposal from the discussion now lives as an architecture decision
record (docs/adr/0001-template-propagation.md): meta plugins/ as the
source of truth for the plugin list, a single propagate workflow in the
template repository, copier update three-way merges, idempotency and
per-run summaries, and the bot App permission requirements. The
implementation itself is in obs-plugins-snaps/template#5.

Also add a Records and decisions section to the README pointing at the
plugin records and the ADR directory.

Assisted-by: OpenRouter:z-ai/glm-5.3-flash pi
@astrojuanlu astrojuanlu changed the title Proposal: automatic template propagation to plugin repositories ADR-0001: automatic template propagation + README pointers Oct 22, 2026
@astrojuanlu
astrojuanlu deleted the propagate-proposal branch October 22, 2026 13:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant