adam/engineering-handbook
1
0
Fork 0
mirror of https://github.com/Sea-Haven-Industries/engineering-handbook.git synced 2026-09-30 15:03:14 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
engineering-handbook/AGENTS.md
Adam Moussa 10f72b4a33
docs(review): retire security and cross-family review gates 
Those reviews are no longer merge gates. A new deploy workflow still needs its job_workflow_ref on the deploy role.
2026-09-26 16:52:30 -04:00

1.4 KiB
Raw Blame History

Sea Haven Governance

Standards authority: engineering-handbook · Status authority: Jira

Routing

  • Product / feature work → DEV
  • Infrastructure and platform → PLAT
  • Security → SEC

Branches

feature/, fix/, hotfix/, chore/, docs/, refactor/, release/ + kebab-case description. No Jira keys in branch names.

Pull Requests

Title: type(scope): description (DEV-123) — every non-exempt PR ends with its Jira key.

Body sections (in order): Summary · Validation · Tests · Notes — use "None." when a section is empty. State verifiable facts only. Do not cite the handbook to justify changes.

Allowed types: feat fix docs style refactor perf test build ci chore revert release.

CI and SHA Pins

Pin every GitHub Actions ref to a full commit SHA with an inline version comment:

uses: actions/checkout@abc123def456 # v4.1.0

The deterministic global pre-push security hook must not be bypassed (--no-verify requires explicit approval). Linting stays in CI; do not gate on it locally.

Repository Note

Docs-only repository. CI runs markdownlint and lychee; no build or test artifacts are produced. The required check context for branch protection is ci / ci — the job must be named literally ci / ci to emit that exact context string. Do not rename the job without updating the ruleset.