PromptWorld
⭐ 0 stars • 🕑 Updated 2026-06-10
📦 Auto-published from the monorepo • CHANGELOG • sancovp/promptworld
PromptWorld is a Claude-Code-native app for building Claude-Code-native software.
You chat with one agent — the Engineer-CEO — and it builds the seven primitive component types that
make up any Claude Code system (skills, MCP servers, prompts, harnesses, teams, workflows, operating
systems), itself or by delegating to a specialist builder for each type. It runs as a single web app: a
chat + a live file workbench + dashboards, served from one container.
PromptWorld is also a worked example of an app built over a "nomicon" — the doc-mirror documentation /
development operating system. Every agent in PromptWorld loads the doc-mirror plugin, so the whole app
carries the ladder for turning a component into an AIOS into a framework and folding it back into the
system. PromptWorld can inspect its own structure and explain, as a living example, how an app like it
is built. It is also the meta-compiler of patterns (the compile-a-world skill): it treats every
*World — JobWorld, GameWorld, HealthWorld, PromptWorld — as a named architecture pattern (a *World = a
sim: a team-leader + specialists + a domain + a driver), so an agent can reuse a pattern or combine them
into a new World/app and fold it up the nomicon ladder. (*World is a CAVE-fork resemblance, a way of
doing this — not a rigid type; there is no push-button general generator yet, by design.)
Quickstart
PromptWorld ships as a Docker image built from the monorepo. From the app directory:
cd application/promptworld
# 1. Build the image (stages promptworld + the doc-mirror plugin + cave + sdna, builds the SPA in-layer)
bash deploy/build.sh build
# 2. Boot a container on host port 3858 (mind_of_god-safe: create -> docker cp creds -> start)
# REQUIRES the provider key in your env so the agents can run:
export MINIMAX_API_KEY=... # the MiniMax-M3 key the agents authenticate with
bash deploy/build.sh boot 3858
# 3. Smoke-test it end-to-end from inside the container (health, SPA, a real CEO reply, a subagent build)
bash deploy/build.sh e2e
# stop
bash deploy/build.sh stop
Then open http://localhost:3858.
Auth model. The agents run on MiniMax-M3 (Minimax-M3[1m], base URL https://api.minimax.io/anthropic).
The key is passed into the container at boot as MINIMAX_API_KEY and exported as ANTHROPIC_AUTH_TOKEN.
A Claude subscription credential is also copied in (for the embedded terminal), but the agent turns use
the MiniMax provider token, not OAuth.
What's inside (the architecture)
The World module — the CEO + seven specialist builders
PromptWorld's World module is the guild that builds things:
- the Engineer-CEO (
agents/engineer-ceo.md) — the single agent you chat with. It has every skill and
one native subagent per component type, so it can build anything itself or delegate.
- seven specialist AIOS dirs under
promptgym/<craft>/, one per component type. Each is a directory
that codes an agent (its own CLAUDE.md + .claude/rules + .claude/agents), and each specialist
works ONLY in its own directory.
| craft | builds | master |
|---|
skill | a SKILL (lean SKILL.md + resources/) | Skillwright |
mcp | an MCP server (FastMCP tools) | Toolwright |
prompt | a prompt / persona (a "guy" in a role) | Promptwright |
harness | a harness (sequenced typed outputs across a turn) | Harnesswright |
team | a team / subagent set on a shared task list | Teamwright |
workflow | a deterministic fan-out script (the Workflow tool) | Flowwright |
operating_system | an AI OS (a directory + core loop that governs) | Systemwright |
The shared, re-skinnable world description lives in promptgym/world-context.md; the shared global agent
context in promptgym/global-context.md.
The nomicon ladder (what makes PromptWorld an app-over-a-nomicon)
Every PromptWorld agent loads the doc-mirror plugin, which carries the rungs:
component -> AIOS -> framework -> fold-into-nomicon -> app
as real skills/CLIs (make-ai-operating-system, the skill2framework prompt-tree, nomicon-atomize,
ship-a-plugin, and the app-rung skill). Ask the CEO "how is PromptWorld built / what is the nomicon"
and it inspects its own dirs and explains itself as the example.
The web app (the SPA)
Five pages, selected from the left panel:
