Context
The current README.md contains misleading language suggesting community health files "auto-apply" to org repos. This is false — GitHub's auto-serving only works for public .github repos, and even then only serves files not present in the individual repo. The actual mechanism is the explicit sync-community-health.yml push workflow.
Additionally, the README does not document:
- The 6 target repos that receive synced content
- Which files are synced vs which remain meta-repo only
- That the repo is intended to go private (and that sync is the reason it's safe to do so)
Implementation
Edit README.md to:
-
Remove the false "auto-apply" claim — replace with accurate description of sync-community-health.yml as an explicit push workflow
-
Add a "Sync Architecture" section listing:
- The 6 target org repos (e.g.,
gaming_app, book_app, etc.)
- What gets synced: community health files, Claude Code hooks and agents,
settings.json merge
- What does NOT get synced:
.claude/policies/, CODEOWNERS, dependabot.yml, cloudflare/
- How to trigger the sync:
workflow_dispatch on sync-community-health.yml
-
Update the "Removed workflows" section if stale entries exist
-
Verify all existing sections for accuracy after Phase 2 changes (new files added, root files deleted)
Acceptance Criteria
Dependencies
None — can be worked in parallel with all other Phase 2 issues.
Recommend merging after or alongside other Phase 2 issues so README reflects final state.
Part of Epic
#77
Context
The current
README.mdcontains misleading language suggesting community health files "auto-apply" to org repos. This is false — GitHub's auto-serving only works for public.githubrepos, and even then only serves files not present in the individual repo. The actual mechanism is the explicitsync-community-health.ymlpush workflow.Additionally, the README does not document:
Implementation
Edit
README.mdto:Remove the false "auto-apply" claim — replace with accurate description of
sync-community-health.ymlas an explicit push workflowAdd a "Sync Architecture" section listing:
gaming_app,book_app, etc.)settings.jsonmerge.claude/policies/,CODEOWNERS,dependabot.yml,cloudflare/workflow_dispatchonsync-community-health.ymlUpdate the "Removed workflows" section if stale entries exist
Verify all existing sections for accuracy after Phase 2 changes (new files added, root files deleted)
Acceptance Criteria
sync-community-health.ymlas an explicit push workflowDependencies
None — can be worked in parallel with all other Phase 2 issues.
Recommend merging after or alongside other Phase 2 issues so README reflects final state.
Part of Epic
#77