repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

docs(agent): move agent guidance

e8a81152a44d416b5c3d333f08423863cda3764a

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (3)

pi/AGENTS.md

Deleted
deleted file mode 100644
1 -# Pi Extensions Workspace
3 -## New extension
5 -1. `extensions/{name}/package.json` — template below
6 -2. `extensions/{name}/index.ts`
7 -3. `bun install`
9 -## package.json
11 -```json
12 -{
13 - "name": "@bugabinga/pi-ext-{name}",
14 - "version": "0.0.0",
15 - "private": true,
16 - "type": "module",
17 - "main": "index.ts",
18 - "peerDependencies": {
19 - "@earendil-works/pi-coding-agent": "*"
20 - }
21 -}
22 -```
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.
28 -## Independence
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.
35 -## Publishing
37 -- Source of truth for release gates: `justfile` → `scripts/extensions.py`.
38 -- Run `just check [{name}]` before `npm publish`.
39 -- License is MIT.
41 -## Documentation
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.
48 -## Imports
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
55 - import
56 - from
57 - other
58 - extensions** |

pi/agent/AGENTS.md

Added
new file mode 100644
1 +SIMPLICITY!
2 +MINIMALSM!
3 +BRUTALISM!
5 +DEATH TO LEGACY/COMPAT/HEDGING!
6 +DEATH TO EDGE CASES! FOUND SOME? TELL ME.

pi/agent/extensions/AGENTS.md

Added
new file mode 100644
1 +# Pi Extensions Workspace
3 +## New extension
5 +1. `extensions/{name}/package.json` — template below
6 +2. `extensions/{name}/index.ts`
7 +3. `bun install`
9 +## package.json
11 +```json
13 + "name": "@bugabinga/pi-ext-{name}",
14 + "version": "0.0.0",
15 + "private": true,
16 + "type": "module",
17 + "main": "index.ts",
18 + "peerDependencies": {
19 + "@earendil-works/pi-coding-agent": "*"
20 + }
22 +```
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.
28 +## Independence
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.
35 +## Publishing
37 +- Source of truth for release gates: `justfile` → `scripts/extensions.py`.
38 +- Run `just check [{name}]` before `npm publish`.
39 +- License is MIT.
41 +## Documentation
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.
48 +## Imports
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
55 + import
56 + from
57 + other
58 + extensions** |