dnd/.github/copilot-instructions.md

D&D campaign notes repository instructions

This repository is the single source of truth for D&D notes across multiple campaigns, worlds, ideas, systems, and players. Prefer edits that preserve structure, reuse existing lore, and keep notes easy to navigate in Obsidian.

Core organization

• Treat worlds/ as reusable setting context: persistent lore, geography, factions, NPCs, history, and creatures.
• Treat campaigns/ as story-specific overlays on a world: overviews, session notes, campaign-only NPCs, quests, items, and visited locations.
• Treat ideas/ as scratch space for future campaigns, worlds, and mechanics.
• Treat players/ as player-character material.
• Treat systems/ as system references.

Relationship rules

• Worlds are reusable context; campaigns are specific stories within them.
• Prefer linking to world notes from campaign notes instead of duplicating shared content.
• If a campaign-specific note changes or evolves a world-level person, faction, or location, create a campaign note that links back to the world note.
• World NPCs belong in worlds/<world>/npcs/; campaign NPCs belong in campaigns/<campaign>/npcs/.

File and folder conventions

• Use lowercase with hyphens for folder names, for example worlds/eldoria/ and campaigns/shattered-crown/.
• Use Title Case with spaces for note file names, for example The Lost Artifact.md and Continent A.md.
• Keep directory layouts consistent with the existing world and campaign structure.

Obsidian conventions

• Use wiki-links for cross-note references, for example [[worlds/Eldoria]] or [[campaigns/Shattered Crown/overview]].
• Keep frontmatter consistent when present so notes remain filterable and Dataview-friendly.
• Use consistent tags such as #world, #campaign, #session, #npc, #location, #faction, #item, #quest, #homebrew, and #idea.
• Use Obsidian callouts when helpful, especially:
  • > [!info] for quick-reference blocks
  • > [!warning] for spoilers or DM-only material
  • > [!tip] for DM notes

Content expectations

• Preserve the separation between player-facing content and DM-only secrets.
• Prefer ## Secrets sections or warning callouts for spoiler material.
• When creating or updating notes, match the existing note style:
  • World overviews include cosmology, geography, factions, and history timeline.
  • Campaign overviews include premise, player characters, active quests, and session log.
  • NPC notes include appearance, personality, goals and motivations, connections, and secrets.

Authoring guidance

• Link related notes together instead of restating the same information.
• Keep metadata, naming, and section structure consistent with neighboring notes.
• When adding new world or campaign content, place it in the most specific folder that fits its scope.