Dev Playbook

Changelog

All notable changes to Dev Playbook.

All notable changes to this playbook will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.1.1 (2026-04-07)

Bug Fixes

  • exclude CHANGELOG.md from markdownlint CI (97214e4)

1.1.0 (2026-04-07)

Features

  • add 12 new guides — code review, API design, testing, logging, docker, incidents, and more (bd43392)
  • add open-source infrastructure and 7 new convention guides (c739cfc)
  • add PR review outcomes flow (approve, comment, decline) (71fc964)
  • initialize dev-playbook with full development standards (11adf4b)

Bug Fixes

  • correct relative path to CONTRIBUTING.md in PR template (a1a1f72)
  • replace angle-bracket URL with plain text for MDX compatibility (8791153)
  • resolve 145 markdownlint errors across all docs (5e4d5a4)
  • resolve broken links and lint errors from review feedback (0a6343a)

[1.0.0] - 2025-03-16

Added

  • Process guides: branching, commits, issues, pull requests, code review, CI/CD, board workflow, incident response, dependency management
  • Convention guides: .NET, Next.js, Python, naming, API design, API error format, testing, logging, Docker, git hooks, observability, environment management, documentation, error handling, performance, accessibility, i18n
  • Architecture guides: ADR, database, security, multi-tenancy
  • Checklists: new project setup, onboarding, pre-merge, release, security audit
  • Templates: feature issue, bug issue, PR template, CLAUDE.md starter
  • Open-source infrastructure: LICENSE (MIT), CONTRIBUTING.md, CODE_OF_CONDUCT.md
  • GitHub integration: issue templates (YAML), PR template, CI workflow (markdown lint + link check)
  • Standard label set: labels.yml with type, priority, status categories

On this page