Your Name
cf36780c0f
- AGENT_Context opens with a generated Document Map (section → line ranges) - gen-docs.sh: new gen_docmap block, self-referential (converges to a fixed point so line numbers stay accurate) - new '## 8. Entertainment Module' section (CLI, lib, plugins, config, scheduler, pointers); renumber following sections 8-13 -> 9-14 - AGENTS.md: reference the Document Map; document the make check/gen gate
1.5 KiB
1.5 KiB
Linux_post_install — Agent Instructions
Personal bootstrap & homelab toolkit for Debian/Ubuntu (Bash). install.sh bootstraps a machine; bin/pos is the unified CLI.
External File Loading
CRITICAL: real guidance lives in DOC/. When you encounter a reference below, use your Read tool to load it on a need-to-know basis — do NOT preemptively load all of them. Once loaded, treat the content as mandatory instructions.
- @DOC/AGENT_Context_Project.md — project overview, directory structure,
posdispatch table, "How to modify" table. Read FIRST for any non-trivial task. It opens with a Document Map (auto-generated line ranges for every section) — use it to jump straight to the relevant section. - @DOC/DEV.md — conventions, verification, and the "Adding a new Feature/App/Tool" checklists. Read before creating or changing code/docs.
- @DOC/POS.md —
posCLI reference (dispatcher + every command). Read when working onbin/pos*scripts or their docs. - @DOC/README.md — index of all docs. Read to find the right doc.
Quick facts
- Each tool is
bin/pos-<category>-<command>;bin/posdispatches via smart arg matching; bash completion derives from filenames. - Verify edits with
make check(runsbash -n+ the generated-doc sync gate). Generated sections (dispatch table, file table, line counts, completion flags, this doc's Document Map) are code-derived — after changingbin/pos-*,lib/*, orcompletions/, runmake genand commit the refreshed output.