# Engineering Handbook

![Docs](https://img.shields.io/badge/Docs-Handbook-0c4f6f?logo=readthedocs&logoColor=white)
![Shell](https://img.shields.io/badge/Shell-121011?logo=gnu-bash&logoColor=white)
![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey?logo=creativecommons&logoColor=white)

Engineering conventions and best practices for Sea Haven Industries.

## Contents

- [Naming Conventions](naming-conventions.md) -- kebab-case everywhere, no exceptions
- [Development Environment](dev-environment.md) -- workstation directory layout, pyenv, Node, launchd/TCC
- [Issue Tracking](issue-tracking.md) -- Jira projects, ticket description template, ticket hygiene
- [Git Workflow](git-workflow.md) -- feature branches, incremental commits, merge to main then release for prod
- [Commit Messages](commit-messages.md) -- Conventional Commits, type(scope) format, explain "why"
- [Pull Requests](pull-requests.md) -- scope, title, description format, merge strategy
- [Code Review](code-review.md) -- what to look for, giving feedback, turnaround expectations
- [Code Review Rubric](code-review-rubric.md) -- BLOCK/FIX/NIT/QUESTION finding categories and output format
- [GitHub Standards](github-standards.md) -- branch defaults, repo hygiene, Environments
- [AWS Infrastructure](aws-infrastructure.md) -- HCP Terraform default, remaining SAM/CDK, Lambda defaults
- [HCP Terraform](hcp-terraform.md) -- workspaces, seam, SSM deploy contract, exec roles
- [Terraform Project Layout](terraform-project-layout.md) -- standard directory structure for HCP app repos
- [SAM Project Layout](sam-project-layout.md) -- remaining path for existing SAM stacks
- [CDK Project Layout](cdk-project-layout.md) -- remaining path for CDK and Bedrock
- [Lambda Starter Template](lambda-template.md) -- remaining SAM scaffold for a Python Lambda
- [Secrets and Configuration](secrets-and-config.md) -- Secrets Manager vs SSM Parameter Store
- [CI/CD Pipelines](cicd.md) -- HCP lane default, remaining SAM/CDK reusables
- [Bedrock](bedrock.md) -- cross-region inference profiles, alias pinning, KB Docker requirement
- [Git Hooks](hooks/) -- shim for the global security pre-push hook
- [Scripts](scripts/) -- repo provisioning, automation tooling
- [CDK Constructs](constructs/) -- shared VPN EC2 instance construct and other reusable patterns

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

This work is licensed under [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/). The commit messages section adapts content from [commit-messages-guide](https://github.com/RomuloOliveira/commit-messages-guide) by Romulo Oliveira, also licensed under CC-BY-4.0.