Skip to content
Agentic Craft

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.

Open registry.json19 primitives8 blocks

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.json

A local dev server serves the same payloads at /r/ for previewing.

Primitives

Primitives are small, composable surfaces: composer, source preview, observable work, decision surface, artifact document, memory rows, and usage meters.

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.

Workflow Blocks

Blocks compose primitives into product-ready workflow specimens. They are the registry equivalent of the guide's Templates section.

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.

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.