aaron/darkwatch
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
darkwatch/CLAUDE.md
Aaron Wood 7c7bdf2ee5 chore: consolidate docs into flat structure and commit all plans 
- Move docs/superpowers/{plans,specs}/ → docs/{plans,specs}/
- Add 4 previously untracked implementation plans to git
- Update CLAUDE.md with docs path overrides for superpowers skills
- Update HANDBOOK.md repo structure and workflow paths
- Add per-enemy dice rolls to ROADMAP planned section

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-11 23:55:45 -04:00

1.8 KiB
Raw Blame History

Darkwatch — Claude Code Instructions

Permissions

All tool uses are pre-approved for this project. No confirmation needed for:

  • Reading, writing, or editing any file in this project
  • Running bash commands (npm, git, docker, curl, lsof, kill, pkill, etc.)
  • Spawning subagents
  • Searching files (Glob, Grep)

Project Overview

This is Darkwatch, a real-time session manager for the Shadowdark TTRPG.

  • Client: client/ — React + Vite + TypeScript + CSS Modules
  • Server: server/ — Express + Socket.IO + MariaDB (mysql2/promise)
  • DB: MariaDB 11 in Docker (darkwatch-maria container, port 3307)
  • Worktrees: .worktrees/ (gitignored)
  • Roadmap: docs/ROADMAP.md

Important Rules

  • NEVER touch the mysql Docker container — only darkwatch-* containers
  • DB port is 3307 (not 3306) to avoid conflicts
  • Local git repo only — commits are fine, NEVER push
  • All imports use .js extensions (ES modules)
  • Dev seed accounts: dm@darkwatch.test / player@darkwatch.test (password: password)

Docs Layout

Specs and plans live flat in docs/:

  • Specs → docs/specs/YYYY-MM-DD-<feature>-design.md
  • Plans → docs/plans/YYYY-MM-DD-<feature>.md

These override the superpowers skill defaults (docs/superpowers/...).

Project Skills

Project-local skills live in .claude/skills/. Invoke them by asking Claude to "use the [skill name] skill" or by reading the skill file directly.

Skill File When to use
update-changelog .claude/skills/update-changelog.md After a feature ships, bug is fixed, or feature is removed
update-handbook .claude/skills/update-handbook.md After a feature is added, changed, or removed
update-brochure .claude/skills/update-brochure.md After a feature is added, changed, or removed — keeps the site current