Bug report in the readme.md
> ####EARLY EARLY ALPHA - I DO NOT recommend anyone but developers use this - yet... ###
The ####(4) does not match the ###(3) at the end.
If you haven't tried Claude Code yet, give it a go, and you'll see what I mean.
The game hooks into your shell and turns normal Linux commands into game actions:
Run ip route → "You've discovered the network gateway! +25 XP"
Check log files → Find cryptic messages from the missing admin
Run nmap on your network → Unlock a new area in the mystery
What it looks like in practice:
You get mysterious messages from "The Architect" (the missing admin)
Your shell prompt shows your level and current quest
Running normal commands sometimes triggers discoveries
An in-game journal records everything you learn
Challenge scripts create puzzles that teach Linux skills
The real magic: It actually integrates with your REAL infrastructure. If you have services on specific ports, the game will incorporate them into the story and challenges.
This is a personal project I've been working on - not publicly available yet, mostly due to hardware constraints on running multiple models simultaneously; but I'd love to know: Would something like this motivate you to better understand and document your setup? What features would make it valuable to you?
EDIT/UPDATE: How do I stress that this is way way under-developed and in development and not advisable for you to install just yet? I guess the best way is to provide a link. https://github.com/Fimeg/NetworkChronicles
This is CONCEPT. Its what I always wanted my tech to do. It's hardly feature complete - at best alpha 0.0.4 To gain a FULL understanding of what this might be - see the premise file: https://github.com/Fimeg/NetworkChronicles/blob/main/premise...
It still gets complicated if you have many interconnected devices to manage of course, but at least it limits the obscurity of the most complex devices in your network.
I'm open to alternatives though, if anyone has some to share.
I have found a couple of ways of doing documentation.
1. I document myself, with my style: I have a big Obsidian vault with work related documents, it's loosely based on Diataxis [0] method. I live document the part I'm working on once, and when I need to repeat the deed, I can update any changed parts, if any.
2. SaltStack. People doesn't prefer it much when it comes to Ansible, but pillars and recipes allows automation tons of stuff in a self documenting format. Plus, if you wish SaltStack has drift control and anchoring (like the default CFEngine behavior).
3. Terraform. Not incorporated by me, but a project uses it, and we use it in turn. What's nice about it is scaling. They have a variables file, and change the number of the server type you want to scale, and apply. It's scaled automatically. Infrastructure as code at best.
You want to installs with specific versions and packages? You can use xCAT for RedHat and Debian systems (which will be replaced by Lenovo Conflence soonish). You can re-provision a system to the exact state you want with three commands and, within 15 minutes, your system will be ready. Since it uses the repositories local to xCAT, no version drifting occurs.
I personally install Debian stable, enable security updates, and periodically make sure that things are working. Not taking much time (10 minutes per month?).
[0]: https://diataxis.fr/
For example, package management actions map to specialized packages per OS, and for that specific package, documentation gives how the specific package calls the binaries or use the libraries. After a certain point you start to build call trees and see everything in your mind before pressing enter.