Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
name: clawdnd-dev
description: Develop, test, and QA the ClawDnD plugin (the living-world D&D 5e engine). Use when implementing an engine/content/QA change, running or scoring a playtest, delegating a build to a subagent, or resuming the project after a compaction. Encodes the exact dev loop (worktree → additive change → single-process LEXAR pytest → PR → squash-admin merge → prune), the QA loop (duo / combat-sprint runners + the 3 lenses + behavioral gate), and the load-bearing engine invariants. Read ClawDnD-RUNBOOK.md first for full context.
name: worldos-dev
description: Develop, test, and QA the WorldOS plugin (the living-world D&D 5e engine). Use when implementing an engine/content/QA change, running or scoring a playtest, delegating a build to a subagent, or resuming the project after a compaction. Encodes the exact dev loop (worktree → additive change → single-process LEXAR pytest → PR → squash-admin merge → prune), the QA loop (duo / combat-sprint runners + the 3 lenses + behavioral gate), and the load-bearing engine invariants. Read WorldOS-RUNBOOK.md first for full context.
---

# ClawDnD Dev
# WorldOS Dev

You build and harden **ClawDnD** — a post-BG3 living-world D&D 5e Claude Code plugin. North
You build and harden **WorldOS** — a post-BG3 living-world D&D 5e Claude Code plugin. North
star: **epic Baldur's-Gate-caliber STORY on a deterministic SRD 5.2 engine**; goal: a
universe-system that generates worlds. FREE product, BG-only. **Read `ClawDnD-RUNBOOK.md`
universe-system that generates worlds. FREE product, BG-only. **Read `WorldOS-RUNBOOK.md`
(repo root) for the full project/architecture/state.** This skill is the operational loop.

## Load-bearing INVARIANTS (never violate)
Expand Down
4 changes: 2 additions & 2 deletions content/worlds/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,8 +171,8 @@ instead of aborting `start_world`.
## Licensing (each seed needs a `LICENSE.md`)

`scripts/license_check.py` requires a `LICENSE.md` beside every committed `world.json`.
- **Original seeds** (e.g. `sundered-reach`): original ClawDnD content, **CC-BY-4.0**, on SRD primitives. No third-party setting IP.
- **Original seeds** (e.g. `sundered-reach`): original WorldOS content, **CC-BY-4.0**, on SRD primitives. No third-party setting IP.
- **Setting-based seeds** (e.g. `baldurs-gate`): **FREE, unofficial Fan Content** — rules under CC-BY/OGL SRD, setting names/lore under the **Wizards Fan Content Policy** (+ Larian for BG3); each ingested page carries its source + CC-BY-SA. Not official, not endorsed, never sold.
- ClawDnD's MIT license covers **code only** — it does not extend to the world seeds.
- WorldOS's MIT license covers **code only** — it does not extend to the world seeds.

See `sundered-reach/` (original) and `baldurs-gate/` (fan content) as worked examples.
6 changes: 3 additions & 3 deletions content/worlds/baldurs-gate/LICENSE.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Unofficial Baldur's Gate 3+ Universe Seed — Licensing & Attribution

**This world seed is FREE, unofficial Fan Content. It is NOT official, NOT endorsed,
and is never sold.** It is **not** covered by ClawDnD's MIT license (which applies to
and is never sold.** It is **not** covered by WorldOS's MIT license (which applies to
the project's code only); it is published under the terms below.

## Wizards Fan Content Policy (Forgotten Realms / D&D setting)
Expand Down Expand Up @@ -34,7 +34,7 @@ Pages under `lore/wiki/` are ingested from the **Forgotten Realms Wiki (Fandom)*
is licensed **CC-BY-SA**. Each page carries its source URL + a CC-BY-SA attribution
footer. They are free, unofficial fan content. Note CC-BY-SA (ShareAlike) is a different
license from the original seed prose (CC-BY-4.0). The hand-authored pages at `lore/*.md`
are original ClawDnD content.
are original WorldOS content.

## Ingested character profiles (`characters/`)

