Agentic system design, grounded

Turn a use case into
a grounded agentic system design.

Agentify is an agent skill that works like a seasoned AI solutions architect. Describe what you want to build, answer a few questions, and get a detailed, defensible system design document with embedded diagrams, where every decision cites an authoritative source.

$ npx skills add avnath13/agentify -g
Generated architecture for an enterprise support agent: guardrails, an intent router, an agent runtime with permission-aware retrieval, tools, a human-review gate, and an eval and observability loop Generated architecture for an enterprise support agent
A generated architecture, drawn with agent-native components. One figure from the support agent design.

Five diagram types, one vocabulary

Every design embeds diagrams drawn by the bundled engine, with a component vocabulary built for agentic systems.

Architecture diagram example

Architecture

Components, trust boundaries, and how requests flow between them.

Sequence diagram example

Sequence

The primary request path, including guardrail and retrieval hops.

Data-flow diagram example

Data flow

Ingestion and retrieval pipelines, PII boundaries, and freshness.

Workflow diagram example

Workflow

The orchestration pattern: routing, chaining, and lanes.

Lifecycle diagram example

Lifecycle

State machines: an agent run, a ticket, an order, with retries and exits.

Agent-native components: agent, router, retriever, vector store, guardrail, eval loop, human review, tool, memory, queue, ASR, TTS.

Grounded, not guessed

Asking an LLM to "design an agentic system" produces plausible but ungrounded output. Agentify forces the design through the published engineering canon.

The escalation ladder

Forces the design up from deterministic code, to a single LLM call, to workflows, to an agent, to multi-agent, with a written justification for every climb and an anti-escalation rule for when a simpler rung wins.

Seven decision trees

Do you need generative AI at all, RAG vs fine-tuning vs long context, single vs multi-agent, autonomy tiers with enforcement gates, and memory tiers.

Domain-harm analysis

Asks what happens if the system is wrong or abused, and scales the guardrails to that harm, not to company size.

Right-sizing

Classifies a design lightweight or enterprise and sizes the document to match, so a small feature is not buried in tenant-isolation and DR ceremony.

Cited knowledge base

Vendor agent guides, model and platform primitives, cloud well-architected frameworks, peer-reviewed surveys, OWASP, NIST, MCP, OpenTelemetry, agent benchmarks, and voice and multimodal design, spot-checked against primary sources.

A self-contained deliverable

One HTML file with a theme toggle, a table of contents, print-to-PDF, and embedded interactive diagrams. No dependencies, no network calls.

How it works

A conversation, then a document.

Clarify

It asks only the questions whose answers would change the design: data and permissions, autonomy, load, latency, cost, compliance, and what harm a wrong answer causes.

Decide

It walks the decision trees, recording the answer, the reasoning, and the citation at every gate, including the alternatives it rejected.

Design

It writes the document section by section against an enterprise bar, doing the capacity and cost math with live-sourced pricing.

Deliver

It renders the diagrams, assembles a self-contained HTML document, and runs a final gate checklist that rejects any unjustified or uncited claim.

Quick start

Install the skill, then describe what you want to design.

1. Install

Add it to Claude Code, Codex, Cursor, and more:

$npx skills add avnath13/agentify -g

2. Describe your use case

In your own words, for example:

"Design an AI agent that triages our inbound sales leads: reads the inquiry, enriches from our CRM, scores it, and drafts a reply for a rep to approve. About 300 leads a day."

3. Answer a few questions, get the design

Agentify asks only what would change the design, walks its decision trees, and writes a self-contained <use-case>.design.html. Prepping for a system design interview instead? Just say "interview mode".

Copied