Building a Visual Agentic Tool for AI-First Workflow Transformation

craft · Tech · 2026 · source Agentic: yes · promotional bias: med · source-backed · extracted with prompt 0.5.4 (schema v2)

Generated from extraction.json — do not edit by hand. Every claim cites verbatim source evidence; stated means the quote directly asserts the claim, implied means it supports it indirectly.

Problem

Domain: AI-native work transformation

Craft needed an AI workflow tool that was genuinely useful for engineers and non-engineers after years of AI features that created initial interest but little repeat usage.

Constraints:

Architecture

Craft Agents is a visual, open-source wrapper around Claude Code and the Claude Agent SDK. It connects Craft Docs, APIs, databases, MCP servers, Zendesk, Linear, and backend APIs as sources; supports parallel agents, workflows, labels, themes, and skills; and provides read-only, ask-to-edit, and auto modes so non-engineers can run agent workflows without a terminal.

Diagram confidence: explicit (topology described by the source).

flowchart LR
  craft-user[Craft User] --> craft-agents[Craft Agents]
  craft-agents --> claude-agent-sdk[Claude Agent SDK]
  claude-agent-sdk --> claude-code[Claude Code]
  craft-agents --> sources[Sources]
  sources --> credential-injection[Credential Injection]
  craft-agents --> permission-modes[Permission Modes]
  craft-agents --> workflow-skills[Workflow Skills]
  workflow-skills --> zendesk[Zendesk]
  workflow-skills --> linear[Linear]
  workflow-skills --> sources
Drag to pan · scroll or use +/− to zoom · reconstructed from the source's described component topology

Components

Component Role Interacts with
Craft User Engineer or non-engineer running workflows for support, marketing, HR, finance, or product work. Craft Agents
Craft Agents Visual Electron agent client with parallel agents, workflows, labels, skills, themes, and source management. Craft User, Claude Agent SDK, Sources, Permission Modes, Workflow Skills
Claude Agent SDK Agent library underneath the Craft Terminal and Craft Agents experience. Craft Agents, Claude Code
Claude Code Top-tier coding/agent model interface used to build and operate Craft Agents workflows. Claude Agent SDK
Sources Craft Docs, APIs, databases, MCP servers, Zendesk, Linear, backend APIs, and other data sources exposed to agents. Craft Agents, Credential Injection
Credential Injection Layer that adds credentials to API-source requests without exposing sensitive credentials to the agent. Sources
Permission Modes Explore/read-only, Ask to Edit, and Auto write modes controlling source mutation. Craft Agents
Workflow Skills Reusable workflows for triage, bug reports, education requests, daily reports, user data, and feature requests. Craft Agents, Sources
Zendesk Support ticket backend and source for customer-support workflows. Sources, Workflow Skills
Linear Engineering issue tracker used to find similar bugs or create new issues. Sources, Workflow Skills

Data flow

A user starts a Craft Agents session, selects sources and a permission mode, invokes a workflow or skill, and the agent reads Craft Docs plus external sources such as Zendesk, Linear, backend APIs, databases, or MCP servers. For support cases, it enriches a ticket with user details, searches code/Linear for root cause, drafts a customer response, and creates engineering tickets when needed.

3 supporting quotes
“Balint added the concept of “Sources” to the Craft Terminal: the ability to add other data sources – APIs, databases, MCP servers – on top of Craft Docs.”article, stated
“The skill defines data sources (Zendesk and Linear) and defines the required output (a structured analysis with tags and categories).”article, stated
“In Zendesk, the support agent gets a suggestion on how to respond to the customer. The bug is automatically reported to the engineering team, if necessary”article, stated

Why this architecture

Craft moved from product-embedded AI features to a visual agentic workflow tool because the useful breakthrough was not another text assistant but a source-connected, permissioned, non-terminal interface that made agents usable across the company.

3 supporting quotes
“However, the terminal interface was not beloved by Craft’s users. On December 18, he shared the Craft Terminal Agent with 15-20 external beta users. Feedback was positive and they liked it, but there were complaints about the terminal environment: * Multitasking was painful”article, stated
“> “Can we turn the terminal into something that’s more like an email client or a Slack client? Something that is more natural to use for anyone.””article, stated
“Internally, Craft Agents was an instant hit. During release week customer support, marketing, and HR all jumped on the tool, and people started automating previously manual tasks. In an unexpected development, non-technical folks started using Craft Agents more than devs!”article, stated

Models used: OpenAI GPT-3.5 · OpenAI GPT-4o · Opus 4.5 · Claude Code · Claude Agent SDK

Scale

Alternatives considered (roads not taken)

Ship AI features before a true wow moment

Rejected because: Craft wanted to avoid users associating AI with gimmicks or uselessness.

“> “We knew we had one shot at showing users that AI is useful for them. And until we had a ‘wow’ moment ourselves, we would not go all-in on AI. We didn’t want Craft to have the same negative associations with AI as Copilot has”.”article, stated

Terminal-only Craft Terminal interface

Rejected because: External beta users liked the tool but found multitasking, plan review, and non-technical use awkward.

"there were complaints about the terminal environment:

— article, stated

Use Zendesk as the full customer-support workflow UI

Rejected because: Craft increasingly treated Zendesk as a backend and preferred API-first workflow control through agents.

