Skip to main content

Loading…

Skip to main content
HomeProjectsPostsContact
Justin Tsugranes LogoJustin Tsugranes Logo

Justin Tsugranes

HomeProjectsPostsContact

Stay in the loop

Occasional notes on what I'm building, lessons earned, and the studio behind it.

By subscribing, you agree to receive No spam. Unsubscribe in one click anytime. from Justin Tsugranes. No spam. Unsubscribe anytime. Privacy Policy

© 2026 Total Ventures LLC. All rights reserved.

Privacy PolicyTerms of ServiceCookie Policy
Building an AI Story App: Architecture and Lessons from Inky | Justin Tsugranes | Justin Tsugranes
Xinf
Building an AI Story App: Architecture and Lessons from Inky
←Posts

Building & Operating

Building an AI Story App: Architecture and Lessons from Inky

A look inside the architecture of Inky, a multi-agent storytelling system. No hype, just the systems and lessons learned from shipping an AI-native product.

Justin Tsugranes·May 14, 2026·4 min read
On this page
  1. The Architecture of Agentic Storytelling
  2. The Director Agent
  3. The Archivist
  4. The Writer
  5. Managing State in a Generative Environment
  6. What I Learned the Hard Way
  7. The Studio Operating Model
  8. Shipping the Future of Narrative

I am shipping Inky today. It is a digital storytelling platform where the narrative isn't just generated—it is architected.

When I started building an ai story app, I realized quickly that the market is flooded with thin wrappers. Most people are sending a single prompt to an LLM and calling it a product. That approach breaks the moment you need narrative consistency, character depth, or a plot that doesn't collapse under its own weight after three chapters.

Inky is different. It is built on a system of agentic engineering where AI isn't just an autocomplete feature; it is the team. Here is how the system works, what I learned the hard way, and why the architecture matters more than the model.

The Architecture of Agentic Storytelling

Building an ai story app requires moving away from the 'one prompt' mentality. In Inky, the storytelling process is broken down into discrete roles handled by specialized agents. I use a custom orchestration layer I built called VERA to manage these handoffs.

The Director Agent

This agent holds the high-level state. It doesn't write prose. It manages the story arc, ensures the pacing is correct, and decides when a new character needs to be introduced. It acts as the source of truth for the narrative's direction.

The Archivist

One of the biggest hurdles in building an ai story app is the context window. Even with 200k tokens, a long-form story will eventually lose its thread. The Archivist agent manages a vector database of 'world facts' and 'character memories.' When the Writer agent needs to know what color a character's eyes were in chapter one, the Archivist fetches that specific metadata.

The Writer

This agent is the only one focused on prose. By isolating the writing task from the structural task, the quality of the output stays high. It receives a brief from the Director and context from the Archivist, then executes the scene.

Managing State in a Generative Environment

In a traditional CRUD app, state is predictable. In a generative system, state is fluid. I learned the hard way that you cannot rely on the LLM to remember the state of the world. You have to externalize it.

I use a monorepo architecture to keep the frontend, backend, and agent logic tightly coupled. The state is stored in a structured Firestore database, not just in a chat history. Every character has a JSON schema. Every location has a set of attributes. When an agent modifies the world, it updates the database first. The next prompt is then built from that structured data.

This ensures that if a character loses a sword in chapter two, the system knows they don't have it in chapter five, regardless of how many tokens have passed in between. Architecting systems like this is what separates a toy from a tool.

Keep reading

Related posts

All posts→
EditorialB
Jun 5, 2026

Building an AI Story App: Systems Over Hype

A look inside the architecture of Inky, an AI storytelling app. No buzzwords, just the systems and agentic engineering required to ship a durable product.

aiengineeringsystems-architecture

What I Learned the Hard Way

Shipping today means dealing with the reality of latency and cost. When you have multiple agents talking to each other before a single word is shown to the user, the 'time to first word' can be brutal.

I had to implement a multi-stage streaming strategy. The Director and Archivist do their work in the background while the UI shows the user the 'intent' of the next scene. This transparency keeps the user engaged while the heavy lifting happens behind the scenes.

Another lesson: prompt engineering is a temporary fix for architectural debt. If you find yourself writing a 2,000-word prompt to get a specific output, your system design is likely the problem. Break the task down. Use smaller, more specific agents. It is cheaper, faster, and more reliable.

The Studio Operating Model

I run a multi-product studio where AI is the team. This means I don't hire a fleet of developers to build these features. I architect the systems that allow agents to handle the heavy lifting of research, monitoring, and initial code passes.

Building an ai story app as a solo operator is only possible because of this leverage. I am not writing every line of CSS; I am directing the agents that build the components. This allows me to focus on the pattern recognition across domains—applying logistics principles from my time in the Army to the data flow of a narrative engine.

Shipping the Future of Narrative

Inky is a working in public project. It is not a finished 'paradigm shift'—it is a tool that is getting better with every commit. The goal isn't to replace the author, but to provide an architected environment where stories can grow without the friction of manual world-building.

If you are building an ai story app, stop focusing on the prompt and start focusing on the system. The model is just the engine; the architecture is the vehicle.

I am happy to talk about the specifics of the VERA orchestration layer or the monorepo setup I use for these builds.

Full implementation details are available in the resources below.

Work through this in a 1:1 strategy session through Total Ventures — totalventures.io/booking

Recommended$79

The Builder’s Playbook

How I run a multi-brand studio with AI agents — the systems, not the hype.

  • •The agent-augmented operating model
  • •Real workflows you can copy
  • •From idea to shipped, repeatably
Get the playbook →
If this resonated

The studio is where the rest of it lives.

Total Ventures is the umbrella — the products, the resources, the strategy session.

totalventures.io
  • Resources

    Launch Checklist + the Builder’s Playbook bundle.

  • Strategy session

    A focused hour on your repo, stack, and monetization.

  • The brands

    The portfolio of products I’m building, end to end.

Studio Notes

How I’m building the studio.

The operator’s log — systems, decisions, and what’s working.

JT

Written by

Justin Tsugranes

Founder, Total Ventures

Solo-founder building a multi-brand product studio with AI agents. Writing about building, operating, and shipping.

ShareXLinkedInFacebook
#ai#engineering#inky#systems-architecture#shipping

On this page

  1. The Architecture of Agentic Storytelling
  2. The Director Agent
  3. The Archivist
  4. The Writer
  5. Managing State in a Generative Environment
  6. What I Learned the Hard Way
  7. The Studio Operating Model
  8. Shipping the Future of Narrative
inky
Building an AI Story App: Lessons from Shipping Inky
Jun 7, 2026

Building an AI Story App: Lessons from Shipping Inky

I am building Inky, an AI storytelling app. Here is the architecture, the failures, and the systems required to ship a generative product that actually works.

aiarchitectureinkyshipping
Building an AI Story App: Lessons from the Studio Floor
Jun 6, 2026

Building an AI Story App: Lessons from the Studio Floor

Inside the architecture of Inky. A look at agentic engineering, narrative coherence, and the lessons learned the hard way while building an ai story app.

aiarchitectureagentic-engineeringinky