Hi everyone. In this video, we're going to dive into my concepts around folder as a workspace and architecture.

What it means to use AI in a way that will actually probably last the next decade and what I think the.

Industry is actually moving towards.

Now, if you've seen any of my other videos, I'm sure you've seen screenshots or snippets of crazy folder structure I'm doing.

Where I'm routing Claude to different folders, my markdown files, using skills at certain times, creating animations.

Or code with it. I have all sorts of different ways I'm doing it, but I don't think I have a video.

Out there that really dives into how I structure it and teaching you to do that.

And I decided to go ahead and create a kind of template folder to walk you through all of this.

This is something you could use to be able to apply to any of your workflows,.

Build through it, understand it, and kind of explore,.

You know, building your own version of this.

Now, throughout this video, I'm actually going to teach some concepts along the way for people who are not familiar with maybe.

VS Code, which is the workspace I'm working in.

Don't worry, you don't need VS Code to do the things I'm showing you.

You can do it within Claude, but I just want to describe like what markdown is, what it means to have an.

IDE, all of these things. And if you are familiar with these, you're software engineer, you probably are, don't worry, I'm still.

Going to be diving into the specifics and I think you're going to get a lot of out of this either way.

However, sometimes it's also nice to just dive back into the fundamentals.

So, let me paint a little scene for you.

Right now, most people, if they are even I which fun fact about 84% of the nation is still not fully using.

It, but log in and use Claude or ChatGPT or Gemini and they're typing things.

They're diving in.

Um, maybe they get something back, they start another conversation,.

Start over, and sometimes they're able to share context between conversations, right?

Like ChatGPT and Claude can do that.

I can say, you know, tell me a software stack for Visual Lore, which is a software that I was working on.

For another company, and it's able to go and look through our older conversations, which is nice.

That's a little bit of extra there, but it's still not, you know, it's not able to look at files, have persistence,.

Things like that. And you're constantly having to make these huge prompts.

Maybe you have some sort of prompts that you save and throw in or documents,.

And you're throwing it in, and then you have to start a new conversation.

Throw it in, start a new conversation.

You hit a wall, there's too many tokens, right?

All sorts of problems there.

And don't get me wrong, there's some really good prompt engineering techniques out there, but at the end of the day,.

AI can only hold so much in a single.

Information or chat area, and even further, that's not your workflow.

Having to have it create a whole bunch of stuff and then re-edit it again, it's it's not sustainable, it's not scalable.

Now, for those of you who don't understand.

Why they struggle so much, essentially, AI reads everything, all of your sentence, and measures it by something called tokens.

A token is roughly three quarters of a word or a single word sometimes.

The word hamburger could be three tokens.

Ham-bur-ger,.

Hamburger.

The term comes from NLP research in the '90s.

A bunch of researchers needed a unit smaller than a word because language doesn't all break the same way, right?

So, they borrowed token from linguistics, which borrowed it from Old English tucken,.

Which means a sign or a symbol.

A token is just the smallest.

Meaningful.

Chunk of a sentence or a word.

There's only so much tokens an AI can have in its context.

Window before it starts failing. When people say context window, they mean how many tokens the AI can see at once, and.

That window is in fact finite.

So, if you dump everything into one file, an AI writing a blog post is also reading your video production notes.

You're burning tokens on stuff that doesn't matter.

So, instead of building one big file, you want to separate your thoughts, your ideas, your work into separate areas.

This is something I created for all of us.

It's called a workspace blueprint.

Here, you have three workspaces.

And again, this is an example.

You don't always have to do this.

But each one handles a different kind of work.

One for the community, right? Maybe I have this one for working on content and docs in the community.

Production, right? What am I building?

What are scripts? Maybe I'm creating animations.

Writing room. Maybe I need to have some sort of process of thinking or I have a client list or insert as.

Many things as I have there.

And we're going to dive deeper into it.

This is a space that does the job well because you can circumnavigate.

An AI seeing everything and only direct it to what you want.

Let me explain how that actually works though.

So, I'm going to show you inside of VS Code, which is an IDE,.

Basically a developer environment that allows people to kind of look at folders in a different way.

So, instead of having to click into the folders like you just saw here,.

I can just open the folders and see everything and open the files without having to double-click the files, right?

So, instead of having to double-click this text document and opens another window, I can just bounce between them.

It's much cleaner, much easier. Even if you're not into code, it looks overwhelming.

I promise you all of this is just natural language.

This literally reads like a document.

So, this is a markdown file.

If you haven't seen them before, markdown is just a text file with some lightweight formatting, right?

You have dashes for bullets.

You have hashtags.

Or pound symbols if everyone else remembers when they were just called that for headers.

Um, you have all sorts of stuff like asterisks.

For bolding or doing things in that way.

And there's a lot of programs that can actually run this to look a certain way.

