jmagly 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-discoveryrule).
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 discoverphrase. - 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-discoveryrule forbids decline-without-search. - Show the selection.
aiwg show <type> <name>for the chosen capability.