docs: refresh context files and add project URLS

This commit is contained in:
Frank Schwenk
2026-10-01 20:23:20 +02:00
parent b9ad7f0c40
commit 9e9fbe7be2
8 changed files with 509 additions and 231 deletions
+45
View File
@@ -16,6 +16,7 @@ Operational context for Fränky's environments. Read with `AGENTS.md`.
| Server app paths | `/home/frank/<domain>/` (e.g. `/home/frank/schwenk.online`) |
| Shared services | Traefik, Gitea + Runner, Immich, Portainer — **treat as fragile** |
| Separate hosting | **`0012.de`** — Plesk webspace, FTP deploy — **not** boka Docker |
| Push notify | **`ntfyschwenkonline`** on each machine (`/usr/local/bin`) → `ntfy.schwenk.online`, topic = hostname |
---
@@ -94,3 +95,47 @@ Do not casually change or restart:
- Portainer
See `BOUNDARIES.md` for hard limits on `docker compose down` and config edits.
---
## Project-local overrides
Global paths live here. **Machine- and project-specific** details belong in project `SOUL.md`; **URLs** (prod, staging, repo, docs) in project **`URLS.md`**:
- App workdirs (`~/.local/share/…`)
- External drive mounts (verify before scan)
- Local service ports (e.g. local Immich vs. Immich on `boka`)
- Multi-stack repo layout (CLI core vs. `compose.yaml` experiments)
Template for project `SOUL.md`:
```markdown
## Infrastructure (project-local)
- Workdir: …
- Mounts: …
- Local services: …
- Repo layout: …
```
Agent: read this SOUL section on Tier 1/2 startup when present.
---
## Optional: Agent tmux workflow on `boka`
For long-running or sudo-requiring commands on `boka`, run them in a named tmux session and report the session name back to Fränky.
```bash
# Agent: create/reuse session, run command inside
tmux new-session -d -s boka-ops
tmux send-keys -t boka-ops "sudo <cmd>" Enter
# Agent reports: "session boka-ops, sudo password needed"
# Fränky: ssh frank-schwenk.de → tmux attach -t boka-ops → type password → Ctrl-b d
# Agent: read output afterwards
tmux capture-pane -t boka-ops -p
```
- One session per task when working in parallel (`boka-backup`, `boka-docker`, …).
- Agent kills finished sessions: `tmux kill-session -t <name>`.