bootstrap: admin project skeleton (CLAUDE.md, .wiki/, .tasks/)
This commit is contained in:
13
.gitignore
vendored
Normal file
13
.gitignore
vendored
Normal 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
11
.tasks/STATUS.md
Normal 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
16
.wiki/CLAUDE.md
Normal 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
0
.wiki/concepts/.gitkeep
Normal file
0
.wiki/entities/.gitkeep
Normal file
0
.wiki/entities/.gitkeep
Normal file
23
.wiki/index.md
Normal file
23
.wiki/index.md
Normal 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
7
.wiki/log.md
Normal 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
25
.wiki/overview.md
Normal 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
0
.wiki/packages/.gitkeep
Normal file
3
.wiki/raw/README.md
Normal file
3
.wiki/raw/README.md
Normal 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
0
.wiki/sources/.gitkeep
Normal file
13
CLAUDE.md
Normal file
13
CLAUDE.md
Normal 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
|
||||||
Reference in New Issue
Block a user