View source for Help:Ephemera Agent/Stub Workflow

{{DISPLAYTITLE:Ephemera Agent — Stub Workflow}}
__TOC__

== Overview ==

The stub workflow is a two-phase content creation strategy:

# '''Stub phase''' — generate minimal placeholder articles for many pages quickly (cheap, fast)
# '''Expand phase''' — select stubs one at a time, optionally add custom context, and expand them into full articles

This is useful when exploring a new area of the wiki with many red links: stub all of them first to get a structural skeleton, then expand the ones that matter most.

== Phase 1: Generating Stubs ==

=== Single red link ===

# Set '''Article Depth''' to '''Stub only''' in the Settings tab
# Browse to any page in the Browser tab
# Click a red link

The agent generates a minimal stub (section headers, 1–3 sentences each, <code><nowiki>{{stub}}</nowiki></code> tag, one category) and posts it to the wiki. The Context tab opens automatically with the new stub pre-loaded.

=== Batch stubs ===

# Set '''Article Depth''' to '''Stub only'''
# Browse to a page with multiple red links
# Click the '''⚡ Stub N red links''' button in the browser toolbar

The agent generates and posts stubs for every red link sequentially. When complete, the source page reloads — previously red links are now blue (navigable stubs).

=== Source links ===

Red links targeting pages with a <code>Source:</code> title prefix are automatically routed to source-document generation rather than encyclopedia generation — regardless of the Page Type setting.

== Phase 2: Exploring Stubs ==

After batch generation, browse to any stub page. The Context tab automatically detects the page is a stub and:

* Loads the stub wikitext into the '''Stub / Prompt field'''
* Enables the '''POST ↑''' and '''EXPAND ↵''' buttons
* Records the page title for posting

You can also load context pages into the '''Custom Pages''' section using the '''+ CONTEXT''' button in the browser toolbar while browsing related articles.

== Phase 3: Expanding a Stub ==

With a stub loaded in the Context tab:

=== Option A — EXPAND ↵ (LLM) ===

Click '''EXPAND ↵'''. The agent runs with:

* Task type: <code>stub_expansion</code>
* Context: full context assembly pipeline (encyclopedia pages, instructions, sources) '''plus''' any custom pages you've added
* Prompt: built from the stub text and the page title

After generation, the browser switches to the updated page.

=== Option B — POST ↑ (direct) ===

Edit the stub text in the field manually, then click '''POST ↑''' to write it directly to the wiki without an LLM call. Any custom pages are appended as a <code>== See also ==</code> section.

== Stub Detection Thresholds ==

A page is treated as a stub if any of the following are true:

* Wikitext length < 1,500 characters
* Contains <code><nowiki>{{stub}}</nowiki></code>
* Contains <code><nowiki>[[Category:Stubs]]</nowiki></code> or <code><nowiki>[[Category:Stub]]</nowiki></code>

== Instructions Used ==

{| class="wikitable"
! Phase !! Task type !! Instruction page
|-
| Stub generation || <code>create_stub</code> || [[Instructions:Create/Stub]]
|-
| Batch red link stubs || <code>create_stub</code> || [[Instructions:Create/Stub]]
|-
| Expand || <code>stub_expansion</code> || [[Instructions:Create/Encyclopedia Article]], [[Instructions:Schema/Encyclopedia Article]]
|}

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