EphemeraAdmin: Import: Help:Ephemera Agent/Instruction Namespace

2026-04-01T04:29:36Z

Import: Help:Ephemera Agent/Instruction Namespace

New page

{{DISPLAYTITLE:Ephemera Agent — Instruction Namespace}}
__TOC__

== Overview ==

The <code>Instructions:</code> namespace is the control layer of the entire system. It defines how the agent behaves, what pages should look like, how they should be written, and what policies govern canon. Editing an instruction page changes agent behavior immediately — no code changes required.

== Page Types ==

{| class="wikitable" style="width:100%"
! Type !! Naming Convention !! Purpose
|-
| Core || <code>Instructions:Core/PolicyName</code> || Global rules applied to every task. Canon policy, continuity rules, voice standards.
|-
| Workflow || <code>Instructions:Create/TaskType</code> || Step-by-step task execution procedures.
|-
| Workflow (subtype) || <code>Instructions:Create/Source/SubtypeName</code> || Type-specific workflow extensions.
|-
| Schema || <code>Instructions:Schema/PageType</code> || Required sections and structure for a page type.
|-
| Style || <code>Instructions:Style/ToneName</code> || Tone, voice, and register guides.
|-
| Maintenance || <code>Instructions:Maintenance/TaskName</code> || Audit and report generation procedures.
|-
| Config || <code>Instructions:Config</code> || Runtime configuration for the context assembly pipeline.
|-
| World Bible || <code>Instructions:World Bible</code> || The canonical universe reference. Always included first in every context package.
|}

== Page Structure ==

Instruction pages store their content as wikitext and their machine-readable metadata as a JSON block inside <code><nowiki></code> tags. The JSON is parsed by <code>wiki_api.php</code> to extract the <code>requires</code> dependency list.

=== Example Page ===

<pre>
== Instructions:Create/Source (Base Workflow) ==

Base workflow for creating a new source page and its corresponding Talk page.

=== Scope ===
Applies to all source-generation tasks regardless of document type.

=== Constraints ===
* Source page must be in-universe only
* Talk page must be interpretive
* Do not mix voices
* Maintain canon continuity

=== Procedure ===
# Determine source type
# Identify metadata
# Infer bias and reliability
# Write in-universe content
# Create source page
# Create Talk page
# Populate analysis

<pre><nowiki>
{
"meta": {
"id": "create-source-base",
"type": "workflow",
"applies_to": "Sources",
"task_type": "create",
"priority": "high",
"status": "active",
"canonical": true,
"requires": [
"Instructions:World Bible",
"Instructions:Schema/Source Page",
"Instructions:Core/Continuity Rules"
],
"tags": ["source", "create", "base"]
}
}
</nowiki></pre>
</pre>

== The requires Field ==

The <code>requires</code> array in the JSON metadata is the dependency graph. When the context pipeline selects an instruction page, it also fetches all pages listed in <code>requires</code>, and their requirements, up to <code>max_depth</code> hops.

Rules:
* List only '''direct''' dependencies — transitive ones are resolved automatically
* Use full page titles: <code>"Instructions:Core/Canon Policy"</code>
* Circular dependencies are safe — the BFS traversal tracks visited nodes
* Keep dependency chains shallow — deep chains consume token budget

== The World Bible ==

<code>Instructions:World Bible</code> is the most important page in the system. It is '''always loaded first''', before any other instruction page, for every context assembly call. It should contain:

* The fundamental premise of the universe (year, setting, tone)
* Core factions, polities, and power structures
* Canonical technology level and constraints
* Voice and register standards that apply everywhere
* Any facts that must never be contradicted

Keep it concise — it consumes token budget on every call.

== Instructions:Config ==

See [[Help:Ephemera Agent/Configuration#Instructions:Config]] for the full reference. The config page controls context assembly parameters and can extend the task type list without PHP changes.

== Bulk Loading the Instruction Namespace ==

The fastest way to populate the <code>Instructions:</code> namespace is via the [[Help:Ephemera Agent/Bulk Import|Bulk Import]] tool. Prepare your instruction pages in the instruction namespace JSON schema format and import them in one operation with no AI calls required.

[[Category:Help]]
[[Category:EphemeraAgent]]

Help:Ephemera Agent/Instruction Namespace - Revision history

EphemeraAdmin: Import: Help:Ephemera Agent/Instruction Namespace