In fact, your Claude does exactly that.

If you look, when you're talking to an AI, it's writing in markdown already.

These boldings, these lines, all of these things.

Watch what happens when I copy this.

All of that formatting disappears.

When I paste it into here, and it turns into markdown.

Because that's how it's making it look like that.

Markdown is just a good way to format text.

If you're curious, there's a man named John Gruber.

He actually created this in 2004.

The whole idea was write something that's readable as plain text, but can also render.

Into a formatted document.

He named it markdown.

As a play on markup language, which is the same stuff that HTML,.

Right? The stuff that builds websites,.

Hypertext.

Markdown language. And all it does is mark stuff down with tags.

Markdown strips all the tags and absurdity away and makes it look like something simple like this.

But again, you're probably not here for this.

You're here for the file system.

So, let's move on to that next step.

So, in this specific folder, which is an example, it runs on essentially three.

Layers, and there's a reason for each one.

If you look at my Claude.md,.

My Claude markdown file, this is something that my AI will read every time it's in any one of these folders.

So, this is something that the AI will always have and always read.

So, imagine.

It's you're just copying and pasting this into Claude code or into Claude every time you open it.

Now, you can actually just type in to Claude read the Claude.md.

In this case, it's Claude code.

You could be working inside of Claude co-work as well, which is again a video I have on how to install, and.

It can operate inside of folders in case the VS code is too much for you.

Um but just read the Claude.md and tell me what this is.

Before you had to copy and paste, do all these things.

It had to read.

The every file that's in here.

In this case, it reads the Claude.md.

And immediately, without having to read everything else, understands.

The product, the process,.

What's going on, my writing room, my production, my community.

It knows where to find it, what the file names are.

All from just a single text prompt that allows it to understand where to go, what to do, what are these areas.

But let me describe this a little simpler for those of you who might, you know, feel like this is a bit.

Overwhelming. Layer one in this is the map.

This is what loads automatically,.

Right? It's looking at it. So you put the stuff the agent always needs to think about, folder structure, naming conventions,.

Where files go. Think of this as the floor plan.

You walk into any room, the floor plan is on the wall, and the agent knows where to go.

Now, layer two.

Is where.

The floor plan tells you to go.

It's the actual rooms. What is your task?

Go here. I want to write a blog post, well then you need to go to here and read this context or.

This markdown file. If you want to build a demo or a video, you need to go here and read this context.

Or markdown file. And this could be one that you wrote by hand, or it could be one that you told Claude.

To wrote. And we're going to dive into that here shortly.

Layer three.

Is the actual workspace itself.

Where do you want your files going?

What content are you doing? If you're writing stuff, where do you want the events to be?

Where do you want newsletters to be?

Where do you want social to be?

And it's just a file system.

Again, if you don't want to work inside of here, you can actually just go straight into the folder.

And just create new folders, new text document.

That can be a prompt, that can be a context, right?

It's that simple, and you can just you can just edit it without any of this.

Look, my uh my claude.md,.

This is what it looks like in if you open up notepad.

Same thing. And nothing breaks when you edit it.

You can type whatever you want in here.

It's just English.

Now, it's good to have it uniform and well, but that's the idea here.

Most people are only doing one one these layers, maybe two.

The reason you want to actually have these three layers is it stops the narrow funnel of AI doing too much all.

At once without allowing you to edit every single part, but still give you the ability to automate the entire process.

So, again, the router,.

The initial Claude at MD or whatever you're naming it, is loaded when you start any task.

The workspace.

Is loaded when you're in the workspace, when you want to do production, it's only reading stuff that's in production as it.

Needs to. When you're doing stuff in the writing room, it's only writing it when you're in the writing room.

For example, go.

To writing room,.

Let's start.

Making.

Something.

Very little prompting, almost terrible prompting.

Yet, the agent, without wasting a whole bunch of co-kens and going through everything, immediately goes to the context.

File that I have in writing room that describes what it is, describes what to load and what not to load, and.

Just describes the folder structure and what the process is.

First, I understand the topic, then I find the angle, then I write it, then I catch problems.

You can also incorporate skills into this, right?

So, you can download the humanizer skill, which is an actual GitHub, I recommend you all check out, or like doc co-authoring.

Skill, which is another.

Set of markdown files or even Python scripts and tutorials that someone else build to do a certain task.

And this is where this whole process is different than just running skills.

You're putting skills inside of a thought process.

And as you can see, right here, we're in the writing room.

Clean slate, no drafts in progress.

Voice is loaded, style is Block Host.

What do you want me to make?

From one single prompt,.

We've gotten it in there. But while that's going on, I can open up another Claude and I can say, "Hey,.

I want to do some work in production."

And it's going to go in there and I can do whatever work I want to do in production, right?

