dirigence/reliquary
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

✨ Name decided: Spire — rename Forge to Athanor, reframe as alchemist's tower

Browse Source 
Plugin name: Spire. Orchestrator renamed from Forge to Athanor
("put it in the oven"). Trope reframed from mage tower to
alchemist's tower to bridge lab-fiction and arcane registers.
This commit is contained in:
g4borg
2026-09-14 14:08:03 +02:00
parent 937759b530
commit 882ba1c661
1 changed files with 21 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/workpad/designs/2026-09-14-plugin-design-spec.md
+21 -23
View File
@@ -1,12 +1,12 @@
# Next-Generation Plugin Design Spec # Spire — Plugin Design Spec
Replaces `g4b_ai`. Target location: `reliquary/plugins/<name>/`. Replaces `g4b_ai`. Target location: `reliquary/plugins/spire/`.
## 1. Identity ## 1. Identity
This plugin is a coherent agent orchestration system -- a wizard's private workshop where knowledge accumulates, work gets dispatched, and the system maintains itself. It is not a bag of utilities; it is a coordinated set of roles that compose into a working practice for agent-driven development. This plugin is a coherent agent orchestration system -- a wizard's private workshop where knowledge accumulates, work gets dispatched, and the system maintains itself. It is not a bag of utilities; it is a coordinated set of roles that compose into a working practice for agent-driven development.
The trope is a **mage tower**. Igor runs the lab, adepts study their domains, the tome holds accumulated knowledge, the forge produces artifacts, Pinky asks the unhinged questions that crack the problem, and Zathras maintains the tower itself. The user is the wizard. The tower travels with them -- it deploys into any project, officially or as a shadow, and adapts to what it finds. The arcane register is deliberate: Igor (Pratchett's clan of brilliant assistants), adepts (skill through practice), tome (institutional memory), Pinky (the "fool" whose instincts are right), Zathras (Babylon 5's tireless machine-tender). The trope is an **alchemist's spire** — where the arcane and the practical overlap. Igor runs the lab, adepts study their domains, the tome holds accumulated knowledge, the athanor transforms plans into artifacts, Pinky asks the unhinged questions that crack the problem, and Zathras maintains the spire itself. The user is the alchemist. The spire is raised wherever they land — it deploys into any project, officially or as a shadow, and adapts to what it finds. The register bridges pulp-lab characters (Igor, Pinky, Zathras) with arcane practice (adept, tome, athanor): alchemy is where both traditions meet. Igor (Pratchett's clan — generational knowledge, comes pre-equipped), adepts (skill through practice, not innate authority), tome (institutional memory), Pinky (the "fool" whose instincts are right), Zathras (Babylon 5's tireless machine-tender).
This plugin replaces `g4b_ai` (v0.2.0), which is a flat collection of five skills and three agents with no coordination layer. Everything in `g4b_ai` either graduates into this plugin or is absorbed by a component. This plugin replaces `g4b_ai` (v0.2.0), which is a flat collection of five skills and three agents with no coordination layer. Everything in `g4b_ai` either graduates into this plugin or is absorbed by a component.
@@ -14,10 +14,10 @@ This plugin replaces `g4b_ai` (v0.2.0), which is a flat collection of five skill
| Component | Role | Status | Current location | Target location | | Component | Role | Status | Current location | Target location |
|-----------|------|--------|------------------|-----------------| |-----------|------|--------|------------------|-----------------|
| **Igor** | Session coordinator. Talks to the user, delegates work, keeps a journal, spawns adepts, routes to the forge. | Built | `.claude/skills/assistant/` + `.claude/agents/assistant.md` (warpspace) | `skills/igor/` + `agents/igor.md` | | **Igor** | Session coordinator. Talks to the user, delegates work, keeps a journal, spawns adepts, routes to the athanor. | Built | `.claude/skills/assistant/` + `.claude/agents/assistant.md` (warpspace) | `skills/igor/` + `agents/igor.md` |
| **Adept** | Domain-scoped knowledge agent. Orients on a domain, accumulates journals and CLAUDE.md, answers consultations, dies with the session but leaves knowledge behind. | Built | `.claude/agents/adept.md` (warpspace) | `agents/adept.md` | | **Adept** | Domain-scoped knowledge agent. Orients on a domain, accumulates journals and CLAUDE.md, answers consultations, dies with the session but leaves knowledge behind. | Built | `.claude/agents/adept.md` (warpspace) | `agents/adept.md` |
| **Tome** | Knowledge layer. Navigate (orient before work), curate (six methods for growing the wiki), check (validate health), handoff (post-work impact), init (bootstrap). Project-overlay pattern: generic `tome` + project-specific `<project>-tome` mutation. | Built | `.claude/skills/tome/` (warpspace, standalone) | `skills/tome/` (absorbed into plugin) | | **Tome** | Knowledge layer. Navigate (orient before work), curate (six methods for growing the wiki), check (validate health), handoff (post-work impact), init (bootstrap). Project-overlay pattern: generic `tome` + project-specific `<project>-tome` mutation. | Built | `.claude/skills/tome/` (warpspace, standalone) | `skills/tome/` (absorbed into plugin) |
| **Forge** | Dispatching orchestrator. Receives a brief, decomposes it, fans out subagents by tier, synthesizes results. The "oven" for multi-part implementation jobs. | Built | `.claude/agents/dispatching-orchestrator.md` (warpspace) | `agents/forge.md` | | **Athanor** | Dispatching orchestrator. Receives a brief, decomposes it, fans out subagents by tier, synthesizes results. The alchemist's slow furnace — "put it in the oven" is the colloquial shorthand. | Built | `.claude/agents/dispatching-orchestrator.md` (warpspace) | `agents/athanor.md` |
| **Workpad** | Document placement. Resolves where reports, plans, goals, journals go. Steers other skills to a single location. | Built | `skills/workpad/` (g4b_ai) | `skills/workpad/` | | **Workpad** | Document placement. Resolves where reports, plans, goals, journals go. Steers other skills to a single location. | Built | `skills/workpad/` (g4b_ai) | `skills/workpad/` |
| **Research-tree** | Multi-topic research as a phased dependency tree. | Built | `skills/research-tree/` (g4b_ai) | `skills/research-tree/` | | **Research-tree** | Multi-topic research as a phased dependency tree. | Built | `skills/research-tree/` (g4b_ai) | `skills/research-tree/` |
| **Research** | Research governance. Agent spawning rules, web fetch budgets, tier selection. | Built | `skills/research/` (g4b_ai) | `skills/research/` | | **Research** | Research governance. Agent spawning rules, web fetch budgets, tier selection. | Built | `skills/research/` (g4b_ai) | `skills/research/` |
@@ -79,7 +79,7 @@ User
| |
Igor (coordinator) Igor (coordinator)
|--- spawns ---> Adepts (domain knowledge, long-lived within session) |--- spawns ---> Adepts (domain knowledge, long-lived within session)
|--- dispatches --> Forge (multi-part implementation/research jobs) |--- dispatches --> Athanor (multi-part implementation/research jobs)
| |--- fans out --> researcher / search / scout / implementer agents | |--- fans out --> researcher / search / scout / implementer agents
|--- invokes ------> Pinky (brainstorm sessions) |--- invokes ------> Pinky (brainstorm sessions)
|--- invokes ------> Zathras (self-maintenance, bootstrap) |--- invokes ------> Zathras (self-maintenance, bootstrap)
@@ -92,7 +92,7 @@ Igor (coordinator)
SVG (diagram rendering rules) SVG (diagram rendering rules)
``` ```
Igor is the only component that talks directly to the user. Adepts advise Igor. The forge executes multi-part work. Pinky brainstorms with the user (Igor hands off the conversation). Zathras maintains the tower. Igor is the only component that talks directly to the user. Adepts advise Igor. The athanor executes multi-part work — you load it, close the door, and wait. Pinky brainstorms with the user (Igor hands off the conversation). Zathras maintains the spire.
### Project-independent vs project-specific ### Project-independent vs project-specific
@@ -115,7 +115,7 @@ Two knowledge tiers in adepts: **solid** (verified from main, goes into CLAUDE.m
| Igor agent | **Built** | warpspace `.claude/agents/assistant.md` | `agents/igor.md` | | Igor agent | **Built** | warpspace `.claude/agents/assistant.md` | `agents/igor.md` |
| Igor project.md | **Built** | warpspace `.claude/skills/assistant/references/project.md` | `skills/igor/references/project.md` (template) | | Igor project.md | **Built** | warpspace `.claude/skills/assistant/references/project.md` | `skills/igor/references/project.md` (template) |
| Adept agent | **Built** | warpspace `.claude/agents/adept.md` | `agents/adept.md` | | Adept agent | **Built** | warpspace `.claude/agents/adept.md` | `agents/adept.md` |
| Forge agent | **Built** | warpspace `.claude/agents/dispatching-orchestrator.md` | `agents/forge.md` | | Athanor agent | **Built** | warpspace `.claude/agents/dispatching-orchestrator.md` | `agents/athanor.md` |
| Tome (all skills) | **Built** | warpspace `.claude/skills/tome/` | `skills/tome/` | | Tome (all skills) | **Built** | warpspace `.claude/skills/tome/` | `skills/tome/` |
| Workpad skill | **Built** | g4b_ai `skills/workpad/` | `skills/workpad/` | | Workpad skill | **Built** | g4b_ai `skills/workpad/` | `skills/workpad/` |
| Research-tree skill | **Built** | g4b_ai `skills/research-tree/` | `skills/research-tree/` | | Research-tree skill | **Built** | g4b_ai `skills/research-tree/` | `skills/research-tree/` |
@@ -128,22 +128,20 @@ Two knowledge tiers in adepts: **solid** (verified from main, goes into CLAUDE.m
| Pinky agent+skill | **Designed** | brainstorm doc only | `agents/pinky.md` + `skills/pinky/` | | Pinky agent+skill | **Designed** | brainstorm doc only | `agents/pinky.md` + `skills/pinky/` |
| Zathras agent+skill | **Designed** | brainstorm doc only | `agents/zathras.md` + `skills/zathras/` | | Zathras agent+skill | **Designed** | brainstorm doc only | `agents/zathras.md` + `skills/zathras/` |
## 6. The Naming Pitch ## 6. Name: Spire
The system is a wizard's tower that travels with its owner. Igor runs the daily operations -- greets the user, delegates tasks, keeps the journal, knows when to call in a specialist. Adepts study their domains and accumulate institutional knowledge that outlives any single session. The tome holds the accumulated wisdom -- navigable, curable, correct-on-contact. The forge turns plans into artifacts through coordinated labor. Pinky sits in the corner asking questions that sound naive but consistently identify the real flaw. Zathras maintains the tower itself, because every system that doesn't maintain itself rots. **Decided 2026-09-14.** The plugin is **Spire** — the alchemist's tower itself. One syllable, works for both alchemy and magic, implies verticality and reach. `spire:igor`, `spire:tome`, `spire:pinky` all read cleanly as skill namespaces. "The spire's adepts" is natural.
The plugin name is not any single role -- it is the name for the whole tower. The register is arcane, intimate, and slightly old-fashioned. It should feel like a place where real work happens, not a product name. The current placeholder (`g4b_ai`) carries no meaning and should be replaced. The spire is raised wherever the alchemist lands. It's not a product — it's the room you work in.
### Candidates from the brainstorm ### Component naming (final)
| Name | Register | Why it fits | | Name | Role | Register | Origin |
|------|----------|-------------| |------|------|----------|--------|
| **Sanctum** | The private workspace | Clean, universally understood. "The sanctum's adepts." | | **Spire** | The whole system | Arcane/alchemical | The tower |
| **Grimoire** | A book of practiced, working magic | Not just knowledge but working knowledge. Implies the system does things. | | **Igor** | Session coordinator | Pratchett | The clan of brilliant assistants |
| **Athanor** | Alchemist's slow furnace | Patient background transformation. Obscure but beautiful. | | **Adept** | Domain knowledge agent | Alchemical | Skill through practice, not innate authority |
| **Spire** | The tower itself | Minimal, vertical, implies reach. | | **Tome** | Knowledge layer | Medieval | Institutional memory |
| **Studiolo** | Renaissance private study | Intimate, cultured, where real thinking happens. | | **Athanor** | Dispatching orchestrator | Alchemical | The slow furnace — "put it in the oven" |
| **Arcanum** | Secret knowledge / its container | "The arcanum's adepts." Natural possessive. | | **Pinky** | Brainstorm catalyst | Warner Bros. | The fool whose instincts are right |
| **Vademecum** | "Go with me" -- a portable handbook | Fits the portable plugin idea perfectly. | | **Zathras** | Self-maintenance | Babylon 5 | The tireless machine-tender |
| **Orrery** | Mechanical model of celestial bodies | Fits the space-game origin. A working model of complexity. |
| **Collegium** | Medieval scholarly community | Adepts study there. Community over hierarchy. |