dotfiles
bugabingas dorkfiles
owned by bugabinga
docs(agent): move agent guidance
3949448c0a64022d7d94a3074f05ab1f1da8bbf0
Oliver Jan Krylow <oliver@bugabinga.net> ·
unsigned
Browse filesCompare with HEAD
Changed files (3)
deleted file mode 100644 1 -#
Pi Extensions Workspace 5 -1. `extensions/{name}/package.json` — template below
6 -2. `extensions/{name}/index.ts`
13 - "name":
"@bugabinga/pi-ext-{name}",
18 - "peerDependencies": {
19 - "@earendil-works/pi-coding-agent":
"*" 24 -Add only deps actually imported by the extension.
25 -Prefer `peerDependencies` for Pi packages (`@earendil-works/*`).
26 -Run `bun install` after any structural change.
30 -- Extensions must be standalone packages.
31 -- Never import from another `@bugabinga/pi-ext-*` package.
32 -- Optional integration must be capability/event based and degrade cleanly.
33 -- If behavior is important, provide a native fallback; decorative integration may no-op.
37 -- Source of truth for release gates: `justfile` → `scripts/extensions.py`.
38 -- Run `just check [{name}]` before `npm publish`.
43 -- READMEs must be terse.
44 -- Do not duplicate source-of-truth docs/config/API details.
45 -- Link to canonical source files, commands, settings, or upstream docs instead.
46 -- Package README should answer: what, install/load, commands/tools, settings link, optional integrations.
50 -| Package | Provides | Use |
51 -| ------------------------------- | ------------------------------------ | -------------------------------------- |
52 -| `@earendil-works/pi-coding-agent` | SDK — ExtensionAPI, types, ctx | Always (peer dep) |
53 -| `@earendil-works/pi-tui` | TUI components, truncateToWidth, Key | Rendering |
54 -| `@bugabinga/pi-ext-*` | — | **Never
new file mode 100644 5 +DEATH TO LEGACY/COMPAT/HEDGING!
6 +DEATH TO EDGE CASES! FOUND SOME? TELL ME.
pi/agent/extensions/AGENTS.md
Addednew file mode 100644 1 +#
Pi Extensions Workspace 5 +1. `extensions/{name}/package.json` — template below
6 +2. `extensions/{name}/index.ts`
13 + "name":
"@bugabinga/pi-ext-{name}",
18 + "peerDependencies": {
19 + "@earendil-works/pi-coding-agent":
"*" 24 +Add only deps actually imported by the extension.
25 +Prefer `peerDependencies` for Pi packages (`@earendil-works/*`).
26 +Run `bun install` after any structural change.
30 +- Extensions must be standalone packages.
31 +- Never import from another `@bugabinga/pi-ext-*` package.
32 +- Optional integration must be capability/event based and degrade cleanly.
33 +- If behavior is important, provide a native fallback; decorative integration may no-op.
37 +- Source of truth for release gates: `justfile` → `scripts/extensions.py`.
38 +- Run `just check [{name}]` before `npm publish`.
43 +- READMEs must be terse.
44 +- Do not duplicate source-of-truth docs/config/API details.
45 +- Link to canonical source files, commands, settings, or upstream docs instead.
46 +- Package README should answer: what, install/load, commands/tools, settings link, optional integrations.
50 +| Package | Provides | Use |
51 +| ------------------------------- | ------------------------------------ | -------------------------------------- |
52 +| `@earendil-works/pi-coding-agent` | SDK — ExtensionAPI, types, ctx | Always (peer dep) |
53 +| `@earendil-works/pi-tui` | TUI components, truncateToWidth, Key | Rendering |
54 +| `@bugabinga/pi-ext-*` | — | **Never