I want to maybe make some designs,.

I want to create some sort of code for workflows in there.

But the real fun happens is when you're building stuff in production with one of your Claude Code instances.

You're writing a script and you can say, "Hey, take the script.

From writing room and let's make an animation.

Out of it in production."

It's moving that file. It's going to go there.

Now, it's going to notice that I don't have any scripts in there when I send this out.

But if I did have a final in there, it's going to go look for it, right?

There's no scripts. Boom, it didn't waste a whole bunch of tokens, it didn't do anything, but it immediately knew, "Oh, well,.

We have to write a script first."

Or if you have a script somewhere else, you can upload it.

You see, most apps or frameworks or agentic things require you to build an agent for each of these.

I need a writing room agent, I need this agent, I need this agent.

But the way in which you approach each task is always different.

Why not just have Claude Code become the agent you need when you're working in the work space.

And you see from there, you get the most important part of this process.

Is just good routing in English language.

Again, this is all just English, right?

File folder names, titles.

It's describing what you want, right?

This right here is the most important pattern in the whole system.

It's just a simple table that tells the AI, "For this task,.

Read these files,.

Skip those files, you might need these skills."

Without this, the AI either reads everything and runs out of the room and just does all sorts of stuff you don't.

Want it to do using way too many tokens,.

Or it guesses wrong about what matters or just doesn't hit what you need,.

Or you can't edit what it creates along the process.

This table eliminates all of those problems.

This This system here gets rid of all of that.

Now, let's go ahead and zoom in a little bit here and actually really look at this kind of folder structure.

Walk through this pipeline. Imagine you're sitting here and you open up production.

And you go to workflows, right?

So, you know you're doing some sort of animation production or insert whatever it is that this folder is as a separate.

Workspace.

As part of a larger tasks flow that you're doing.

Production has a pipeline in itself as well.

Four stages. You have to do a brief, you need a spec, which a specification,.

A build,.

And an output. I have a brief, some sort of script that I want to do.

I have a spec that's generated from that brief, and then goes into the builds, and it builds out the animations, and.

Then finally you have the output.

More importantly,.

This allows me to have one MD file, right?

So, for my production, I can have a ton text for this file system that is generating different types of sub agents.

Or ways to look at it.

Again, I'm not even worried about agents.

I'm just worried about what the workspace is, what I want to do in these workspace.

If I want to understand,.

Look up technical standards, look up design rules, I can find that because I might have that in a doc,.

Right? So, I have components or maybe some way I like to design these systems with my color designs,.

My headers, my quality.

And again, these are all just generated from English super short docs.

These are visual philosophy or what type of tech you want to use.

And it doesn't always have to read that, but maybe during the brief stage, it does, right?

When you're sitting there and you're going through and you're loading the brief, well, I need to make sure you look at.

The tech standards when you're making the brief.

If it's loading the spec, I need to make sure it looks at the design system and our component library, and then.

Maybe it doesn't need to load the deck as well.

And you can swap this around super easily just by looking at it.

This is traditional function calling software routing.

This has existed.

For decades and decades,.

But now it gets to be natural.

Language,.

English.

Now, at this point, many of you are like, "Oh, well, you're just making a bunch of skills."

Technically, yes. Now, for those of you who don't know what skills are, again, I mentioned them earlier.

I I talked about this idea that you can download them from everywhere.

There's PowerPoint skills, and I have other um videos on this.

But at the end of the day, skills.

Are a process.

That someone else figured out and designed a set of packages or folders,.

Just like I'm doing here, to tell Claude how to do something.

The thing is, skills aren't just markdown files with instructions.

Some are just that, but skills work best when they're wired into a system.

One important note, too, is this is where the difference between it's just skills we're creating here and it's a system.

You're actually putting skills.

Inside.

Of your MD. So, in this case,.

I have.

In my context for production, I have the fire outlook, what I want to do, but also,.

Right? This is where you can talk to call skills or MCP servers.

If you don't know what an MCP,.

Model context protocol.

I think that deserves an entire video in itself, but just think of it as a way that the AI can talk.

To other apps and services.

Easier. It's designed to just kind of plug and play it in, rather than you have to create all these custom integrations.

At certain points, we might want the front-end design skill or a web app testing skill or PDF skill.

Or,.

I might want to give Claude the opportunity to look up a skill, find a new skill, or even possibly create one.

You can wire up to 15 skills, 20 skills, 100 skills into a workspace.

Or, you can perfectly add the skills where you would need them inside.

The workspace, rather than having them loaded at all times.

That's the whole idea here is about plug and play and routing.

One other sneaky thing I do to like completely ignore like databases.

Or anything like that, in my Claude MD, the main file at the beginning that shows, you know, every AI or every.

Agent that comes into this workspace can see my entire folder structure navigation,.

I just add naming conventions,.

