diff options
Diffstat (limited to 'AGENTS.md')
| -rw-r--r-- | AGENTS.md | 11 |
1 files changed, 6 insertions, 5 deletions
@@ -10,8 +10,9 @@ Two programs: the GUI (`sb_builder/`, PyQt6 incl. QtDBus, stdlib otherwise) and `remote/sbb-remote`, a single-file stdlib-only Python helper deployed on the VM. Do not add third-party dependencies to either. -Design and phasing: `docs/superpowers/specs/`. Phase 1 (core) is -`2026-10-19-sb-builder-phase1-design.md`. +Design and phasing: `docs/design/`, one spec per phase. Phase 1 (core) is +`2026-10-19-sb-builder-phase1-design.md`. New specs go there; implementation +plans are working files, kept out of git (`.superpowers/`). ## How it works @@ -31,7 +32,7 @@ Design and phasing: `docs/superpowers/specs/`. Phase 1 (core) is `stdin=DEVNULL`, so nothing can read the passphrase off the ssh channel. Never put the passphrase in argv, env, logs or files. - Hints are parsed (`shlex`), never sourced. `sb_builder/hints.py` mirrors - slackrepo's own rules (`../GITHUB/slackrepo/libexec/functions.d/parsefunctions.sh`); + slackrepo's own rules (`libexec/functions.d/parsefunctions.sh` in [slackrepo](https://github.com/aclemons/slackrepo)); check that file when changing it. - Hint editing lives in the helper (`hint-update`, `hint-new`, `fix-current` jobs run the helper's own `_hint` command): text edits, `.bak` before each @@ -48,7 +49,7 @@ Design and phasing: `docs/superpowers/specs/`. Phase 1 (core) is ## UI guidelines -Every tab follows these (design: `docs/superpowers/specs/2026-10-20-sb-builder-ui-design.md`). +Every tab follows these (design: `docs/design/2026-10-20-sb-builder-ui-design.md`). 1. Tabs are permanent and load their data lazily on first show (`loaded`, `reload()`); the ribbon never opens or closes tabs. @@ -98,4 +99,4 @@ at a config whose `state_dir` is under `/tmp`. - License: GPLv2 only (`LICENSE`, header in each source file). - Work directly on master. -- `.superpowers/` is brainstorming scratch, ignored. +- `.superpowers/` is brainstorming and plan scratch, ignored. |