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 app. No hype, just the systems, the stack, and the lessons learned the hard way while shipping.

Justin Tsugranes·May 9, 2026·4 min read
On this page
  1. The Problem with Single-Prompt Narratives
  2. The Architecture: Agentic Engineering
  3. The Stack: Built for Durability
  4. Lessons Learned the Hard Way
  5. Shipping Today

Most AI applications are thin wrappers around a single prompt. When I started building an ai story app called Inky, I realized that approach fails the moment the narrative gets complex. If you want to move beyond simple text generation and into actual storytelling, you have to stop thinking like an author and start thinking like a systems architect.

Inky is a multi-product studio project designed to handle long-form, coherent narrative generation. It doesn't just 'write a story.' It orchestrates a team of specialized agents to plan, draft, and refine a world. This is what I call agentic engineering—moving the complexity out of the prompt and into the system architecture.

The Problem with Single-Prompt Narratives

If you ask a standard LLM to write a 5,000-word story, the quality degrades by word 1,000. The plot wanders, characters lose their traits, and the prose becomes repetitive. This happens because the context window, while large in modern models, isn't a substitute for structured memory.

When building an ai story app, you're solving for state management. You need to track what has happened, what is supposed to happen, and the specific 'voice' of the narrative across multiple calls. A single prompt cannot hold the weight of a complex world while also executing high-quality prose.

The Architecture: Agentic Engineering

Inky runs on a custom orchestration layer I built called VERA. Instead of one massive call, the system breaks the process into discrete stages handled by specialized agents:

  1. The Architect: Responsible for world-building, character bios, and the overarching plot arc. It outputs JSON, not prose.
  1. The Plotter: Breaks the arc into chapters and scenes, ensuring the pacing holds. It manages the 'beats' of the story.
  1. The Narrator: This agent focuses purely on prose. It receives the scene beats and the character context, then writes. It doesn't have to worry about where the story is going; it only worries about the current moment.
  1. The Editor: Reviews the output for consistency and tone, suggesting revisions back to the Narrator if the quality drops.

By separating concerns, the system maintains a higher level of quality than any single model could achieve alone. This is the difference between a tool that helps you write and a system that builds with you.

Keep reading

Related posts

All posts→
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

The Stack: Built for Durability

I don't build with the latest 'game-changer' framework just because it's trending. I use a stack that allows me to ship today and maintain the system a year from now without a team of twenty.

  • Monorepo: I keep everything in one place. It reduces the friction of managing shared types between the agent orchestration and the frontend.
  • Claude API: I've found Claude's nuance in creative writing and adherence to complex JSON schemas to be superior for this specific use case.
  • MCP Servers: I use Model Context Protocol to give my agents access to local research databases and previous story bibles. This keeps the context window clean and the agents informed.
  • PostgreSQL with pgvector: Story state and character embeddings are stored here. When the Narrator needs to remember a detail from three chapters ago, the system performs a vector search to inject that specific context into the prompt.

Lessons Learned the Hard Way

Building an ai story app taught me that the hardest part isn't the AI—it's the plumbing.

I learned the hard way that over-automating the 'Editor' agent can lead to a feedback loop where the prose becomes bland. The system needs human-in-the-loop checkpoints. Inky allows the user to intervene at the 'Plotter' stage. If the bones of the story are wrong, no amount of agentic refinement will save the skin.

Another lesson: cost scales faster than you think. Running four or five agents per scene is expensive. I had to implement a caching layer for world-building context to avoid re-sending the same 2,000-word 'Story Bible' with every single API call. Efficiency in token usage is as important as the quality of the output.

Shipping Today

Inky isn't a theoretical exercise. It's a working system that I use to test the limits of multi-agent orchestration. The goal isn't to replace the writer, but to provide a system that handles the cognitive load of consistency, allowing the builder to focus on the craft.

If you are building an ai story app, stop looking for the perfect prompt. Start building the system that manages the prompts for you. The value is in the architecture, not the model.

If you're working on something similar or want to see the implementation details of the VERA orchestration layer, I'm happy to talk.

Next Step: Review your current AI workflow. Identify one area where you are relying on a single long prompt and see if you can break it into two specialized agents with a shared state.

Full implementation details are available in The Builder's Playbook — justintsugranes.dev/resources/builders-playbook

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#architecture#shipping#agentic-engineering

On this page

  1. The Problem with Single-Prompt Narratives
  2. The Architecture: Agentic Engineering
  3. The Stack: Built for Durability
  4. Lessons Learned the Hard Way
  5. Shipping Today
Building an AI Story App: Systems Over Prompts
Jun 2, 2026

Building an AI Story App: Systems Over Prompts

Stop building wrappers. Here is how I architected Inky, a multi-agent storytelling engine, using agentic engineering and a profit-first mindset.

aiarchitectureagentic-engineeringinky
Building an AI Story App: Lessons from the Inky Architecture
May 31, 2026

Building an AI Story App: Lessons from the Inky Architecture

A look inside the architecture of Inky. I’m sharing what I learned the hard way about agentic engineering and building an AI story app that actually ships.

aiarchitectureshippinginky