Skip to content
UPG is in early alpha. The specification is still evolving and may change between versions.
Tools/Spec Introspection/apply_framework

apply_framework

Apply a framework (MoSCoW, RICE, Kano, ...) to a set of entities: creates a framework_exercise node and an `includes` edge to each entity. The per-entity result is recorded on the edge via score_entity, never on the entity node, so the same entity can sit in many exercises and any entity type can be scored. Returns { exercise_id, exercise, included, warnings }.

Spec Introspectionatomic.

Arguments

framework_idstringrequired

Required. UPGFramework.id (e.g. "moscow", "rice-scoring").

titlestringoptional

Human label for the exercise (default "<Framework> exercise").

entity_idsarrayoptional

Entities to pull into the exercise (any type).

slot_rolesobjectoptional

Optional map of entity id → framework slot role (e.g. { "feat_x": "pain_reliever" }), stamped onto each entity's includes edge. Validated against the framework's declared slot roles (warn-only).

statusstringoptional

Lifecycle phase: draft | active | archived (default draft).

Returns

Shape
{ exercise_id, exercise, included: [{ edge_id, entity_id, edge_type, slot_role? }], warnings }

(the shared cross-surface envelope; identical to CLI apply --json).

See Also