Live site · Platform overview · Hosted service · Content catalog
The source for sagasmithai.github.io: the public home of the AI-native TTRPG platform.
- fully autonomous game mastering as the primary player-facing experience;
- human-DM collaboration as a supported second hosting mode;
- persistent choices, actor-scoped knowledge, and clear table boundaries;
- honest D&D and CoC experience status;
- extended ruleset import as an explicitly experimental capability;
- checksum-validated unified core-rule, addon, module, and preset packages;
- the public-source hosted SagaSmith Service, while keeping game-state authority in system MCPs;
- the public, rights-aware Content Pack repository and checksum catalog, without treating repository visibility as a content license;
- a separate developer path for architecture, repositories, and ownership boundaries;
- short public-facing platform updates.
The site is bilingual (Chinese/English), static, and deliberately contains no runtime dashboard or user campaign data.
| Layer | Current repository |
|---|---|
| Neutral runtime | sagasmith-core |
| D&D Domain / MCP / Skills / UI | sagasmith-dnd |
| CoC Domain / MCP / Skills / UI | sagasmith-coc |
| Narrative Domain / MCP / Skills | sagasmith-narrative |
| Agent host | SagaSmith-agent |
| Hosted control plane | SagaSmith-service |
| Content catalog | SagaSmith-dnd-content-library |
Former standalone MCP, Skills, UI, and generic Module Generator repositories are archived history and are not current documentation or release entry points.
The public status published on 2026-08-20 is backed by a current-source hosted run: Service-signed principal context reached session-scoped Agent/MCP tools, and the D&D and CoC reference campaigns completed concurrently without a reported regression gap. The D&D path recorded a legal ending. Catalog-wide discovery and exclusions remain machine-readable; the site must not describe this reference run as complete playthrough coverage for every Pack or branch.
Requires Node.js 22.12+.
npm install
npm run dev
npm run build
npm run previewMain files:
src/pages/index.astro DM/player homepage and autonomous-hosting story
src/pages/developers.astro Developer architecture and repository map
src/pages/library.astro Rights-aware public Content Pack catalog frame
src/layouts/SiteLayout.astro Shared metadata, navigation, language, and footer
src/styles/site.css Shared responsive visual system
src/lib/news.ts Local field-note loader
news/ Dated Markdown field notes
public/ Logo, favicons, and social preview image
- Describe SagaSmithAI as an AI-native TTRPG platform with complete autonomous hosting as its primary end-user experience.
- Keep DM and player outcomes ahead of implementation details on the homepage.
- Present human-DM collaboration as a supported mode, not the only mode.
- Use the D&D-style fantasy d20 reference path for primary visual storytelling while CoC remains less mature; keep CoC in clearly labeled system-status areas.
- Present D&D as the end-to-end reference path and label CoC/UI maturity honestly.
- Always label extended ruleset import as experimental; never imply arbitrary rulebooks or unadapted third-party systems can be imported and run reliably.
- Keep domain state out of the website; link to MCP/Agent setup instead.
- Describe the hosted Service as a public-source orchestration layer, never as the owner of D&D, CoC, or Narrative campaign state.
- Do not claim bundled access to commercial rulebooks or modules.
- Treat repository visibility and content licensing as separate facts. Every public catalog entry still requires its own license and distribution rights.
- Distinguish unified content packages from campaign saves: no permissions, ActorKnowledge, progress, random stream, branches, or Snapshots migrate with them.
- Describe rule-package imports as validated inactive storage; branch activation remains a separate Owner/DM operation and never implies source authority.
- Update the organization Profile and platform README when the platform map changes.
- Tie verification claims to dated, machine-readable regression evidence and keep unexecuted modules or paths explicit.
Apache-2.0