OSS Ready

Transform a project into a professional open-source repository with standard community files and GitHub templates.

Two terms are used throughout:

• Additive edit: on a file that already exists, add only missing sections or lines. Never replace, reword, translate or delete the user's content.
• Placeholder: a match of PH='\[(YEAR|COPYRIGHT HOLDER|INSERT [A-Z ]+)\]|TODO|TBD|FIXME' in a created file, or in a line the run added to an existing file.

Repo Sync Before Edits (mandatory)

Prerequisites: a git repository on a named branch with an origin remote. Run the block in references/repo-sync.md once, before Step 0. It stops at the first failure, then stashes, rebases on origin, and restores the stash; steps: What the block does in that file.

On a non-zero exit, print the final report with BLOCKED and the recovery commands the block printed. Never discard changes. If the only failure is the missing origin and the user approves continuing, go to Step 0 and list Repo Sync skipped (no origin) under Uncertainty:.

Workflow

Before Step 0, check references/edge-cases.md. If a case matches the repo, handle it as written there first.