Skip to content

Generated from corpus/lines/software/units/sw.std.github-first.md. Do not edit by hand — run python 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