| namespace | aiwg |
| name | steward-quickref |
| platforms | ["all"] |
| kernel | true |
| description | AUTO-INVOKE for steward feature-domain routing — authoring an expansion (extension/addon/framework), creating or selecting a persona/SOUL identity, or scaffolding a project. Thin discover anchors for the three domains the framework quickrefs don't own. |
| triggers | ["author an expansion","create a persona","select a persona","scaffold a project","steward routing","steward model routing","model catalog routing","cheap first model policy","which aiwg feature do i use","expansion persona or project"] |
Steward Quickref
Thin routing anchor for the three cross-cutting feature domains that no
single framework quickref owns: expansion authoring, persona/SOUL
identity, and project creation. This file holds guidance + anchoring
phrases only — it never inlines skill or agent bodies. The capability index
does the heavy lifting: each row gives the aiwg discover phrase that ranks
the owning capability top-3 (the four discover facets fuse the result —
see src/artifacts/discover-facets.ts).
Always discover, then show. These phrases are the entry points; fetch the
selected artifact with aiwg show <type> <name>. Do not browse the
filesystem (skill-discovery rule).
Steward Tiering
aiwg-steward.md is the Tier-1 dispatch core. This quickref is Tier 2. When
the steward needs detailed lookup tables, route to Tier 3 with
aiwg discover "aiwg-steward routing reference" or
aiwg discover "aiwg-steward worked examples". If a route is ambiguous, ask
one clarifying question; if a target is stale or missing, file a correction
issue through the AIWG issue-filing flow with the broken target and observed
command output.
Domain 1 — Expansion authoring (extension / addon / framework)
"How do I build an AIWG expansion?" — extensions, addons, and frameworks.
| You want to… | Discover phrase | Owning capability |
|---|
| Author an extension | aiwg discover "author an expansion" | scaffold-extension |
| Create an addon | aiwg discover "create an addon" | scaffold-addon |
| Build a framework | aiwg discover "scaffold a framework" | scaffold-framework |
| Pilot then graduate a project-local bundle | aiwg discover "project-local bundle" | new-bundle, promote |
| Package a standalone/community plugin repository | aiwg discover "standalone plugin repository" | package-plugin |
Domain 2 — Persona / SOUL identity (author and select)
"How do I make or choose an identity/voice?" Personas live at
agentic/code/agents/personas/; SOUL profiles are managed by the soul-*
skills.
| You want to… | Discover phrase | Owning capability |
|---|
| Create / author a persona (SOUL) | aiwg discover "create a persona" | soul-create |
| Select / switch a persona identity | aiwg discover "select a persona" | persona agents + soul-apply |
| See the persona roster | aiwg discover "persona" | agentic/code/agents/personas/* |
| Manage SOUL lifecycle (enable/disable/blend) | aiwg discover "soul" | soul-enable, soul-disable, soul-blend |
Runtime persona selection UX (catalog-pick) is an open research area — see
spike #1625; for now, discover the persona then activate via the SOUL skills.
Domain 3 — Project creation (aiwg new + project-local)
"How do I start an AIWG project?"
| You want to… | Discover phrase | Owning capability |
|---|
| Scaffold a new project | aiwg discover "scaffold a project" | new-project |
| Create a project-local bundle | aiwg discover "project-local bundle" | new-bundle |
Domain 4 — Provider capability (native vs emulated)
"Does my provider support X natively, or does AIWG emulate it?" Route through
the steward, which reads capability-matrix.yaml.
| You want to… | Discover phrase / route |
|---|
| Check provider support for a capability | aiwg discover "provider capability" → steward |
Domain 5 — Model policy and catalog routing
"Which model should this use?" Route through aiwg steward models and the
aiwg models command family. Do not recommend exact provider IDs from memory.
| You want to… | Discover phrase / route |
|---|
| Explain cheap-first routing | aiwg steward models |
| Inspect effective catalog provenance | aiwg models sources --json |
| Refresh provider/account catalog | aiwg models refresh --json |
| Compile/audit artifacts for a provider | aiwg models audit --provider <provider> |
| Resolve selected model IDs | aiwg models resolve --provider <provider> |
Steward routing protocol
When a request maps to one of these domains:
- Volunteer the affordance (Norman signifier): if a user is working near a
domain but hasn't found it, surface it — "you can also author expansions,
create/select a persona, or scaffold a project; want me to discover one?"
- Discover, don't dead-end. Run the domain's
aiwg discover phrase.
- Re-query on low confidence. If the first pass is weak, broaden the
phrase or try an adjacent domain phrase before concluding "not found" — the
skill-discovery rule forbids decline-without-search.
- Show the selection.
aiwg show <type> <name> for the chosen capability.
