Euri-Linux/euri-iso
2
1
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases 4 Wiki Activity

docs: add ALWAYS VERIFY AGAINST THE SOURCE reminder to Critical Gotchas

Browse Source 
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
This commit is contained in:
c-ludenberg
2026-08-06 20:23:57 +02:00
parent 6219c3a8cf
commit 13a48a7d77
1 changed files with 14 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+14
View File
@@ -35,6 +35,20 @@ Without passphrase is allowed for now, but prepare to encrypt it one day 0_0 —
## Critical Gotchas (Read Before Editing) ## 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/<module>/`)
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 ### CMAKE_DISTRIBUTION_NAME is a no-op
Calamares completely ignores `-DCMAKE_DISTRIBUTION_NAME`. The "for <distro>" text in the about dialog comes from `versionedName` in the **active branding component** at runtime. Do NOT add this flag to the calamares PKGBUILD. Calamares completely ignores `-DCMAKE_DISTRIBUTION_NAME`. The "for <distro>" text in the about dialog comes from `versionedName` in the **active branding component** at runtime. Do NOT add this flag to the calamares PKGBUILD.