Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,19 @@

---

## [4.0.0](https://github.com/gerfru/dev-best-practices/compare/v3.0.0...v4.0.0) (2026-06-13)


Check failure on line 10 in CHANGELOG.md

View workflow job for this annotation

GitHub Actions / Lint

Multiple consecutive blank lines

CHANGELOG.md:10 MD012/no-multiple-blanks Multiple consecutive blank lines [Expected: 1; Actual: 2] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md012.md
### ⚠ BREAKING CHANGES

* plugin version bumped to v3.0.0

### Features

* add design-public skill ([#25](https://github.com/gerfru/dev-best-practices/issues/25)) ([8bfc30d](https://github.com/gerfru/dev-best-practices/commit/8bfc30df32a6db2ecabb6af885396da8dfcefa0f))
* add public skill references and bump plugin to v3.0.0 ([#26](https://github.com/gerfru/dev-best-practices/issues/26)) ([013d49d](https://github.com/gerfru/dev-best-practices/commit/013d49d0a64ff6568d37a5b1e45a78ee5c5da2f1))
* add review-public skill ([#24](https://github.com/gerfru/dev-best-practices/issues/24)) ([8babe8a](https://github.com/gerfru/dev-best-practices/commit/8babe8a3975aeac7e8f1ad212aa9826b77b4edf3))

## [Unreleased]

---
Expand All @@ -13,19 +26,19 @@

### Added

- `design-iac`: Infrastructure as Code design grounded in Kief Morris "Infrastructure as Code" (O'Reilly 2021) and NTNU IIKG3005 β€” IaC principles (immutable infra, idempotency, snowflake anti-pattern), module design, remote state management, drift detection and remediation, GitOps workflow, IaC testing (3 reference files)

Check failure on line 29 in CHANGELOG.md

View workflow job for this annotation

GitHub Actions / Lint

Unordered list style

CHANGELOG.md:29:1 MD004/ul-style Unordered list style [Expected: asterisk; Actual: dash] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md004.md
- `tool-perf`: Performance engineering grounded in MIT 6.172 (Leiserson/Shun, Bentley Rules) and Brendan Gregg "Systems Performance" (USE Method, flamegraphs) β€” USE Method resource checklist, profiling tool selection by stack, flamegraph reading guide, Bentley Rules (5 categories), before/after benchmark workflow (3 reference files)

Check failure on line 30 in CHANGELOG.md

View workflow job for this annotation

GitHub Actions / Lint

Unordered list style

CHANGELOG.md:30:1 MD004/ul-style Unordered list style [Expected: asterisk; Actual: dash] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md004.md
- `design-migration` β€” schema evolution: Added Kleppmann "Designing Data-Intensive Applications" Kap. 4+11 coverage β€” Forward/Backward Compatibility rules, Dual-Write problem and solutions, Change Data Capture (CDC/Debezium), Avro Schema Registry, Expand-Contract pattern; new `references/schema-evolution.md`

Check failure on line 31 in CHANGELOG.md

View workflow job for this annotation

GitHub Actions / Lint

Unordered list style

CHANGELOG.md:31:1 MD004/ul-style Unordered list style [Expected: asterisk; Actual: dash] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md004.md
- plugin.json: 22 β†’ 24 skills, v1.2.0 β†’ v2.0.0; meta-help renumbered 1–24

Check failure on line 32 in CHANGELOG.md

View workflow job for this annotation

GitHub Actions / Lint

Unordered list style

CHANGELOG.md:32:1 MD004/ul-style Unordered list style [Expected: asterisk; Actual: dash] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md004.md
- `docs/skill-research-basis.md`: new reference document β€” academic & industry sources per skill (replaces work-in-progress `docs/academic-basis.md`)

Check failure on line 33 in CHANGELOG.md

View workflow job for this annotation

GitHub Actions / Lint

Unordered list style

CHANGELOG.md:33:1 MD004/ul-style Unordered list style [Expected: asterisk; Actual: dash] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md004.md
- CLAUDE.md: updated to reflect full plugin structure (24 skills, docs/ directory, plugin install command)

Check failure on line 34 in CHANGELOG.md

View workflow job for this annotation

GitHub Actions / Lint

Unordered list style

CHANGELOG.md:34:1 MD004/ul-style Unordered list style [Expected: asterisk; Actual: dash] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md004.md

### Removed

- `docs/gap-analysis.md`: all items resolved β€” content lives in Git history

Check failure on line 38 in CHANGELOG.md

View workflow job for this annotation

GitHub Actions / Lint

Unordered list style

CHANGELOG.md:38:1 MD004/ul-style Unordered list style [Expected: asterisk; Actual: dash] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md004.md
- `docs/academic-basis.md`: replaced by `docs/skill-research-basis.md`

Check failure on line 39 in CHANGELOG.md

View workflow job for this annotation

GitHub Actions / Lint

Unordered list style

CHANGELOG.md:39:1 MD004/ul-style Unordered list style [Expected: asterisk; Actual: dash] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md004.md

- `design-observability`: Observability architecture skill grounded in Google SRE Books (Beyer et al.) and Observability Engineering (Majors/Fong-Jones) β€” SLO/SLI/Error-Budget, Golden Signals, OpenTelemetry tracing, Burn Rate alerting, Incident Response + blameless postmortem (4 reference files)

Check failure on line 41 in CHANGELOG.md

View workflow job for this annotation

GitHub Actions / Lint

Unordered list style

CHANGELOG.md:41:1 MD004/ul-style Unordered list style [Expected: asterisk; Actual: dash] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md004.md
- `design-cicd`: CI/CD pipeline design grounded in "Accelerate" (Forsgren/Humble/Kim) and "Continuous Delivery" (Humble/Farley) β€” pipeline architecture, Blue-Green/Canary/Feature Flags decision tree, DORA metrics with benchmarks, Trunk-Based Development (3 reference files)
- `tool-a11y`: Accessibility audit grounded in WCAG 2.2 (W3C) and CMU HCII 05-332 β€” axe-core/Lighthouse, keyboard navigation, NVDA/VoiceOver screen reader testing, all 9 new WCAG 2.2 SC, EU Accessibility Act / BFSG / EN 301 549 compliance (3 reference files)
- `design-llm` + `review-llm`: LLM system design and audit grounded in Stanford CS224N, CMU 11-667 and Berkeley CS294-196 β€” RAG, fine-tuning, agents, evals, OWASP LLM Top 10, prompt injection (PR #14)
Expand Down
Loading