Skip to main content

Tome of Sessions Developer Docs

This site is the curated guide to how Tome of Sessions is built. Use it when you need the current development workflow, architecture map, API contract rules, or Sage AI internals without reading months of implementation notes first.

The source of truth is still the repository:

  • README.md covers setup, the route table, deployment, and high-level usage.
  • AGENTS.md defines coding conventions and the mandatory completion checklist.
  • FEATURES.md is the running feature ledger. Update it in the same change whenever a feature is added, changed, or removed.
  • docs/superpowers/specs/ and docs/superpowers/plans/ hold historical design decisions and implementation plans.
  • graphify-out/GRAPH_REPORT.md is a generated knowledge-graph report for exploring relationships across the project when present locally.

Good Starting Points​

Start with Development Workflow before changing code. Read Architecture and Project Map when you need the big picture.

For feature work, go directly to the relevant domain page:

Read AI and Sage before touching document ingestion, rules chat, recap extraction, NPC generation, or evaluation work.

What This Site Is Not​

This site is not a replacement for tests, API types, migrations, or the feature ledger. Treat these pages as orientation and maintenance guidance. If the code and docs disagree, fix the docs as part of the change.