← Back to technical notes

// release hygiene

Release artifact hygiene

The install package must be smaller, cleaner, and more intentional than a GitHub source snapshot.

// install rule

The public rule

Do not use GitHub Code > Download ZIP as the install package. Use the uploaded GitHub Release asset only.

// boundary

What release hygiene protects

  • No local QA temp files in the install archive.
  • No generated runtime state from the release workspace.
  • No private strategy, pro-only, or commercial planning documents in free/core.
  • No local machine paths or secrets.
  • Release archive shape stays canonical for users and agents.

// proof links

Implementation references