From 11cf5aa0cf77ddadc208a5cbea8d97f788730292 Mon Sep 17 00:00:00 2001
From: Padreug <padreug@aiolabs.dev>
Date: Sat, 20 Jun 2026 09:50:39 +0200
Subject: [PATCH] docs(claude): drop the deleted `dev up` CLI from seeded
 orientation files
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The matured dev-env backport removed dev.sh (which provided
`dev up/down/logs/shell`) but the seeded CLAUDE.md files still told
users — and Claude sessions, since these symlink into ~/dev/ — to run
those commands. `dev` is now just a nav function (cd $DEV_ROOT), so
`dev up` silently cd'd and started nothing.

Rewrite both Quick-commands / Default-dev-workflow sections to the real
command set (lb/prb/dev-status/regtest-start/dev-deploy) and document
that FakeWallet startup is manual — there is no `dev up` wrapper.
---
 files/dev-CLAUDE.md    | 31 ++++++++++++++++++++++++-------
 files/lnbits-CLAUDE.md | 14 ++++++++++++--
 2 files changed, 36 insertions(+), 9 deletions(-)

diff --git a/files/dev-CLAUDE.md b/files/dev-CLAUDE.md
index 6b2f150..9e3a5cd 100644
--- a/files/dev-CLAUDE.md
+++ b/files/dev-CLAUDE.md
@@ -26,13 +26,30 @@ PR contract in `upstream-prs/`. See the lnbits-sensei README's
 
 ## Quick commands
 
-- `dev up [--fakewallet|--regtest]` — start the lnbits dev server.
-  Default `--fakewallet` is instant, no docker, good for
-  extension/UI/API work.
-- `dev down` / `dev logs` / `dev shell` — control / inspect.
-- *(planned)* `prb <repo> <branch>` — create a PR worktree branched
-  from `upstream/main` under `~/dev/upstream-prs/`.
-- *(planned)* `lb <worktree>` — cd shortcut into `~/dev/lnbits/<worktree>`.
+Installed by lnbits-sensei's dev-env module — standalone binaries plus
+shell functions sourced into interactive shells:
+
+- `dev-env-bootstrap` — materialize bare repos + worktrees from your
+  declared `projects` (idempotent; `--dry-run` to preview).
+- `lb <worktree>` — cd into `~/dev/lnbits/<worktree>` (e.g. `lb dev`).
+  `g <category> <repo>`, `ext <name>`, `prs`, `shared`, `repos` cover
+  the rest of the tree.
+- `prb <repo> <branch>` — create a PR worktree branched from
+  `upstream/main` under `~/dev/upstream-prs/`; `prc` cleans up, `prl`
+  lists.
+- `dev-status` — dirty + ahead/behind across every worktree. `wts` /
+  `wtu` sync worktrees / fetch upstream; `rebase status` shows which
+  forks need rebasing onto upstream.
+- `regtest-start <worktree>` / `regtest-stop` — Bitcoin/Lightning
+  regtest stack (only when `devEnv.regtest.enable = true`; needs docker).
+- `dev-deploy <host>` — `nixos-rebuild` against your deploy flake.
+  `dev-tm <session>` — launch a declarative tmux session.
+
+**Starting lnbits for iteration:** there is no `dev up` wrapper.
+FakeWallet (`LNBITS_BACKEND_WALLET_CLASS=FakeWallet`) is the default
+path — no docker; run lnbits directly from the worktree (`lb dev`, then
+lnbits's own run command). Use `regtest-start` only when you need real
+channels/payments.
 
 ## Reference docs
 
diff --git a/files/lnbits-CLAUDE.md b/files/lnbits-CLAUDE.md
index a091104..2f5d5e8 100644
--- a/files/lnbits-CLAUDE.md
+++ b/files/lnbits-CLAUDE.md
@@ -70,9 +70,19 @@ Full reference: `docs/lnbits-upstream-flow.md`.
 
 ## Default dev workflow
 
+There is no `dev up` wrapper. Start lnbits directly from a worktree:
+
 ```
-dev up                  # FakeWallet, instant
-dev up --regtest        # multi-node regtest (slower boot, real channels)
+lb dev                  # cd ~/dev/lnbits/dev
+LNBITS_BACKEND_WALLET_CLASS=FakeWallet <lnbits run command>   # instant, no docker
+```
+
+For real channels/payments, use the regtest stack (gated on
+`devEnv.regtest.enable`; needs docker):
+
+```
+regtest-start dev       # build lnbits from ~/dev/lnbits/dev, bring the stack up
+regtest-stop
 ```
 
 Use **FakeWallet** for extension CRUD / UI / API work. Spin up