From 13a48a7d77e597fc23c1df17b71f877a1768b9be Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82?= Date: Thu, 6 Aug 2026 20:23:57 +0200 Subject: [PATCH] docs: add ALWAYS VERIFY AGAINST THE SOURCE reminder to Critical Gotchas Adds a warning to check authoritative Calamares source before asserting config schemas/formats, with a note that it's aimed at OpenCode agents (adapt the tool name for others). Prevents the 2026 packagechooser/ netinstall eyeball mistake --- AGENTS.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 54c89cb..51d80d7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -35,6 +35,20 @@ Without passphrase is allowed for now, but prepare to encrypt it one day 0_0 — ## Critical Gotchas (Read Before Editing) +### ALWAYS VERIFY AGAINST THE SOURCE, NEVER GUESS +> Note: this section is written for OpenCode agents. If you're a different +> agent whose tools have other names, adapt accordingly — the principle +> stands: fetch/read the authoritative source, never guess. + +Before asserting how any Calamares module config (or any format this repo +relies on) works, **check the authoritative source** — the Calamares repo +(`https://codeberg.org/calamares/calamares/raw/branch/calamares/src/modules//`) +or the project's docs, using whatever web-fetch tool is available first. +Cloning is a LAST RESORT — only if web lookup fails 3 times. Do not rely on +memory or "it looks right" for config schemas, keys, or formats. The 2026 +lesson: packagechooser/netinstall config was eyeballed instead of verified +against the `packagechooser.conf` / `netinstall.conf` source files. + ### CMAKE_DISTRIBUTION_NAME is a no-op Calamares completely ignores `-DCMAKE_DISTRIBUTION_NAME`. The "for " text in the about dialog comes from `versionedName` in the **active branding component** at runtime. Do NOT add this flag to the calamares PKGBUILD.