From 614056a2c85ddcfca63469ac129a18326e354bd3 Mon Sep 17 00:00:00 2001
From: Yanislav Igonin <yanislavdabest@gmail.com>
Date: Thu, 16 Jul 2026 16:26:27 +0400
Subject: [PATCH] docs: record Fiber v3 baseline

---
 AGENTS.md                                   |  7 ++++++-
 README.md                                   |  2 +-
 docs/superpowers/modernization-followups.md | 11 +++++++++++
 3 files changed, 18 insertions(+), 2 deletions(-)
 create mode 100644 docs/superpowers/modernization-followups.md

diff --git a/AGENTS.md b/AGENTS.md
index ad73f9b..3fbcac3 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -7,7 +7,7 @@ all claims with fresh commands.
 ## Project Overview
 
 micrach is a small, server-rendered, single-board imageboard. It uses Go,
-Fiber v2, Fiber HTML templates, PostgreSQL through `pgx`, and filesystem-backed
+Fiber v3, Fiber HTML templates, PostgreSQL through `pgx`, and filesystem-backed
 image uploads. It intentionally uses little browser-side JavaScript.
 
 The service supports thread creation, replies, JPEG/PNG attachments,
@@ -136,6 +136,11 @@ and prefer table-driven cases when practical. Repository tests must use
 disposable test data or a dedicated database, never a shared production
 database.
 
+Routine `go test ./...` must remain DB-free. Fiber handler and middleware tests
+must use in-memory apps and temporary directories; PostgreSQL-backed behavior
+belongs to the explicit manual smoke pass unless a later design approves an
+integration-test harness.
+
 Minimum verification for code changes:
 
 1. Run `go fmt ./...` and review the resulting diff.
diff --git a/README.md b/README.md
index 6c4c766..4520b4e 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,7 @@ provide; the source remains available for local use and development.
 ## Stack
 
 - Go 1.26
-- Fiber v2
+- Fiber v3
 - PostgreSQL 18 for local development
 - PostgreSQL access through [`pgx`](https://github.com/jackc/pgx)
 - Plain HTML templates and CSS
diff --git a/docs/superpowers/modernization-followups.md b/docs/superpowers/modernization-followups.md
new file mode 100644
index 0000000..2372205
--- /dev/null
+++ b/docs/superpowers/modernization-followups.md
@@ -0,0 +1,11 @@
+# Modernization Follow-ups
+
+Updated: 2026-07-16
+
+Wave 2 completed the confirmed Fiber v3 and template-engine major upgrades.
+The final direct-module, deprecated-API, `go vet`, and `govulncheck` audits found
+no remaining major-version or deprecated-API candidate requiring a scheduled
+follow-up.
+
+Recheck this file during the next deliberate dependency refresh. Do not add
+speculative architecture cleanup or ordinary patch/minor updates here.