yoi/.yoi/tickets/open/20260607-072708-builtin-workflow-knowledge-resources/item.md

id	slug	title	status	kind	priority	labels	workflow_state	created_at	updated_at	assignee	legacy_ticket
20260607-072708-builtin-workflow-knowledge-resources	builtin-workflow-knowledge-resources	Builtin Workflow and Knowledge resources	open	task	P2	workflow knowledge resources builtin	planning	2026-06-07T07:27:08Z	2026-06-07T07:27:08Z	null	null

Background

Recent Orchestrator automation work embedded key workflow contracts as role-specific builtin guidance in generated prompts. This is sufficient for now, but it is not a full builtin Workflow/Knowledge resource system.

Longer term, reusable Yoi workflows and curated guidance should be available as bundled builtin Workflow/Knowledge resources that can be resolved by slug and optionally overridden/extended by project/user records.

Goal

Add builtin Workflow/Knowledge resources as first-class bundled resources while preserving project/user override capability.

Requirements

• Define a bundled resource location for builtin Workflows and builtin Knowledge, e.g. under resources/.
• Add resolver support for builtin Workflow/Knowledge slugs such as builtin:multi-agent-workflow or equivalent source-qualified identifiers.
• Preserve project-authored records under .yoi/workflow and .yoi/knowledge as project overrides/extensions.
• Define precedence between builtin, user, and project resources.
• Make builtin resource resolution available to role/prompt generation and workflow invocation paths where appropriate.
• Keep existing role-specific prompt guidance working; do not require a broad migration in the first pass.
• Ensure builtin resources can be referenced without copying them into every workspace.
• Document how users/projects override or extend builtin Workflow/Knowledge.
• Add tests for resource lookup, override precedence, and missing-resource diagnostics.

Non-goals

• Rewriting all current workflow prompts immediately.
• Solving active workflow compaction persistence; that remains preserve-active-workflows-across-compaction.
• Removing project .yoi/workflow / .yoi/knowledge support.

Acceptance criteria

• Builtin Workflow/Knowledge resources can be resolved by explicit source-qualified slug.
• Project/user resources can override or extend builtin resources according to documented precedence.
• Existing project workflow files continue to work.
• Tests cover builtin lookup and override behavior.