Generated from
corpus/lines/software/units/sw.std.github-first.md. Do not edit by hand — runpython scripts/generate-corpus-docs.py.
sw.std.github-first¶
Status: draft (recovered)
Sources: GITHUB-FIRST-STATE.md; root AGENTS.md §6; Software/Lab/Portfolio AGENTS
Guardrails¶
- Meaningful software work gets a GitHub issue (outcome, DoD, stage, owner, review date, links, privacy).
- Execution loop: issue → branch/commits → PR → checks → merge/close.
- Failed Actions/deploy checks are blockers.
- Local folders hold artifacts/pointers;
_repos/holds source checkouts. - Vikunja is for reminders / waiting-for / personal next actions—not PR/check status when a GitHub issue exists.
- Prototypes: tracking issue allowed; no source remote until promote (
sw.estate.prototype).
Exceptions (do not force public GitHub)¶
Sensitive client data, personal/private misc, secrets, contracts; local-only prototypes before promotion.
Prohibited¶
- Using Vikunja as canonical project progress for GitHub-backed work
- Claiming “done” while required checks fail