repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

docs: add extension startup principle

0e4e3ae122ce2ec86d10184114aeca18001f7c1a

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (1)

extensions/AGENTS.md

Modified
39 39 - Optional integration must be capability/event based and degrade cleanly.
40 40 - If behavior is important, provide a native fallback; decorative integration may no-op.
42 +## Startup
44 +- `session_start` must be fast.
45 +- No awaited network, git, FS scans, or subprocesses.
46 +- Publish minimal UI now; defer slow work with bg task + generation/stale guard.
47 +- Never block other extensions for telemetry, recovery, decoration, or cache warming.
42 49 ## Checks
44 51 - Source of truth: `justfile` → `scripts/extensions.py`.