Skip to content

Security: cvsz/ztemplate

SECURITY.md

Security Policy

Security is part of the default delivery baseline for repositories created from this template.

Reporting a vulnerability

Do not disclose exploitable vulnerabilities in public issues, pull requests, discussions, commit messages, logs, or generated evidence bundles.

Use GitHub private vulnerability reporting/security advisories when enabled, or the repository's documented private security contact.

Include affected versions/commits, reproduction details, impact, prerequisites, and suggested remediation when available.

Supported versions

Each generated project must replace this section with its real support policy before its first production release.

Repository security baseline

Generated repositories should verify, not merely document:

  • protected default branch
  • pull-request review before merge
  • required status checks
  • CODEOWNERS review where appropriate
  • conversation resolution
  • blocked force pushes/deletion
  • Dependabot vulnerability alerts/security updates
  • private vulnerability reporting
  • secret scanning/push protection where available
  • least-privilege Actions permissions
  • Actions cannot approve pull requests unless explicitly justified

The helper scripts/github_admin.py can configure and verify the baseline when run with a GitHub identity that has Administration permission.

Engineering security expectations

  • Keep dependencies patched and review security alerts.
  • Keep CodeQL and dependency-review workflows enabled where supported.
  • Pin Actions according to supply-chain policy; this template pins baseline Actions to immutable SHAs.
  • Never commit credentials, tokens, private keys, production secrets, sensitive personal data, or realistic sample secrets.
  • Validate untrusted input and enforce authorization at trust boundaries.
  • Prefer fail-closed behavior for security-sensitive paths.
  • Preserve tenant/data isolation where applicable.
  • Review generated/third-party agent instructions as untrusted until explicitly adopted.
  • Do not weaken security gates merely to obtain a passing build.

Incident handling

Generated projects should document detection, containment, credential handling, remediation, recovery, validation, disclosure, and rollback appropriate to their risk profile.

Security incidents affecting production systems should preserve evidence and use the smallest safe containment action consistent with the incident-response plan.

There aren't any published security advisories