# Dev Playbook

> An opinionated engineering playbook — conventions, architecture decisions, processes, and checklists for modern software teams. Every new project reads this repo first and follows these standards: no reinventing the wheel, no tribal knowledge. Plain markdown, version-controlled, MIT-licensed.

## Use

Point your AI agent at it from your project's CLAUDE.md:

```markdown
## Development Process
Follow the playbook at github.com/tansuasici/dev-playbook
Read process/ and conventions/ before starting work.
```

Source: https://devplaybook.tansuasici.com
Repository: https://github.com/tansuasici/dev-playbook

## Getting Started

- [Introduction](https://devplaybook.tansuasici.com/docs): Opinionated engineering playbook for modern software teams.
- [Contributing](https://devplaybook.tansuasici.com/docs/contributing): How to contribute to Dev Playbook.

## Architecture

- [Architecture Decision Records](https://devplaybook.tansuasici.com/docs/architecture/decisions): How we document and track architectural decisions.
- [Database Patterns](https://devplaybook.tansuasici.com/docs/architecture/database): Database design conventions and migration strategies.
- [Multi-Tenancy](https://devplaybook.tansuasici.com/docs/architecture/multi-tenancy): Multi-tenant architecture patterns and data isolation.
- [Security Architecture](https://devplaybook.tansuasici.com/docs/architecture/security): Security guidelines, threat modeling, and best practices.

## Conventions

- [Naming Conventions](https://devplaybook.tansuasici.com/docs/conventions/naming): Consistent naming across code, files, and infrastructure.
- [API Design](https://devplaybook.tansuasici.com/docs/conventions/api-design): RESTful API design principles and standards.
- [API Error Format](https://devplaybook.tansuasici.com/docs/conventions/api-error-format): Standardized error response format for APIs.
- [Error Handling](https://devplaybook.tansuasici.com/docs/conventions/error-handling): Exception handling patterns and error management strategies.
- [Logging](https://devplaybook.tansuasici.com/docs/conventions/logging): Structured logging standards and best practices.
- [Observability](https://devplaybook.tansuasici.com/docs/conventions/observability): Metrics, tracing, alerting, and health check standards.
- [Testing](https://devplaybook.tansuasici.com/docs/conventions/testing): Testing strategies, coverage goals, and test patterns.
- [Performance](https://devplaybook.tansuasici.com/docs/conventions/performance): Response time budgets, caching, and optimization patterns.
- [.NET Conventions](https://devplaybook.tansuasici.com/docs/conventions/dotnet): C# and .NET specific coding standards.
- [Next.js Conventions](https://devplaybook.tansuasici.com/docs/conventions/nextjs): Next.js and React specific patterns and standards.
- [Python Conventions](https://devplaybook.tansuasici.com/docs/conventions/python): Python coding standards and project structure.
- [Docker](https://devplaybook.tansuasici.com/docs/conventions/docker): Container standards, Dockerfile patterns, and compose conventions.
- [Git Hooks](https://devplaybook.tansuasici.com/docs/conventions/git-hooks): Pre-commit, commit-msg, and pre-push hook standards.
- [Documentation Standards](https://devplaybook.tansuasici.com/docs/conventions/documentation): README templates, API docs, and inline documentation rules.
- [Environment Management](https://devplaybook.tansuasici.com/docs/conventions/environment-management): Dev/staging/prod environment setup and feature flags.
- [Accessibility (a11y)](https://devplaybook.tansuasici.com/docs/conventions/accessibility): Web accessibility standards and WCAG compliance.
- [Internationalization (i18n)](https://devplaybook.tansuasici.com/docs/conventions/i18n): Internationalization and localization approach.

## Process

- [Branching Strategy](https://devplaybook.tansuasici.com/docs/process/branching): Git branching model and workflow.
- [Commit Conventions](https://devplaybook.tansuasici.com/docs/process/commits): Conventional commits and message format.
- [Pull Requests](https://devplaybook.tansuasici.com/docs/process/pull-requests): PR creation, review, and merge standards.
- [Code Review](https://devplaybook.tansuasici.com/docs/process/code-review): Code review guidelines and reviewer responsibilities.
- [CI/CD](https://devplaybook.tansuasici.com/docs/process/ci-cd): Continuous integration and deployment pipelines.
- [Issue Management](https://devplaybook.tansuasici.com/docs/process/issues): Issue creation, labeling, and triage process.
- [Board Workflow](https://devplaybook.tansuasici.com/docs/process/board-workflow): Project board columns and card lifecycle.
- [Incident Response](https://devplaybook.tansuasici.com/docs/process/incident-response): On-call, escalation, and post-mortem procedures.
- [Dependency Management](https://devplaybook.tansuasici.com/docs/process/dependency-management): Package updates, vulnerability scanning, and lockfile policy.

## Checklists

- [New Project Setup](https://devplaybook.tansuasici.com/docs/checklists/new-project-setup): Checklist for bootstrapping a new project.
- [Developer Onboarding](https://devplaybook.tansuasici.com/docs/checklists/onboarding): New team member onboarding checklist.
- [Pre-Merge Checklist](https://devplaybook.tansuasici.com/docs/checklists/pre-merge): Things to verify before merging a PR.
- [Release Checklist](https://devplaybook.tansuasici.com/docs/checklists/release): Release preparation and deployment steps.
- [Security Audit](https://devplaybook.tansuasici.com/docs/checklists/security-audit): Periodic security review checklist.

## Templates

- [CLAUDE.md Starter](https://devplaybook.tansuasici.com/docs/templates/claude-md-starter): Template for creating CLAUDE.md files.
- [Bug Report Template](https://devplaybook.tansuasici.com/docs/templates/issue-bug): GitHub issue template for bug reports.
- [Feature Request Template](https://devplaybook.tansuasici.com/docs/templates/issue-feature): GitHub issue template for feature requests.
- [Pull Request Template](https://devplaybook.tansuasici.com/docs/templates/pull-request): PR description template.

## Reference

- [Changelog](https://devplaybook.tansuasici.com/docs/changelog): All notable changes to Dev Playbook.

## Optional

- [Full content (llms-full.txt)](https://devplaybook.tansuasici.com/llms-full.txt): every page concatenated for single-shot ingestion