Skip to content

About

Claude Code workspace: build, deploy, and operate home-server services with self-maintained docs.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

239 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

claude-code-space — Dev & Ops Wiki

A living operations wiki for building, deploying, and running real services on a home server, maintained by Claude Code. Based on Andrej Karpathy's LLM Wiki pattern: instead of re-deriving context on every question, the LLM compiles operational knowledge once and keeps it current as the system evolves. Chat history is ephemeral — this wiki is the durable memory of what exists, how it's wired, why it was built that way, how to operate it, and what has gone wrong.

You build, deploy, and decide. Claude keeps the service pages, infra map, runbooks, decisions, and incident records accurate and cross-linked.

Structure

Path What it is
wiki/services/ One page per service/app — the core catalog
wiki/infra/ Home server, network, reverse proxy, DNS, Docker, storage, backups
wiki/runbooks/ Operational how-tos: deploy, restart, backup, restore, upgrade
wiki/decisions/ ADRs — architectural & tooling choices and rationale
wiki/incidents/ Postmortems — what broke, root cause, fix, prevention
wiki/concepts/ Reusable patterns & reference knowledge
wiki/index.md Service registry + catalog (the map)
wiki/overview.md The whole system at a glance
log.md Append-only timeline of builds, deploys, decisions, incidents
raw/ Dropped artifacts (logs, configs, screenshots) for Claude to distill
CLAUDE.md The schema — conventions & workflows for the LLM

Working with it

  • New service: "create a service page for X" → Claude scaffolds the catalog entry.
  • Deploy: after deploying, Claude updates the service page + deploy runbook + infra + log.
  • Decision / Incident: Claude records ADRs and postmortems so context isn't lost.
  • Query: ask about the system; Claude answers with citations and files good answers back.
  • Lint: ask Claude to "lint the wiki" — checks stale status, missing runbooks, leaked secrets, orphan pages, and open follow-ups.

Secrets never go in this repo

No passwords, API keys, tokens, private keys, or .env values in the wiki or raw/. Record pointers to where secrets live, never the values. See CLAUDE.md for the full rule.

About

Claude Code workspace: build, deploy, and operate home-server services with self-maintained docs.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages