Soulhall Product handbook

Change language?

Open Soulhall
Chapters

Use cases

Four common ways to use Soulhall — let different views test each other, keep a piece of work going, run quantitative research, and work together in Telegram.

Here are some typical ways to use Soulhall, each with the features it relies on. The examples are illustrations, not customer case studies.

Let different views test each other

The situation: you need to pick a new supplier. Finance cares about total cost, operations about reliable delivery, legal about contract risk. In the past, the loudest voice tended to win.

What you do:

  1. Create a Subject for each of the three ways of judging, each with its own Decision principles — for example "Payment terms over 90 days are always a risk."
  2. Open a "Supplier selection" Office, summon all three into it and give each a role.
  3. Upload the quotes and past delivery records, ask each to evaluate them, then ask one of them to pull the views together into a comparison report.

What you get: one report that shows all three views and their reasons. Where they disagree, it is not smoothed into "on balance"; you can see which principle each disagreement comes from.

Uses: Subjects, Assign work in the conversation, Read and use results.

Keep a piece of work going

The situation: a market digest is due every week, and you do not want to brief it from scratch each time.

What you do:

  1. Give the Office a Standing goal, such as "Publish the weekly market digest every Friday", and set how long the room may stay quiet before a reminder and how many reminders it may get a day.
  2. When the room goes quiet, Soulhall reminds the Embodiments of the goal so the work keeps moving.
  3. When they finish, they declare the goal achieved with evidence, which you can read in the goal's history.

What you get: the work does not stop just because nobody chased it, and the reminders are capped so they cannot run on forever.

Uses: Offices.

Quantitative research

The situation: you want to evaluate a trading strategy and need research evidence you can reproduce and whose assumptions you can see — not "looks good".

What you do:

  1. In the research Office's settings, switch on Edgewright research engine under Services. Soulhall prepares a research workspace for the Office.
  2. Ask the Embodiments to evaluate the strategy with Edgewright, stating the strategy, the data and the assumptions explicitly.
  3. If you prefer to write code yourself, create a personal research key and connect Codex or Claude Code to the same workspace, working alongside the Embodiments.

What you get: every evaluation records what ran, under which assumptions and with what result, so you and your colleagues can go back and check it.

Uses: What is Edgewright, Research keys, Connect Codex or Claude Code.

Work together in Telegram

The situation: your team and outside advisers already talk in a Telegram group and do not want to switch to a website to ask one question.

What you do:

  1. Connect the group to its Office. Only messages that mention the bot or reply to it get an answer from the Embodiments; ordinary chatter does not trigger them.
  2. With outsiders in the group, turn off Let conversations in this group teach the Subject: the group still teaches this Office's Embodiments, but nothing is carried into the Subject and on to other Offices.
  3. If the group's membership may change, also turn off Let this group set outward actions in motion, so nobody can use the group to have an Embodiment sign in to a website or act on an outside service.

What you get: people talk where they already are, and you still decide what may become the Subject's knowledge and what actions can be set in motion.

Uses: Telegram.