diff --git a/.cspell.config.yaml b/.cspell.config.yaml
index e579815..eead26d 100644
--- a/.cspell.config.yaml
+++ b/.cspell.config.yaml
@@ -13,6 +13,10 @@ words:
   - alice
   - anubis
   - asciidoctor
+  - baseof
+  - gitea
+  - Gitea
+  - hreflang
   - bioinformaticians
   - bioinformatics
   - Clonezilla
diff --git a/AGENTS.md b/AGENTS.md
index 938c653..aa9feb4 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -2,15 +2,27 @@
 
 ## Project
 
-Hugo blog (multilingual EN + PT-BR) using the **anubis2** theme as a git submodule (`themes/anubis2`, v1.6.0). Deployed via rsync to a VPS.
+Hugo blog (multilingual EN + PT-BR) using the **anubis2** theme as a git submodule (`themes/anubis2`, v1.6.0).
+
+## Repository
+
+- Primary: `ssh://git@git.thanwer.com:2222/thanwer/blog.git` (self-hosted Gitea)
+- GitHub mirror is being retired; if you still see `origin` pointing at GitHub it's intentionally kept for transition.
+
+## Deploy
+
+Pushes to `main` trigger `.gitea/workflows/deploy.yml` on the shinobi gitea-runner: it builds Hugo and writes directly into the host's `/srv/www/blog` via a bind-mounted volume — Caddy on the same host serves from there. No SSH/rsync round-trip.
+
+`deploy.sh` (legacy rsync-from-laptop) is kept as a manual fallback only.
 
 ## Commands
 
 ```bash
 hugo server                # dev server at localhost:1313
 hugo                       # build to ./public/ (no minify)
-./deploy.sh                # pre-commit → hugo --minify → rsync
+git push                   # → triggers Gitea Actions deploy
 pre-commit run --all-files # quality check (lint, spell, links)
+./deploy.sh                # fallback: pre-commit → hugo --minify → rsync from laptop
 ```
 
 ## Quality toolchain
@@ -36,8 +48,8 @@ All quality tooling must pass before deploy. No separate test framework.
 - Theme requires **all lowercase keys** under `params.anubis2`: `colortheme`, `enablecolorthemeswitcher`, `readnextposts`, `socialicons`, etc. See `themes/anubis2/PARAMS.md`.
 - `[params.anubis2.services.umami]` keys are lowercase: `id`, `url`.
 - Analytics inject only in production (`hugo.IsProduction`). Test locally: `hugo server --environment production`.
-- Config uses modern Hugo keys: `locale` (not `languageCode`), `label` (not `languageName`).
-- `enableGitInfo = true` — `.Lastmod` derives from git; template prefers `.Params.lastmod` when set.
+- Per-language `locale` and `label` are **deprecated custom params** at the language top level (deprecated in Hugo 0.112, will be removed). Modern canonical keys are `languageCode` and `languageName`. Current `hugo.toml` still uses the old form for historical reasons — Hugo emits a warning at build time but still honours them. Migrate at some point.
+- `enableGitInfo = true` — `.Lastmod` derives from git; template prefers `.Params.lastmod` when set. The Gitea deploy workflow uses `fetch-depth: 0` so the runner has the full history.
 
 ## Frontmatter reference
 
@@ -50,13 +62,27 @@ tags = ["tag1", "tag2"]
 canonical = "/posts/original-post"   # PT translations only
 ```
 
-## Deprecated keys (avoid)
+## Hugo template fields — what works in 0.151+
 
-- `languageCode` → `locale`; `languageName` → `label`; `.Site.LanguageCode` → `.Site.Language.Locale`
+These template fields were **removed** in Hugo 0.123 / 0.124 and broke on the first CI run after migration. Use the replacements:
+
+| Removed | Use instead |
+| --- | --- |
+| `site.Locale`, `site.Language.Locale` | `site.LanguageCode` |
+| `.Language.Label` (display name) | `.Language.LanguageName` |
+| `.Language.Label` (in `hreflang`) | `.Language.LanguageCode` |
+| `hugo.Data.*` (theme data files) | `site.Data.*` |
+
+`hugo.<field>` is for build info only (`hugo.Version`, `hugo.IsProduction`, `hugo.CommitHash`); it never had a `.Data` namespace — the theme had a bug.
 
 ## Theme overrides (`layouts/` shadows theme)
 
+- `layouts/_default/baseof.html` — patched to use `site.LanguageCode` instead of removed `site.Language.Locale`
+- `layouts/_default/sitemap.xml` — `hreflang` uses `.Language.LanguageCode`
+- `layouts/_default/rss.xml` — `<language>` uses `.Site.LanguageCode`
 - `layouts/partials/head.html` — canonical from `Params.canonical`, Umami analytics (prod only)
+- `layouts/partials/head/social-icons.html` — fixes theme bug: `hugo.Data` → `site.Data`
+- `layouts/partials/language-switcher.html` — `.Language.LanguageName` for display
 - `layouts/partials/post-info.html` — prefers `.Params.lastmod`, shows "[Last modified]" when different from date
 - `layouts/partials/footer-extra.html` — Ko-fi widget
 - `layouts/robots.txt` — custom sitemap for both languages