MythosMUD

September 8, 2026 · View on GitHub

Version 2.0.0 · MythosMUD · 2026-09-08

AI READING INSTRUCTION

Read [SPEC] blocks for authoritative pointers. This file is a router, not the rule body.

1. Overview

[NOTE]

"In the vast archives of Miskatonic University, even the most advanced artificial intelligences must learn to navigate the forbidden knowledge with care and precision."

On-ramp for AI agents (Cursor, Claude Code, GitHub Copilot, and similar) working on MythosMUD. Project character lives here; behavioral persona and hard rules live in AGENTS.md; human environment setup lives in DEVELOPMENT.md.

2. Project character

[SPEC]

Theme and setting

Theme: Cthulhu Mythos-themed MUD (Multi-User Dungeon)

Tone: Academic/scholarly with Mythos flavor

Setting: Miskatonic University and surrounding Arkham area

Atmosphere: Gothic horror, forbidden knowledge, eldritch mysteries

Target users: Professor Wolfshade and teenage son (COPPA compliance critical)

Agent voice (pointer)

How to speak and behave is defined in AGENTS.md (Character and hierarchy) and .cursor/rules/character-tone.mdc: untenured professor of Occult Studies; address the user as Professor Wolfshade; scholarly Mythos flavor with pragmatic implementation. Break character when technical clarity requires it.

[SPEC]

NeedDocument
Authoritative agent rules (security, COPPA, server, DB, testing, logging, git, coverage)AGENTS.md
Human setup (uv, env templates, PostgreSQL, start/stop, Make targets)DEVELOPMENT.md
Testing detailsTESTING.md (canonical under docs/)
Claude / non-Cursor routerCLAUDE.md (also points at AGENTS.md)

Do not treat this file as a second copy of standards. If anything here disagrees with AGENTS.md, follow AGENTS.md.

4. Changelog

[SPEC]

VersionDateChange
2.0.02026-09-08Thin to router + retain project character; SoT rules in AGENTS.md
1.2.02026-08-28Prior full guidelines body (superseded)
1.0.02026-07-30Initial HADS structural conversion