Build your empire
Give the Queen one task and follow it through to a checked result.
Adapted from toolkit · f5911f6Start with one conversation and one task. Set up the Queen in Conductor cloud, then ask for a read-only investigation. The result should come back to her without you coordinating the 00-Agents.
You need Python 3.9 or later on macOS or Linux, plus Bash and jq for the upstream
compatibility test. Live work also needs the Conductor CLI with access to your
cloud sessions. GitHub PR reads need an authenticated gh CLI. Choose an agent
and model you already have access
to; Monarchy supplies no subscription or model default.
1. Check the package
In a terminal, clone the repository and enter it:
git clone https://github.com/tylerhuntington/monarchy.git
cd monarchy
python3 bin/monarchy.py check --court examples/court.json
python3 -m unittest discover -s tests -vThe check command prints "valid": true with zero tasks. The tests should pass
without credentials or network access. They exercise the record layer, transport
fixtures, skill packages, and an isolated First Mate outcome store. They do not
launch a live agent team or prove that an agent follows a skill correctly.
2. Give the Queen a home
Open this repository in a dedicated Conductor cloud workspace. This workspace holds the Queen and Secretary; project changes happen in separate task workspaces. The cloud workspace has its own checkout, so run the remaining file commands there, from its Monarchy root.
Create private working records from the templates:
mkdir -p .monarchy
cp examples/court.json .monarchy/court.json
cp templates/leadership.md .monarchy/leadership.mdThese files are gitignored. On a disposable machine, retain important handoffs in an approved durable location before the machine goes away.
The runtime's canonical task state is a private SQLite database outside the
checkout. .monarchy/court.json is only the observer's watch list; it does not
replace the journal. Follow the runtime setup to register the
existing 00-Agent and Secretary sessions before sending a task. Setup starts no
watcher, agent, or service.
Start your chosen agent in that workspace and give it this instruction:
Act as the Queen using AGENTS.md and roles/queen.md. Set up this agent team for the project I specify. Keep a leadership record, use a Secretary for coordination, and follow each project's existing rules. Keep my requests, status updates, important decisions, and results in this conversation. Start with one read-only task. Ask for missing project or model choices before dispatch.
This authorizes setup of that team and the bounded task, not changes to every repository the agent can access. The Queen records the project, model choices, report route, and limits, then uses the Conductor guide to arrange the Secretary and task session. Monarchy does not install a service or hooks.
3. Try one assignment
Give the Queen an outcome such as:
In my project, find where CSV exports are built. Return a short explanation with file references. Do not change files or publish anything.
The Queen records the brief and endpoint. The Secretary selects the skills and project instructions the 00-Agent needs, registers its native binding, then prepares and explicitly delivers the assignment through the runtime. Start with an existing session whose observed profile matches the requested one; the current CLI cannot explicitly disable fast mode when creating a session.
For optional status watching, add a row to .monarchy/court.json using
the task format. Its repo must match the native
workspace's repository. The runtime adapter checks that association; the separate
observer does not.
4. Get the result in the Queen's thread
Ask the Queen how the task is going. She should give you a concise status and any choice that needs your input. The Secretary handles routine questions and follow-ups.
When the 00-Agent finishes, the Secretary ingests its native report and checks the file references. Independent review ties the result to the exact source revision before it reaches the Queen's results inbox. The Queen returns the explanation and evidence in your conversation. Check that it answers the original request. You should not need to relay a report or ask a second agent to pick up the work.
If the result is incomplete, tell the Queen what's missing. She routes the follow-up through the Secretary within the original assignment, or asks about any new scope.
Optional: inspect the machinery
To inspect the task yourself, run this from the Monarchy root in the cloud workspace:
python3 bin/monarchy.py status --court .monarchy/court.jsonYou should see the task's session status with an empty errors list. An idle
status means the turn ended, not that the requested outcome passed.
To exercise recovery, ask the Queen to arrange a handoff to a fresh session. The successor should recover the request and decisions from the records and accept ownership through the succession protocol. This checks how Monarchy preserves your direction when an underlying session changes.
Next
Use the bounded watcher for a longer task. Use the runtime guide for decision answers, delivery recovery, and inbox acknowledgments. Each command exits after its work; the Secretary must arrange the next check. Add a build task with independent review once the first task returns a checked result through the Queen. Keep the implementation limits visible when deciding how much supervision to delegate.