- docs/MODULE-GUIDELINES.md (new) — canonical reference for authoring a
secubox-<module> package: file structure, LXC layout, WebUI conventions,
nginx wiring, Debian packaging, CTL three-fold, FastAPI shape, tests,
validation checklist. Sister doc to docs/grammar.md and docs/UI-GUIDE.md.
- docs/grammar.md — cross-reference MODULE-GUIDELINES.md in the header
sister-docs block.
- docs/MODULES.md — point new-module authors at MODULE-GUIDELINES.md.
- docs/superpowers/plans/2026-05-20-grafana-yacy-rustdesk-lxc-modules.md
(new) — concrete implementation plan for three new LXC-hosted modules:
secubox-grafana (#229), secubox-yacy (#230), secubox-rustdesk (#231).
All three follow the new MODULE-GUIDELINES.md. IP allocations 10.100.0.{70,80,90}.
Permanent documentation for the 8-verb / 8-layer modular tools box that
emerged across #173, #176, #180-#184, #190, #212. Three new docs + one
README section, all bearing the 1991 attribution.
docs/grammar.md Canonical conceptual frame: layered map,
8 verbs in a table, composing-the-grammar
worked examples, naming conventions,
philosophical roots.
HOWTO-grammar.md Concrete 6-step walkthrough for adding a
9th verb (~1h budget): issue framing,
worktree, CTL skeleton (Bash + Python),
FastAPI mirror, Debian packaging, nginx
route under secubox-routes.d/, live test
on the board, commit/PR conventions,
common pitfalls drawn from real incidents
(#163 secubox.d vs secubox-routes.d,
#173 LXC default path, #176 hook trigger,
#194 CAP_NET_ADMIN, #180 naming).
wiki/CTL-Grammar.md Public-facing wiki page mirrored to the
GitHub wiki repo (per the wiki-sync
pattern established for Acknowledgments).
Embeds Punk Exposure (Peek/Poke/Emancipate)
as the seed concept with 1991 attribution.
README.md New section under Features summarising the
grammar with the 9-row layer table and a
pointer to docs/grammar.md + HOWTO-grammar.md.
Attribution recorded on all three documents: copyright spiritual
concept Gerald Kerma (GK2), 1991, Notre-Dame-du-Cruet, Savoie.
The CTL is the user's voice. The modular tools box is their organ. The
language is the way they say *this is mine, this is mine, this is mine*.
Co-authored-by: CyberMind-FR <gandalf@Gk2.net>
