Your AI Agent Writes the Code. Who Sets the Rules?
Why we built Yosr Seed, and who it's for: projects that start ready, not just started.
Starting a new project is exciting. You have an idea, you open your laptop, and you want to build.
Then the setup starts.
Which folder structure? Which linter? How do I run tests? Where do the database settings go? How do I keep secrets out of my code? By the time all of that is sorted, a lot of the excitement is gone, and you haven’t built the thing you wanted to build.
Now add AI agents to the picture. Tools like Cursor and Claude can write a lot of code for you, and fast. That’s great. But an agent is a bit like a new teammate who types very quickly. If nobody tells it the rules of the project, it guesses. Sometimes it guesses well. Sometimes it doesn’t, and you find out later.
That’s the gap we wanted to close with Yosr Seed.
What Yosr Seed is, in plain words
Yosr Seed is a small tool you run from your terminal. You answer a few questions, and it creates a new project for you that is ready to work on from the first minute.
Not just a folder with some files in it. A project that already has:
- A clean starting structure, so you know where things go.
- A quality check, which we call the gate. It runs your formatting, linting, type checks and tests in one step, so you can see quickly if something broke.
- Notes for your AI agent. Yosr Seed writes a guide file (
AGENTS.md) that tells your agent how this project works and what “good” looks like here. Your agent starts with the rules instead of guessing them. - Sensible defaults for things people often get wrong at the start, like keeping secrets in the right place.
You can pick the kind of project you want. Today there are seven starting points, covering websites, web apps and APIs, in languages like TypeScript, Python, C# and Java. Some of them can also set up a database and Docker for you if you want that.
It’s free on npm.
Why we built it
We kept starting projects the same way, over and over. Every time, the first day went to setup. And every time we used an AI agent, we spent time explaining the same rules to it again.
We asked a simple question: what if a project could start with all of that already done, and already explained?
That’s the whole idea behind Yosr Seed. The setup is done once, carefully, and every new project gets it from day one. The agent reads the rules. The gate checks the work. You spend your time on the part that’s actually yours: the idea.
Who it’s for
If you’re a junior developer, Yosr Seed gives you a project set up the way experienced teams set theirs up. You can learn from it by reading it. And when something breaks, the gate tells you early, while it’s still easy to fix.
If you build things on your own or in a small team, it saves you the first day of every project. You start each one the same clean way, so switching between projects feels familiar.
If you work with AI agents a lot, it gives your agent a clear map of the project and a check to run after every change. Less guessing, fewer surprises.
And if you’re not a developer at all, but you’re curious about building something with an AI agent, this part is for you. You don’t need to know how to set up a project. That’s the part Yosr Seed does. You run one command, open the project with your agent, and describe what you want. The agent already knows the house rules, and the gate helps catch mistakes along the way. You still learn as you go, but you don’t start from a blank page.
What it looks like
Here’s the short version:
- Open your terminal.
- Run the create command from the guide on seed.yosr.ai.
- Answer a few questions: what kind of project, which options you want.
- Open the new folder with your editor or your AI agent.
- Start building.
When you or your agent make changes, run the gate. Green means you’re good. If something is red, it tells you what to look at.
What we care about
We want Yosr Seed to stay calm and simple. No huge promises, no magic. Just a good starting point that respects your time, works well with AI agents, and helps you keep your project healthy as it grows.
We’re building it in small, steady steps, and every release goes through the same checks we give you.
Try it
If you’re starting something new this week, give Yosr Seed a try. Visit seed.yosr.ai to get started. It’s free on npm.
And if you have thoughts, questions or ideas, we’d really like to hear them.
Plant the seed. Build the rest.