Team Configurations

Shared configuration templates and settings used across the Platform Engineering team.

Shared CLAUDE.md template

Copy and customize this template for new repositories:

# [Project Name]

[One-line description]

## Tech stack

- [List primary technologies]

## Commands

- `[build command]` — Build the project
- `[test command]` — Run tests
- `[lint command]` — Lint check

## Conventions

- [List coding conventions specific to this project]

## Architecture

- [Describe key directories and their purpose]

Git commit conventions

When using AI tools to generate commits, ensure they follow our conventions:

  • Use conventional commit format: type(scope): description
  • Types: feat, fix, docs, refactor, test, chore
  • Keep the subject line under 72 characters
  • Include a body for non-trivial changes

PR description template

## Summary

[1-3 bullet points describing what changed and why]

## Test plan

- [ ] Unit tests pass
- [ ] Manual verification of [specific scenario]

Contributing a configuration

To add a new shared config:

  1. Create or update the relevant page in this section
  2. Include the full config with comments explaining each option
  3. Note which repositories or projects it applies to