engineering-standards
Team engineering standards for developers and AI agents: source control and branching, code review, testing, backend and frontend implementation, agent development, and the standards adoption process.
Part of the Slight76 standards handbooks indexed at standards-marketplace. Written for a small team and its AI agents.
Documents
| Document | Covers | Rule prefixes |
|---|---|---|
| source-control-and-branching | main/develop, prefixed work branches, Conventional Commits, squash and --no-ff merges, SemVer tags, PR size, branch protection | SCM |
| code-review-checklist | Author and reviewer responsibilities, review checklist, turnaround targets, reviewing agent-authored PRs | REV |
| testing-standard | Test at the boundary that proves the claim, determinism and isolation, negative cases, commands and evidence | TEST |
| backend-implementation-standard | ASP.NET Core project layout, dependency matrix, use-case transactions, lifetimes, async and cancellation, DTO boundaries | BE |
| frontend-implementation-standard | React/TypeScript feature layout, import matrix, state ownership, strict typing, API adapters | FE |
| agent-development-standard | Retrieval order, implementation loop, evidence semantics, drift recovery, handoff records for coding agents | AGT |
| adoption-process | Normative language, baseline pinning, exceptions and precedence, manifest and evidence files | — |
| engineering-fundamentals-checklist | One-page checklist linking every handbook's fundamentals for a repository or release | — |
| developer-inner-loop | Local setup, devcontainer, standard dotnet/npm verbs, pre-commit hooks, running tests locally, fast feedback | — |
| dev-lifecycle | Stub: idea-to-production lifecycle outline (to be authored) | — |
Read by task
See skills/engineering-standards/SKILL.md.
Install as an agent skill
| Agent | Command |
|---|---|
| Copilot CLI | copilot plugin marketplace add Slight76/standards-marketplace then copilot plugin install engineering-standards@slight76-standards |
| GitHub CLI (any agent) | gh skill install Slight76/engineering-standards engineering-standards --scope user --pin v1.0.0 |
| Claude Code | /plugin marketplace add Slight76/standards-marketplace then /plugin install engineering-standards@slight76-standards |
Layout
| Path | Purpose |
|---|---|
docs/ | Standards documents (frontmatter, applies-when, rule table) |
catalog/catalog.json | Machine-readable rules; externalDecisions points at historic ADRs |
adr/ | Decisions local to this handbook |
skills/engineering-standards/ | Agent skill and references |
CHANGELOG.md | Release history, including documents moved from architecture-standards |
Validation: py ../standards-marketplace/tooling/validate.py --root .. License: MIT.