Agent-facing tooling that assembles screens from Storybook components, emits them as Stories, and turns them into implementations
Yosegi has 11 tools with consistent verb-noun naming (search_, get_, list_, create_, apply_, validate_, duplicate_, generate_). All tools have descriptions (avg ~120 chars, within baseline 34-392). Input schemas are present with type declarations. However, parameter descriptions are sparse or missing for complex types (e.g., 'root' and 'operations' in create_screen and apply_screen_operations are typed as 'unknown' with minimal guidance). Output schemas are not documented. Error handling is minimal, no recovery guidance or actionable error messages visible. Composition is sound (single responsibility per tool), but chaining support is unclear due to undocumented output structures.
Apply operations to update part of a screen (optimistic locking)
Create a new screen (as a draft)
Duplicate a screen (as a draft)
Generate Storybook Story (CSF) source from a screen tree, or — with target: "component" — a plain React component file for hosts without Storybook (no meta, one exported function per screen state; title and framework do not apply). Save it under the host's stories directory (or, for a component, wherever the user chose). Optional variants ({ name, description?, operations }) emit additional Story exports (or component exports) for the screen's other states (loading / error / empty)
Get a component's manifest
Report the registry's provenance (version, build time, recorded inputs) and warn when it was built by a different Yosegi than the one running. Does not recompute source drift; run the CLI's registry status for that
Complex parameters typed as 'unknown' with minimal guidance. 'root' in create_screen and 'operations' in apply_screen_operations lack descriptions of expected structure, format, or constraints. LLMs cannot infer valid payloads.
Output schemas not documented. Tools return data structures (manifests, screen definitions, stories) but LLMs have no visibility into response fields, types, or chaining IDs. Breaks downstream tool composition.
Minimal error handling guidance. No recovery hints, error classification, or actionable messages visible. If a screen validation fails or an operation conflicts, LLMs have no guidance on retry strategy or next steps.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 66 | 2026-07-28+ | v2 |
Get a screen definition
List the categories present in the registry
List the stored screens
Search the registered components by name and category. Returns summaries (id, category, prop-type tokens, slots) capped at `limit` (default 50, max 200); pass detail: "full" for complete manifests
Validate a screen definition
Optimistic locking in apply_screen_operations requires 'baseRevision' but no guidance on how to obtain it or handle conflicts. LLMs may not understand the concurrency model.
generate_story accepts optional 'fixtures' as object type with no schema or description of expected structure. LLMs cannot construct valid fixture payloads.