From 677b8c7c2716737a77513af0c1ef5e4fe6469d03 Mon Sep 17 00:00:00 2001
From: Padreug <padreug@aiolabs.dev>
Date: Sun, 24 May 2026 19:21:12 +0200
Subject: [PATCH] chore: scaffold repo skeleton

Empty placeholder commit anchoring the repo. Substantive scaffolding
(flake.nix, modules/, settings.nix) lands in follow-ups iterated under
the sandboxed-claude policy.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .gitignore | 15 +++++++++++++++
 README.md  | 44 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 59 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 README.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..695aa96
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,15 @@
+# Sandboxed-claude runtime config (bootstrapped per launch — not for commit)
+.claude/
+
+# Nix build outputs
+result
+result-*
+
+# direnv
+.direnv/
+
+# Editor scratch
+*~
+.#*
+*.swp
+*.swo
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a22dbbe
--- /dev/null
+++ b/README.md
@@ -0,0 +1,44 @@
+# lnbits-sensei
+
+> **Status:** scaffold in progress. Not yet usable.
+
+Opinionated, bare-skeleton scaffold for running an LNbits stack
+— inspired by the [omnixy](https://github.com/TheArctesian/omnixy)
+NixOS module pattern but stripped of any personal identity so the
+template is consumable as-is.
+
+The goal: clone, fill in your identity + remote topology (upstream
+only / github fork / extra private remote on gitea, forgejo,
+codeberg, …), and get a working LNbits dev environment with either:
+
+- **FakeWallet** — no docker, no chains, nothing to start. Fast
+  iteration on extensions and frontend work.
+- **Full regtest** — multi-node LND + CLN + Eclair stack with
+  bitcoind, electrs, boltz, etc. For channel/payment integration
+  testing.
+
+## Planned shape
+
+- `flake.nix` — pins `lnbits/lnbits` upstream + dev tooling.
+- `settings.nix` — single source of truth (user, email, host, remote
+  topology). User fills in.
+- `modules/lnbits/` — opinionated LNbits NixOS module.
+- `modules/dev-env/` — worktree mgmt, navigation helpers, regtest
+  spin-up, fakewallet default, upstream-PR helper. Generalized off
+  any private-host assumptions.
+- `modules/git/remotes.nix` — abstract remote topology (`upstream`,
+  `fork`, optional `extras` list).
+
+## Development
+
+This repo is iterated on under the sandboxed-claude policy from
+[omnixy](https://github.com/TheArctesian/omnixy)'s
+`scripts/sandbox-claude.sh` — a per-launch `.claude/settings.json`
+that allows nix/git/inspection and hard-denies sudo, push/remote,
+container engines, etc. Substantive scaffolding work happens in that
+sandbox; promotion (`git push`) is done from the main shell after
+review.
+
+## License
+
+TBD — leaning MIT to match omnixy.