Background
This repository's CLAUDE.md is currently generated locally from .apm/instructions/master.instructions.md, duplicating content that the master repo tvna/claude-md already publishes (compiled by APM "for other projects"). The local copy has already drifted from the master.
Goal
Track the master CLAUDE.md automatically and periodically, eliminating the local duplicate.
Approach (decided in brainstorming)
Scheduled GitHub Actions workflow that fetches tvna/claude-md's CLAUDE.md, writes it as a committed real file, and opens a PR on changes.
- Real committed file (NOT submodule + symlink): a submodule/symlink would dangle on the web environment's fresh clone, since submodule contents are not part of the parent clone. A committed file is fresh-clone safe.
- Updates land via PR (review gate), no auto-merge.
GITHUB_TOKEN only, no PAT: no CI is path-filtered on CLAUDE.md, so the token's "PRs don't trigger workflows" limit does not apply.
- Requires repo setting "Allow GitHub Actions to create and approve pull requests".
Out of scope
AGENTS.md sync (not present here).
- Removing
.apm/instructions/ + regenerating apm.lock.yaml (apm CLI unavailable in the dev environment; split to a follow-up).
Design doc
docs/superpowers/specs/2026-06-13-claude-md-master-sync-design.md
Background
This repository's
CLAUDE.mdis currently generated locally from.apm/instructions/master.instructions.md, duplicating content that the master repotvna/claude-mdalready publishes (compiled by APM "for other projects"). The local copy has already drifted from the master.Goal
Track the master
CLAUDE.mdautomatically and periodically, eliminating the local duplicate.Approach (decided in brainstorming)
Scheduled GitHub Actions workflow that fetches
tvna/claude-md'sCLAUDE.md, writes it as a committed real file, and opens a PR on changes.GITHUB_TOKENonly, no PAT: no CI is path-filtered onCLAUDE.md, so the token's "PRs don't trigger workflows" limit does not apply.Out of scope
AGENTS.mdsync (not present here)..apm/instructions/+ regeneratingapm.lock.yaml(apm CLI unavailable in the dev environment; split to a follow-up).Design doc
docs/superpowers/specs/2026-06-13-claude-md-master-sync-design.md