Commits
- One clubbed commit per theme. A feature that spans API, CLI, dashboard and docs is one commit, even at 50 or more files. Do not split a feature into 1 to 3 file commits.
- Subject:
type(scope): outcome, under 72 characters. Types are feat, fix, perf, refactor, docs, test and chore. Describe the result, not the activity. - Body: at most 3 short lines of why. Optional trailers
Task: 118, 123andADR: 074. - No AI attribution and no co-author trailers.
Pull request description
Fill in the PR template. Keep the bullets specific: name the verb, the route, the setting key, the flag, the table or the UI page. For a release PR, build the description from the merged PR sections:- Group by capability, not by commit order.
- List every migration number, forward only.
- List every new runtime setting key with its default.
- List every flag with its status label.
- Collect behaviour changes and upgrade notes in one place.
- Collect the “Not verified / needs a real host” items so unproven checks are visible.
Where tracking lives
Update the matching row in the same commit that changes the behaviour. A claim without a row or evidence does not ship as stable.
Issues and project
Issues and PRs are public and curated. An issue exists only for a shippable feature or epic with acceptance criteria, never for scratch notes.- One issue per shippable feature, from the Tracked feature form. Epics use the Epic form and list child issues.
- Each issue gets a milestone per release (for example v0.9.5) and the labels area/, type/, size/* and priority/*.
- The commit carries an
Issue: #Ntrailer. The PR description saysCloses #N. - Proof for PRs and tickets is generated by
scripts/proof(see Proof automation); a new page or card brings itsaffected.mapline. - Project fields on the GLINR Projects board: Status, Priority (P0 to P2), Size (XS, S, M, L, XL), Product (Levelrail, Thesvg, Kelvo, Other, set from the repo name), Surface (API, CLI, Dashboard, Agent, Docs, Multi). The board is public and shared with other glincker repos, so filter by Product.
- Helper:
scripts/track.sh issue <title> <body-file> [--labels a,b] [--milestone vX] [--size XS|S|M|L|XL] [--surface API|CLI|Dashboard|Agent|Docs|Multi]creates the issue and adds it to the board.scripts/track.sh ship <issue> <sha>comments the commit. It needsgh auth refresh -s project,read:project. SetGLINR_PROJECT(default 7) andGLINR_OWNER(default glincker) to target another board.
Generated files
Regenerate, never hand merge. On a conflict in a generated file (API reference, OpenAPI, route tree, locale catalogs), take either side, then run the repo generator and commit the result.Labels and evidence
Move a label up only with the evidence in the same change, and link the test or run in the feature-status row.
Runtime settings, not env
New tunables are runtime settings: reachable from the API, CLI and dashboard, applied live where possible. Environment variables only seed defaults and never lock a value. Thresholds are never hardcoded. Record the key, default and whether it applies live or needs a restart in the PR.Assignment
When a PR opens, the auto-assign workflow assigns the PR author. Issues linked from the PR body (Closes, Fixes, Resolves, Tracks #N) or from Issue: #N commit trailers get the same assignee if they have none. Bots and fork PRs are skipped for issues, and human-opened issues are left to triage. Project board fields are set by the project’s own automation, not by this workflow.