docs: refresh context files and add project URLS
This commit is contained in:
@@ -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>`.
|
||||
|
||||
Reference in New Issue
Block a user