A ready-made project folder for people who build things with an AI coding assistant, such as Claude Code or Codex, but don't write code themselves.
Built by Render Better.
AI coding assistants are powerful but forgetful. Each time you start a new conversation, they forget what happened last time. They can also guess instead of checking, use technical words you don't know, or save a password where it shouldn't go.
This folder gives your assistant:
- House rules. A file called
AGENTS.mdtells the assistant how to work with you: use plain words, check facts instead of guessing, make the technical decisions itself, and ask you before doing anything that's hard to undo. - A project notebook. The
knowledgefolder is where the assistant writes down what it did, what it learned, and why decisions were made. Next time, it reads the notebook first, so you don't have to explain everything again. You can read it yourself in Obsidian, a free notes app. - A safety check for passwords and keys. Every time the assistant saves your work, a checker looks for passwords, access keys, and similar secrets, and stops them from being saved.
A desktop app with an AI coding assistant, for example:
- Claude Code, in the Claude desktop app. Use the Code mode, not Cowork.
- Codex, in the Codex desktop app.
Use the coding mode, even though you don't write code. It's the more capable assistant: it can install tools, run the safety checks, and save versions of your project. This folder is built for it, and the house rules tell it to guide you step by step.
-
Get your own copy of this folder. Download it, or ask someone to make you a copy. Put it somewhere easy to find, such as your Documents folder.
-
Open the app and choose this folder. When the app asks which folder or project to work in, pick this one.
-
Ask it to set things up. Type:
Set up this project for me.
The assistant follows the setup steps in
AGENTS.md. It may ask to install a couple of free tools it needs. Say yes if you're comfortable. -
Tell it about your project. The assistant asks what you're making and writes it down, so it remembers next time.
That's it. From then on, just ask for what you want in your own words.
Your app will sometimes pause and ask you to approve something before the assistant runs it, such as installing a tool or changing files. This is normal, and it keeps you in control.
- The assistant should tell you what each request is for before it appears.
- If you're not sure, don't approve yet. Ask: "What does this do, and is it safe?"
- It's fine to say no. The assistant will find another way or explain what's needed.
You don't need special commands. These work well:
- "What did we work on last time?"
- "Write down what we just figured out."
- "Why did we decide to do it this way?"
- "Save a checkpoint." (A checkpoint is a saved version of your project you can go back to.)
- "Explain that in simpler words."
- "What's left to do?"
If the assistant ever uses a word you don't understand, ask it to explain. The house rules tell it to.
Obsidian is a free app for reading and writing notes. The project
notebook (the knowledge folder) is set up to open in it, so you can browse what the assistant
wrote, follow links between pages, and make your own edits. This is optional.
- Go to obsidian.md/download.
- Under your computer's system (macOS or Windows), click Universal to download it.
- Open the downloaded file and install it like any other app.
The first time you open Obsidian:
- Next to Open folder as vault, click Open. (Obsidian calls a folder of notes a "vault".)
- Go into your project folder and select the
knowledgefolder inside it. Chooseknowledgeitself, not the whole project folder. - Click Open.
If Obsidian already has another vault open:
- At the bottom left, click the vault name (Obsidian calls this button the Vault profile).
- Select Manage vaults....
- Next to Open folder as vault, click Open, then follow steps 2 and 3.
- Open the page called index in the file list. It's the table of contents.
- Click any link to jump to that page.
- Your edits save on their own. Afterwards, tell your assistant something like "I edited some notes in Obsidian, please check them and save a checkpoint."
- To link to another page, type
[[and pick the page. Obsidian is set up to write the link in the format your assistant expects. - To start a new page from a template, open the command palette (
Cmd+Pon a Mac,Ctrl+Pon Windows) and choose Templates: Insert template. - Some settings are shared with the project so the notebook works the same everywhere. Ask your assistant before changing settings under Files and links or Editor.
- Don't paste passwords, access keys, or credit card numbers into the chat unless you have to. Never ask the assistant to write them into a file.
- If you pasted one by accident, say so. The assistant will make sure it isn't saved, and will tell you whether you should change that password.
- The safety check catches most passwords and keys, but it can't catch everything. It doesn't catch personal details like names, addresses, or phone numbers, so be careful with those too.
You don't need to open any of these yourself. The assistant reads and updates them.
| What | What it's for |
|---|---|
AGENTS.md |
The house rules your assistant follows. |
CLAUDE.md |
Points Claude Code at the house rules. Leave it as is. |
knowledge/ |
The project notebook: notes, decisions, and a dated diary of what happened. Opens in Obsidian. |
.agents/skills/ |
An empty folder for step-by-step instructions you might add later. |
.githooks/ and .gitleaks.toml |
The password and key safety check. |
.gitignore |
A list of files that should never be saved, such as password files. |
package.json |
Lets the assistant run the notebook checker. |
Files and folders that start with a dot may be hidden on your computer. That's normal.
You can use, copy, and change this starter for free, including for work you sell. It's released under the MIT License.
One page has its own license: the writing guide
(knowledge/wiki/conventions/writing-standard-guide.md) adapts text shared under
CC BY 4.0. Keep the credit at the bottom of that
page if you copy or change it.