DISTRIBUTION
Registry
Agentic Craft patterns should install as shadcn registry items. The guide separates reusable primitives from workflow blocks so teams can adopt the smallest useful piece first.
Install
Registry Commands
npx shadcn@latest list https://raw.githubusercontent.com/arielconti10/agentic-craft/main/public/r/registry.jsonnpx shadcn@latest view https://raw.githubusercontent.com/arielconti10/agentic-craft/main/public/r/source-backed-artifact.jsonnpx shadcn@latest add https://raw.githubusercontent.com/arielconti10/agentic-craft/main/public/r/source-backed-artifact.jsonA local dev server serves the same payloads at /r/ for previewing.
registry:ui
Primitives
Primitives are small, composable surfaces: composer, source preview, observable work, decision surface, artifact document, memory rows, and usage meters.
| Item |
|---|
Composer composer |
Tool Call tool-call |
Tool Tree tool-tree |
Reference Item reference-item |
Status Indicator status-indicator |
Observable Work observable-work |
Decision Surface decision-surface |
File Lifecycle file-lifecycle |
Agent Status Table agent-status-table |
Clarifying Questions clarifying-questions |
Action Preview action-preview |
Source Preview source-preview |
Artifact Document artifact-document |
Usage Meter usage-meter |
Contextual Workbench contextual-workbench |
Effective Policy Preview effective-policy-preview |
Memory Ledger Item memory-ledger-item |
Run Trace run-trace |
Handoff Packet handoff-packet |
Composer
composer
A composable AI chat input with stacked island panels, file attachments, suggestion chips, and context usage visualization.
Tool Call
tool-call
Universal tool call component with running/completed/failed status states. Works standalone for sequential calls or inside ToolTree for parallel execution.
Tool Tree
tool-tree
A composable tree visualization for parallel tool calls with L-connectors, expandable children, and hover timestamps. Wraps ToolCall children.
Reference Item
reference-item
A composable item row for sources, memories, findings, files, tasks, and agent activity with media, metadata, and action slots.
Status Indicator
status-indicator
The product-wide status vocabulary: one shape per state — check for complete, spinner for active, dashed circle for pending, clock for blocked, alert for warning and error — with sr-only labels.
Observable Work
observable-work
A step disclosure pattern for showing visible agent work, touched sources, state, and completion without exposing hidden reasoning traces.
Decision Surface
decision-surface
A composable confirmation surface for approvals, risky actions, clarifying interruptions, and rollback decisions.
File Lifecycle
file-lifecycle
A file attachment lifecycle pattern for drag states, validation, upload progress, rejection, retry, and removal.
Agent Status Table
agent-status-table
A rich operational table for multiple agents with status, active task, progress, confidence, cost, and last activity.
Clarifying Questions
clarifying-questions
A controlled question group for collecting missing requirements through text, single-choice, and multiple-choice prompts.
Action Preview
action-preview
A locked consequence preview for approvals, external actions, document changes, and rollback-aware agent work.
Source Preview
source-preview
A citation and provenance preview card with source title, excerpt, location, navigation, and open-source action.
Artifact Document
artifact-document
A source-backed output document surface with cited sections, missing-source states, version metadata, and review status.
Usage Meter
usage-meter
A compact token, cost, limit, and coverage meter for visible agent run budgets.
Contextual Workbench
contextual-workbench
A responsive agent workbench that keeps chat visible while opening an inspectable browser, source, diff, or artifact surface beside it.
Effective Policy Preview
effective-policy-preview
A compact settings summary showing the agent policy currently produced by autonomy, approval, notification, and memory controls.
Memory Ledger Item
memory-ledger-item
A provenance-rich memory row with scope, expiry, last-used metadata, source inspection, edit, and removal actions.
Run Trace
run-trace
A dense operational trace for background runs with source touches, status, warnings, timing metadata, and expandable recovery detail.
Handoff Packet
handoff-packet
An ownership-transfer surface for multi-agent workflows with sender, receiver, payload, source basis, receiver action, and recovery path.
registry:block
Workflow Blocks
Blocks compose primitives into product-ready workflow specimens. They are the registry equivalent of the guide's Templates section.
| Item |
|---|
Review Workflow review-workflow |
Approval Workflow approval-workflow |
Clarifying Workflow clarifying-workflow |
Source-Backed Artifact source-backed-artifact |
Memory Review memory-review |
Background Run Monitor run-monitor |
Multi-Agent Handoff multi-agent-handoff |
Agent Settings agent-settings |
Review Workflow
review-workflow
An end-to-end agentic review workflow block with observable work, source-scope clarification, locked action preview, and approval.
Approval Workflow
approval-workflow
A human-in-the-loop approval block with observable preparation, locked action preview, policy reason, expiry, and decision surface.
Clarifying Workflow
clarifying-workflow
A missing-decision collection block with structured answer options and a paused observable-work trace.
Source-Backed Artifact
source-backed-artifact
A provenance workflow block that pairs a source-backed output document with source previews and usage budget.
Memory Review
memory-review
A memory review queue block with provenance, scope, expiry, source preview, and save/reject decision.
Background Run Monitor
run-monitor
A background run monitoring block with an operational trace, visible run budget, agent status table, warnings, and blocked recovery path.
Multi-Agent Handoff
multi-agent-handoff
A multi-agent ownership transfer block with handoff packet, sender/receiver state, source basis, recovery path, trace, and agent status table.
Agent Settings
agent-settings
A durable agent policy settings block with clickable switch labels and effective policy preview.
Quality gates
Before Publishing an Item
State coverage
Normal, active, blocked, completed, empty, and error states are documented or shown.
Mobile behavior
Touch targets, wrapping, source sheets, and compact composer states are verified at 390px.
Source ownership
The item makes affected object, source, owner, cost, or policy visible when relevant.
Install proof
The item passes registry build and can be viewed through shadcn CLI.