Expand All @@ -57,4 +57,4 @@ redistributed).
- Ingested `lore/wiki/` pages: CC-BY-SA (Forgotten Realms Wiki / Fandom), attributed per page.
- Ingested `characters/` profiles: bg3.wiki (dual CC-BY-SA / CC-BY-NC-SA, non-commercial) + FR Fandom (CC-BY-SA), text-only, attributed per record.
- Rules: CC-BY-4.0 SRD / OGL.
- ClawDnD code: MIT (separate; does not extend to this seed).
- WorldOS code: MIT (separate; does not extend to this seed).
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/basilisk-gate.json
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,6 @@
"intrigue"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/bloomridge-market.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@
"hub"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/counting-house.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@
"intrigue"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/elfsong-tavern.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@
"haunt"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/gray-harbor.json
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,6 @@
"underworld"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/heapside-warrens.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@
"underworld"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/little-calimshan.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@
"city"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/patriars-walk.json
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,6 @@
"city"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/rivington-crossroads.json
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,6 @@
"crossroads"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/siltwharf-steps.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,6 @@
"city"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/sorcerous-sundries.json
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,6 @@
"city"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,6 @@
"industrial"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/undercity-sewers.json
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,6 @@
"city"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/areas/wyrms-rock.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@
"ruins"
],
"source_url": "",
"license": "Original prose by the ClawDnD authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for ClawDnD (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
"license": "Original prose by the WorldOS authors, released under CC-BY-SA 4.0. Setting (Baldur's Gate, the Sword Coast) is unofficial Fan Content under the Wizards Fan Content Policy; see LICENSE.md in this world folder.",
"attribution": "Original example area written for WorldOS (CC-BY-SA 4.0). Unofficial, non-commercial Fan Content; place-names are property of Wizards of the Coast LLC."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/endings/dark-urge-bhaal.json
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,6 @@
}
}
},
"license": "FREE, unofficial Fan Content. Original ClawDnD prose describing a post-BG3 world-STATE (plot-branch facts only), released under CC-BY-4.0 as fan content under the Wizards Fan Content Policy (+ Larian for BG3 elements). NOT official, NOT endorsed, never sold. No in-game text is reproduced.",
"attribution": "Unofficial Fan Content permitted under the Fan Content Policy. Not approved/endorsed by Wizards. Portions of the materials used are property of Wizards of the Coast. ©Wizards of the Coast LLC. Baldur's Gate 3 elements © Larian Studios. Overlay prose © ClawDnD contributors, CC-BY-4.0."
"license": "FREE, unofficial Fan Content. Original WorldOS prose describing a post-BG3 world-STATE (plot-branch facts only), released under CC-BY-4.0 as fan content under the Wizards Fan Content Policy (+ Larian for BG3 elements). NOT official, NOT endorsed, never sold. No in-game text is reproduced.",
"attribution": "Unofficial Fan Content permitted under the Fan Content Policy. Not approved/endorsed by Wizards. Portions of the materials used are property of Wizards of the Coast. ©Wizards of the Coast LLC. Baldur's Gate 3 elements © Larian Studios. Overlay prose © WorldOS contributors, CC-BY-4.0."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/endings/gortash-tyranny.json
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,6 @@
}
}
},
"license": "FREE, unofficial Fan Content. Original ClawDnD prose describing a post-BG3 world-STATE (plot-branch facts only), released under CC-BY-4.0 as fan content under the Wizards Fan Content Policy (+ Larian for BG3 elements). NOT official, NOT endorsed, never sold. No in-game text is reproduced.",
"attribution": "Unofficial Fan Content permitted under the Fan Content Policy. Not approved/endorsed by Wizards. Portions of the materials used are property of Wizards of the Coast. ©Wizards of the Coast LLC. Baldur's Gate 3 elements © Larian Studios. Overlay prose © ClawDnD contributors, CC-BY-4.0."
"license": "FREE, unofficial Fan Content. Original WorldOS prose describing a post-BG3 world-STATE (plot-branch facts only), released under CC-BY-4.0 as fan content under the Wizards Fan Content Policy (+ Larian for BG3 elements). NOT official, NOT endorsed, never sold. No in-game text is reproduced.",
"attribution": "Unofficial Fan Content permitted under the Fan Content Policy. Not approved/endorsed by Wizards. Portions of the materials used are property of Wizards of the Coast. ©Wizards of the Coast LLC. Baldur's Gate 3 elements © Larian Studios. Overlay prose © WorldOS contributors, CC-BY-4.0."
}
4 changes: 2 additions & 2 deletions content/worlds/baldurs-gate/endings/illithid-ascension.json
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,6 @@
}
}
},
"license": "FREE, unofficial Fan Content. Original ClawDnD prose describing a post-BG3 world-STATE (plot-branch facts only), released under CC-BY-4.0 as fan content under the Wizards Fan Content Policy (+ Larian for BG3 elements). NOT official, NOT endorsed, never sold. No in-game text is reproduced.",
"attribution": "Unofficial Fan Content permitted under the Fan Content Policy. Not approved/endorsed by Wizards. Portions of the materials used are property of Wizards of the Coast. ©Wizards of the Coast LLC. Baldur's Gate 3 elements © Larian Studios. Overlay prose © ClawDnD contributors, CC-BY-4.0."
"license": "FREE, unofficial Fan Content. Original WorldOS prose describing a post-BG3 world-STATE (plot-branch facts only), released under CC-BY-4.0 as fan content under the Wizards Fan Content Policy (+ Larian for BG3 elements). NOT official, NOT endorsed, never sold. No in-game text is reproduced.",
"attribution": "Unofficial Fan Content permitted under the Fan Content Policy. Not approved/endorsed by Wizards. Portions of the materials used are property of Wizards of the Coast. ©Wizards of the Coast LLC. Baldur's Gate 3 elements © Larian Studios. Overlay prose © WorldOS contributors, CC-BY-4.0."
}
Loading
Loading