“> All our customer support flows now run through Craft Agents. We only use Zendesk as a backend. > > I want us to move to an API-first customer support solution. It feels to me that Zendesk is a really complex UI, one that is really slow, has bad API hooks, and just keeps breaking our flow.”article, stated

Merge open-source pull requests directly

Rejected because: Craft used PRs as high-fidelity feature requests and rebuilt ideas to preserve product coherence.

“I prefer to use PRs as a high-fidelity feature request, and then redesign and rebuild the underlying feature so it fits Craft Agents”article, stated

Patterns

tool-use-orchestration (agent workflow)

Craft Agents connects APIs, databases, MCP servers, Craft Docs, Zendesk, and Linear as sources and routes workflows through skills.

“anything from databases, through to APIs and MCPs.”article, stated

multi-agent-orchestration (agent workflow)

The tool supports running parallel agents for bulk triage and other parallelizable workflows.

“Support for running parallel agents, visualization, and switching between them.”article, stated
“are helpful for processing triage tasks in bulk. When there’s a large number of customer tickets”article, stated

safety-policy-enforcement (governance)

Permission modes define read-only, ask-before-edit, and automatic-write behavior per session.

“readonly. The default mode for agents. They can read all sources but not write to them.”article, stated

human-in-the-loop-gate (governance)

Ask to Edit mode keeps user confirmation in front of write operations when appropriate.

“needs prior user confirmation. _This mode is typically only used for onboarding”article, stated

privacy-preserving-processing (security)

API sources inject credentials outside the agent so the agent can call tools without seeing sensitive credentials.

“Craft Agents hijacks the request and adds the credentials needed without the agent having access to those sensitive credentials.”article, stated

Tradeoffs

Agent interface

Chose Visual UI wrapper around Claude Code over Terminal-only agent interface.

Rationale: The visual interface unlocked non-engineer use, parallel review, and easier plan/code-change inspection.

“Balint felt the terminal was holding the tool back.”article, stated

Source permissions

Chose Explore, Ask to Edit, and Auto modes over Unrestricted agent writes or read-only-only agents.

Rationale: Different workflows need different risk levels; onboarding often uses discussion first and automation later.

“This mode is typically only used for onboarding – users often use Explore to discuss, and Auto to get work done.”article, stated

Model/tooling cost posture

Chose Use the best models and tools first over Prematurely optimize AI spend.

Rationale: Craft wanted to unlock productivity first, then design a workflow around the new capability.

“Use the best (most expensive) models and tooling to unlock orders-of-magnitude productivity gains.”article, stated

Vendor strategy

Chose API-first customer-support backend over UI-first SaaS with weak APIs.

Rationale: Once agents own the workflow, slow custom vendor UIs become a bottleneck and APIs become the real product surface.

“I want us to move to an API-first customer support solution.”article, stated

Gotchas (what bit them)

AI features can drive initial adoption without becoming useful repeat workflows.

Root cause: Craft's early AI assistant and RAG/summarization experiments lacked sticky, high-value workflows.

Resolution: Wait for a genuine wow moment, then deploy source-connected agent workflows that solve recurring team problems.

“After an initial engagement spike, people didn’t use the AI assistant repeatedly.”article, stated
“nothing really stuck with users.”article, stated

Terminal UX blocked non-engineer adoption.

Root cause: Multitasking, reviewing plans, and the terminal environment felt inaccessible to non-technical users.

Resolution: Rebuild the experience as a visual Electron app with email/Slack-like affordances.

“The whole experience felt “locked away” to most users who are non-technical and not developers”article, stated

AI-native change can disrupt engineer identity and retention.

Root cause: The value of remembering codebase details and hand-writing code decreased suddenly for some engineers.

Resolution: Acknowledge different adoption stages and create impossible-goal exercises to produce personal wow moments.

“Several engineers are struggling with the sudden change and there have been resignations, as a result.”article, stated

Accepting many open-source PRs can erode product coherence.

Root cause: PRs often optimize for local needs rather than the whole product direction.

Resolution: Use PRs as signals and rebuild the underlying feature in a coherent design.

“If we took contributions as PRs submitted, the product would become a patchwork of local optimizations.”article, stated

Evaluation

Craft judged AI usefulness by user stickiness, workflow adoption, support-time reduction, engineering migration outcomes, company-wide usage, and whether teams could achieve previously impossible weekly goals.

Metrics: Repeat usage / stickiness · Support ticket processing time · Ticket escalation rate · Number of workflows/skills built · Linear issues completed per week · Migration duration · Deploy-time reduction · Model spend and subscription usage

3 supporting quotes
“This pattern of initial interest followed by abandonment is a critical signal in LLMOps that a feature hasn't found genuine product-market fit.”summary, stated
“The team usually comes up with a stretch goal at first; something that would probably take two or three weeks.”article, stated
“Some engineering teams inside Craft now go through 100+ Linear issues per week, when previously the most they did was 15-20.”article, stated

Outcomes

The article is source-rich but has family-tie context and narrative framing; metrics are Craft-reported.

3 supporting quotes
“During just two weeks of using Craft Agents, the customer support team have built these skills:”article, stated
“Marketing used to have a hard dependence on engineering to build websites, but now they do it on their own!”article, stated
“The projected annual compute resource savings are nearly $3,000!”article, stated