Skip to content

Sync CLAUDE.md from tvna/claude-md master via scheduled workflow #427

Description

@tvna

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions