diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..86462d1 --- /dev/null +++ b/.gitignore @@ -0,0 +1,13 @@ +# admin is a meta-project — .wiki/ and .tasks/ are tracked here despite the +# global ignore rule in ~/.config/git/ignore (which excludes them by default +# for business app repos). +!.wiki/ +!.tasks/ + +# OS / editor noise +.DS_Store +Thumbs.db +*.swp +*~ +.vscode/ +.idea/ diff --git a/.tasks/STATUS.md b/.tasks/STATUS.md new file mode 100644 index 0000000..df60f02 --- /dev/null +++ b/.tasks/STATUS.md @@ -0,0 +1,11 @@ +# Admin Task Board +_Updated: 2026-05-21_ + + diff --git a/.wiki/CLAUDE.md b/.wiki/CLAUDE.md new file mode 100644 index 0000000..8275764 --- /dev/null +++ b/.wiki/CLAUDE.md @@ -0,0 +1,16 @@ +# .wiki/ — Karpathy LLM Wiki + +Curated knowledge base. Structure: + +- `entities/.md` — physical/logical assets (hosts, NAS, VDS, router, recovery-VM) +- `concepts/.md` — patterns, root-cause analyses, recipes, postmortems +- `packages/.md` — third-party / first-party software packages relevant to this stack +- `sources/.md` — chronologies, session traces, primary records +- `raw/` — immutable external clippings (transcripts, screenshots, vendor docs) +- `index.md` — catalog of all pages +- `log.md` — op-log of ingest / promote / lint operations +- `overview.md` — high-level project orientation + +## Domain conventions + +(seeded by `[admin-infra-project-pointers]` task — see `.tasks/STATUS.md`) diff --git a/.wiki/concepts/.gitkeep b/.wiki/concepts/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.wiki/entities/.gitkeep b/.wiki/entities/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.wiki/index.md b/.wiki/index.md new file mode 100644 index 0000000..37543c1 --- /dev/null +++ b/.wiki/index.md @@ -0,0 +1,23 @@ +# Wiki Index + +Catalog of all wiki pages. One line per page, organized by type. Updated on every ingest / new page. + +## Overview + +- [overview.md](overview.md) — project overview + +## Entities + + + +## Concepts + + + +## Packages + + + +## Sources + + diff --git a/.wiki/log.md b/.wiki/log.md new file mode 100644 index 0000000..e67044d --- /dev/null +++ b/.wiki/log.md @@ -0,0 +1,7 @@ +# Wiki op-log + +Append-only log of wiki operations (ingests, promotions, lints, migrations). + +## 2026-05-21 + +- bootstrap: empty wiki skeleton (CLAUDE.md, index.md, log.md, overview.md, raw/README.md) committed diff --git a/.wiki/overview.md b/.wiki/overview.md new file mode 100644 index 0000000..1413601 --- /dev/null +++ b/.wiki/overview.md @@ -0,0 +1,25 @@ +# admin — infrastructure agenda + +Operational + roadmap workspace for personal-and-client infrastructure stack: + +- **VDS** (`vds.kzntsv.site`, Rusonyx) — gitea, verdaccio, registry, shared DB park, ntfy, traefik+portainer +- **NAS** (`kreknin`, Synology DSM) — backup target, Hyper Backup repo, secondary services +- **Windows recovery host** — current CMS prod host (IIS + traefik + docker), to be replaced as part of fault-tolerance roadmap +- **OpenWRT router** — NAT 80/443 → traefik + +## Current state + +See `concepts/recovery-architecture-snapshot.md` (migrated 2026-05-21 from `MoreThenCms`). + +## Goal + +Build fault-tolerant infrastructure so the 2026-05-18 SMR-cascade incident does not repeat. Roadmap design in progress — see `concepts/future-resilient-architecture-goals.md` (migrated 2026-05-21) and active task `[resilience-roadmap-design]`. + +## Related repos (out of admin) + +- `OpeItcLoc03/vds-ops-mcp` — read-only docker ops MCP for VDS +- `OpeItcLoc03/synology-ops-mcp` — same for NAS +- `OpeItcLoc03/projects-meta-mcp` — cross-project state aggregator +- `OpeItcLoc03/agenda` — cross-project task meta-board +- `OpeItcLoc03/projects-wiki` — shared knowledge wiki +- `OpeItcLoc03/claude-skills` — global skill registry diff --git a/.wiki/packages/.gitkeep b/.wiki/packages/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.wiki/raw/README.md b/.wiki/raw/README.md new file mode 100644 index 0000000..b16c139 --- /dev/null +++ b/.wiki/raw/README.md @@ -0,0 +1,3 @@ +# raw/ + +Immutable external clippings: transcripts, screenshots, vendor docs, primary records. Files here are never modified after ingest — promote to `sources/` if curated. diff --git a/.wiki/sources/.gitkeep b/.wiki/sources/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..4275136 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,13 @@ +# CLAUDE.md +# Agent instructions. Each line is a trigger for an installed skill. + +talk like a caveman +use superpowers +use project wiki +use task management system +check across all projects +pull remote before work +follow project discipline +delegate to interns when allowed +recommend, don't menu +we're on Windows diff --git a/README.md b/README.md index e6e6a5b..a2f5e26 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,5 @@ # admin -Infrastructure agenda � VDS/NAS/recovery-host/OpenWRT + fault-tolerance roadmap \ No newline at end of file +Infrastructure agenda — VDS / NAS / recovery-host / OpenWRT + fault-tolerance roadmap. + +See `.wiki/overview.md` for orientation.