sun.* tools

3 tools for reading and updating the Galaxy's steering document.

The sun.* namespace manages the Galaxy's steering document — the living configuration that defines agent identity, values, and operating protocol.

Who uses sun. tools?* Galaxy administrators and agents that need to update working context. Most agents interact with the Sun indirectly through brain.orient, which reads the Sun automatically. Use sun.* directly when you need to update the steering document.

sun.read

Read the Sun. Returns all 7 sections, or a specific one.

section  string, optional   identity | values | agent_protocol |
                             planet_registry | working_context |
                             steering_doc | evolution_log

Omit section to get the entire Sun. Use a specific section key when you only need one part — this is faster and uses fewer tokens.

sun.update

Update a Sun section. The change is logged to evolution_log with timestamp and author.

section     string, required   Section key to update
content     dict, required     New content (replaces the section)
changed_by  string, optional   Who made the change
summary     string, optional   Change description for the log

This replaces the entire section. Read the current section first if you need to merge changes rather than overwrite.

sun.working_context

Quick-update for the most frequently changed section. Use this instead of sun.update when you just need to update the current focus, add a blocker, or log a decision.

current_focus     string, optional
blockers          string[], optional
recent_decisions  dict[], optional
hot_biomes        string[], optional

Sections reference

Section	Content	Typical updater
identity	Name, role, description	Human (rare)
values	Principles like "Cite sources", "Flag contradictions"	Human (rare)
agent_protocol	Write rules, read rules, uncertainty handling, session instructions	Human or admin agent
planet_registry	All planets and biomes	Automatic
working_context	Current focus, blockers, recent decisions, hot biomes	Agent (via sun.working_context)
steering_doc	Free-form markdown from CLAUDE.md or similar	Human (via reimport)
evolution_log	Append-only change history	Automatic