Help:Ephemera Agent/Stub Workflow

From Encyclopedia Ephemera
Revision as of 19:17, 9 April 2026 by EphemeraAdmin (talk | contribs) (New page: full stub/expand lifecycle)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Overview

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

  1. Stub phase — generate minimal placeholder articles for many pages quickly (cheap, fast)
  2. 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

  1. Set Article Depth to Stub only in the Settings tab
  2. Browse to any page in the Browser tab
  3. Click a red link

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

Batch stubs

  1. Set Article Depth to Stub only
  2. Browse to a page with multiple red links
  3. 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 Source: 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: stub_expansion
  • 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 == See also == section.

Stub Detection Thresholds

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

  • Wikitext length < 1,500 characters
  • Contains {{stub}}
  • Contains [[Category:Stubs]] or [[Category:Stub]]

Instructions Used

Phase Task type Instruction page
Stub generation create_stub Instructions:Create/Stub
Batch red link stubs create_stub Instructions:Create/Stub
Expand stub_expansion Instructions:Create/Encyclopedia Article, Instructions:Schema/Encyclopedia Article