bootstrap: admin project skeleton (CLAUDE.md, .wiki/, .tasks/)

This commit is contained in:
2026-05-21 13:17:45 +03:00
parent 4d63aeef46
commit 34e779e002
13 changed files with 114 additions and 1 deletions

13
.gitignore vendored Normal file
View File

@@ -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/

11
.tasks/STATUS.md Normal file
View File

@@ -0,0 +1,11 @@
# Admin Task Board
_Updated: 2026-05-21_
<!--
Status legend:
🔴 Active — only one at a time
🟡 Paused — in progress, resumable
⚪ Ready — defined, not started
🟢 Done — kept until merged
🔵 Blocked — waiting on external input
-->

16
.wiki/CLAUDE.md Normal file
View File

@@ -0,0 +1,16 @@
# .wiki/ — Karpathy LLM Wiki
Curated knowledge base. Structure:
- `entities/<slug>.md` — physical/logical assets (hosts, NAS, VDS, router, recovery-VM)
- `concepts/<slug>.md` — patterns, root-cause analyses, recipes, postmortems
- `packages/<slug>.md` — third-party / first-party software packages relevant to this stack
- `sources/<slug>.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`)

0
.wiki/concepts/.gitkeep Normal file
View File

0
.wiki/entities/.gitkeep Normal file
View File

23
.wiki/index.md Normal file
View File

@@ -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
<!-- (none yet) -->
## Concepts
<!-- (none yet) -->
## Packages
<!-- (none yet) -->
## Sources
<!-- (none yet) -->

7
.wiki/log.md Normal file
View File

@@ -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

25
.wiki/overview.md Normal file
View File

@@ -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

0
.wiki/packages/.gitkeep Normal file
View File

3
.wiki/raw/README.md Normal file
View File

@@ -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.

0
.wiki/sources/.gitkeep Normal file
View File

13
CLAUDE.md Normal file
View File

@@ -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

View File

@@ -1,3 +1,5 @@
# admin # admin
Infrastructure agenda <EFBFBD> VDS/NAS/recovery-host/OpenWRT + fault-tolerance roadmap Infrastructure agenda VDS / NAS / recovery-host / OpenWRT + fault-tolerance roadmap.
See `.wiki/overview.md` for orientation.