Right? So, if a file's going to be outputted a certain way, it needs to name it.

For blog drafts, it needs to be like file name,.

Where it's at. Is it draft?

Is it V2? Is it V3?

Example,.

API off guide draft, right? Or same for newsletters.

Here's the year and day, and then here's what it's kind of is, right?

2026 03 launch week. md. So, the AI knows to organize and move stuff, which comes in handy when instead of having.

To navigate through these files or have an agent that's connected to some sort of, you know, SQL database or vector database.

Or query or Postgres or anything like that, I could just say, "Hey,.

Pull.

My.

Uh off demo.

Demo V2.

And build.

A spec from it. It immediately knows, without me doing anything, to look where that V2 demo script would be, because it.

Knows how to find it. It knows to pull it.

Then it knows to read.

The docs associated.

With specs.

And then start building it.

I have zero code,.

Technically speaking,.

Running any sort of Python injection.

Or framework or database.

This is tools that people are building right now.

They're building apps and crazy.

Python stuff, which in some very bespoke cases might be useful, but most of the time for most people, you don't need.

All that extra stuff to get the process and the job done.

The job to be done is more important.

Than this kind of rigid architecture that so many people are building.

You see, the folder.

Becomes your app. This is your UI.

What simpler UI than a folder?

And the best part is, I don't even need to technically click on anything.

I could just talk with my voice to AI, have it do all the text work for me.

The next stage of this, I promise you, within 6 months everyone's going to be doing this, is just talking to your.

Folder setup.

It's going to be designed and set up to be this way.

It's going to be around.

Yours, which leads into a good final point.

How do you make this yours?

This template uses a fake idea with fake process,.

Right? Fake blog posts and demos.

If you're a content creator, writing room might become your script lab.

Production becomes your edit bay,.

Uh whatever. Community becomes a distribution hub, and you're going to remove.

And change these rules to edit your platform,.

Maybe your tone and voice inside of these, right?

So, what is your audience? That's what you want to hear.

It's working developers, 2 to 8 years of experience, technical decision-makers,.

Developer advocates.

It might be something completely different.

You might be in construction or real estate.

But, this is roughly what you would be doing across all of them.

And the best part is, all you need is one subscription to Claude Code, and you can generate.

100, {quote} {unquote}, apps.

That are just folders creating what you need.

Obviously,.

It's much more complicated once you get into breaking down your workflow,.

But if you're a developer, if you're a freelancer,.

Right? Just swap design for engineering and docs, or intake and production and delivery, right?

This workspace changes lately, but the three-layer.

Routing system,.

The idea that you go.

From, "Hey,.

Look at this area.

This is what you're going to."

To lower-level context ones, to lower-level skills,.

Is the idea here. It's just layers.

This isn't a prompt trick. This isn't some sort of crazy infrastructure.

It's folders and markdown files with the understanding.

Of advanced software engineering.

Every conversation after that, the AI knows where it is, what to load, what tools to use, and where to put the.

Work in. Now, there is a lot of history behind my thinking.

I didn't just randomly come up with this, and there's a lot of people who are already doing this.

And the reason they're doing this is because it works.

I'm writing a very large research paper right now that goes into the history of programming's rules of transparency, rules of composition,.

Um all the way back down to 1972,.

And then I'm bringing it forward and applying all this stuff to modern-day AI, what it means to have humans in it.

And I specifically talk about the layers.

That we could actually have. And I actually go into a five-layer architecture in the paper, but realistically, most of you just.

Need to understand the three main layers that we talked about here.

I will be making videos on this.

However, it is in the main chat.

Um if you want to download this and give it to Claude.

So that it can tell you about it rather than having to read through it, I highly recommend that.

In fact, I urge you to do it because some of this is kind of technical information.

Nerdy. I'm being structured in it.

But, this is layering out what the next decade.

Is looking like. And this isn't because I'm predicting the future,.

It's because I'm learning from the past, from the last 200 years of software engineering, and I mean 200 when I say.

That, and applying it to AI.

I want to teach the concepts that last, not the concepts that are replaced next month.

I understand that some of this might be a little fast.

It might be a little confusing.

I'll keep making deeper dives. Give me feedback.

On what you didn't understand. How?

Did I move too fast? I want to make these better every day.

Again, I'm making these on my own.

So, hopefully, this all gave you a good idea.

If you do want access to any of these files or worker templates,.

Um I am giving them already to my VIP and my.

Uh premium accounts. It's my one way of like the work, right, to be able to support this.

So, if you're able to subscribe,.

Amazing.

If it actually is that much of a financial challenge, please reach out to me.

I can try to see if I can get you something, you know, quick and easy for you.

But at the end of the day, go go check it out.

Go check out all my other courses that I'll be doing.

And again, as always,.

Happy learning.