[{"data":1,"prerenderedAt":899},["ShallowReactive",2],{"docs.index":3,"docs.page.\u002Fdocs\u002Fplaybooks\u002Fwrite-your-agents-md":358},[4,20,26,33,43,52,59,65,71,76,82,89,95,100,104,111,115,119,123,132,137,141,147,152,157,163,170,177,183,189,193,199,205,211,217,222,226,230,236,242,247,252,256,260,265,271,277,283,287,294,299,305,310,314,318,322,328,333,338,343,347,353],{"path":5,"title":6,"navTitle":7,"seoTitle":8,"description":9,"type":10,"position":11,"updated":12,"release":13,"related":14,"plans":17},"\u002Fdocs\u002Faccount\u002Fbilling","Upgrade and manage billing","Billing",null,"Move a workspace onto Grove or Forest, understand how seats are charged, and what happens if a payment fails or you cancel.","how-to",2,"2026-09-29","public",[15,16],"\u002Fdocs\u002Faccount\u002Fplans-and-limits","\u002Fdocs\u002Fsharing\u002Finvite-people",[18,19],"grove","forest",{"path":21,"title":22,"navTitle":8,"seoTitle":8,"description":23,"type":24,"position":25,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Faccount","Account and billing","What each plan includes, how billing and seats work, managing your account, and how Treehouse keeps your files safe.","hub",7,{"path":15,"title":27,"navTitle":8,"seoTitle":8,"description":28,"type":29,"position":30,"updated":12,"release":13,"related":31,"plans":8},"Plans and limits","What Seedling, Grove and Forest include, how usage is counted, and what happens when a workspace reaches a limit.","reference",1,[5,16,32],"\u002Fdocs\u002Fsharing\u002Fshare-links",{"path":34,"title":35,"navTitle":8,"seoTitle":8,"description":36,"type":37,"position":38,"updated":12,"release":13,"related":39,"plans":8},"\u002Fdocs\u002Faccount\u002Fsecurity-and-privacy","Security and privacy","How Treehouse encrypts your files, who can see what in a workspace, and how keys, share links and HTML pages are kept in check.","concept",4,[40,32,41,42],"\u002Fdocs\u002Fagents\u002Fconnect\u002Fapi-keys","\u002Fdocs\u002Ffiles\u002Fprivate-files","\u002Fdocs\u002Ffiles\u002Fhtml-pages",{"path":44,"title":45,"navTitle":46,"seoTitle":8,"description":47,"type":10,"position":48,"updated":12,"release":13,"related":49,"plans":8},"\u002Fdocs\u002Faccount\u002Fyour-account","Manage your account","Your account","Create an account, sign in and out, reset a forgotten password, and move between the workspaces you belong to.",3,[50,51,34],"\u002Fdocs\u002Fget-started\u002Fquickstart","\u002Fdocs\u002Fsharing\u002Fcustomise-your-workspace",{"path":40,"title":53,"navTitle":54,"seoTitle":8,"description":55,"type":10,"position":38,"updated":12,"release":13,"related":56,"plans":8},"Manage API keys","API keys","Create a key for each agent, see which keys can reach your workspaces, and revoke the ones you no longer need.",[57,58,34],"\u002Fdocs\u002Fagents\u002Fconnect\u002Fclaude-code","\u002Fdocs\u002Fagents\u002Freference\u002Fauthentication",{"path":57,"title":60,"navTitle":8,"seoTitle":8,"description":61,"type":10,"position":11,"updated":12,"release":13,"related":62,"plans":8},"Connect Claude Code","Give Claude Code access to a workspace through your synced folder, the Treehouse MCP server, or both.",[63,40,64],"\u002Fdocs\u002Fagents\u002Fconnect\u002Fhow-agents-work","\u002Fdocs\u002Fplaybooks\u002Fwrite-your-agents-md",{"path":63,"title":66,"navTitle":67,"seoTitle":8,"description":68,"type":37,"position":30,"updated":12,"release":13,"related":69,"plans":8},"How agents work with Treehouse","How agents work","The two ways an agent can reach a workspace, what it can do there, and how its work shows up for everyone else.",[57,40,70],"\u002Fdocs\u002Fagents\u002Fhandbook",{"path":72,"title":73,"navTitle":74,"seoTitle":8,"description":75,"type":24,"position":30,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fagents\u002Fconnect","Connect an agent","Connect","Give Claude Code, Codex, Cursor or any other agent access to a workspace, with its own key when you want its work labelled.",{"path":77,"title":78,"navTitle":8,"seoTitle":8,"description":79,"type":10,"position":48,"updated":12,"release":13,"related":80,"plans":8},"\u002Fdocs\u002Fagents\u002Fconnect\u002Fother-agents","Connect other agents","Connection settings for Cursor, VS Code, Codex, Gemini CLI, Claude Desktop and any other MCP client.",[57,40,81],"\u002Fdocs\u002Fagents\u002Freference\u002Fmcp-server",{"path":70,"title":83,"navTitle":83,"seoTitle":84,"description":85,"type":24,"position":11,"updated":12,"release":13,"related":86,"plans":8},"Agent handbook","Agent handbook: how agents work in Treehouse","Written for agents. How to reach a Treehouse workspace, the rules that keep everyone's work safe, and the conventions the web app understands.",[81,87,88],"\u002Fdocs\u002Fagents\u002Fhandbook\u002Fversions-and-conflicts","\u002Fdocs\u002Fplaybooks\u002Freview-loop",{"path":87,"title":90,"navTitle":8,"seoTitle":8,"description":91,"type":37,"position":30,"updated":12,"release":13,"related":92,"plans":8},"Versions and conflicts","The concurrency contract every Treehouse client shares - version numbers, compare-and-swap writes, conflicted copies, deletes, moves and restores.",[93,94,81],"\u002Fdocs\u002Ffiles\u002Fconflicted-copies","\u002Fdocs\u002Fagents\u002Freference\u002Frest-api",{"path":96,"title":97,"navTitle":8,"seoTitle":98,"description":99,"type":24,"position":30,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fagents","Agents","Treehouse for agents","Everything an agent needs to work in a Treehouse workspace, and everything you need to connect one.",{"path":58,"title":101,"navTitle":8,"seoTitle":8,"description":102,"type":29,"position":30,"updated":12,"release":13,"related":103,"plans":8},"Authentication","How API keys work, what each kind of key can reach, the device authorisation flow the CLI and desktop app use, and how keys are revoked.",[40,81,94],{"path":105,"title":106,"navTitle":8,"seoTitle":8,"description":107,"type":29,"position":38,"updated":12,"release":13,"related":108,"plans":8},"\u002Fdocs\u002Fagents\u002Freference\u002Fchange-feed","Change feed","Read every change to a workspace in order with a cursor, so a script or agent can react to new and edited files.",[109,110,87],"\u002Fdocs\u002Fsharing\u002Factivity","\u002Fdocs\u002Fplaybooks\u002Froutines",{"path":112,"title":113,"navTitle":8,"seoTitle":8,"description":114,"type":24,"position":48,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fagents\u002Freference","API reference","The protocol reference - authentication, every MCP tool, the REST API and the change feed.",{"path":81,"title":116,"navTitle":8,"seoTitle":8,"description":117,"type":29,"position":11,"updated":12,"release":13,"related":118,"plans":8},"MCP server","Every tool the Treehouse MCP server exposes, with parameters, outputs, limits and the instructions it gives connected agents.",[57,77,87],{"path":94,"title":120,"navTitle":8,"seoTitle":8,"description":121,"type":29,"position":48,"updated":12,"release":13,"related":122,"plans":8},"REST API","Endpoints for reading, writing, moving, searching, sharing and commenting on workspace files over HTTP, with headers, status codes and examples.",[58,87,105],{"path":124,"title":125,"navTitle":126,"seoTitle":8,"description":127,"type":29,"position":128,"updated":12,"release":13,"related":129,"plans":8},"\u002Fdocs\u002Fdesktop\u002Fcli-reference","Sync CLI reference","Sync CLI","Every treehouse command and flag, the files and environment variables the CLI reads, and the safety rules it follows while syncing.",5,[130,131,105],"\u002Fdocs\u002Fdesktop\u002Fsync-with-the-cli","\u002Fdocs\u002Fdesktop\u002Fhow-sync-works",{"path":131,"title":133,"navTitle":8,"seoTitle":8,"description":134,"type":37,"position":11,"updated":12,"release":13,"related":135,"plans":8},"How sync works","What the sync engine does in the background, which files it skips, and how it protects your work when things go wrong.",[93,41,109,136],"\u002Fdocs\u002Fget-started\u002Fhow-treehouse-works",{"path":138,"title":139,"navTitle":8,"seoTitle":8,"description":140,"type":24,"position":128,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fdesktop","Desktop app and sync","Keep a folder on your computer in step with a workspace, using the Mac app or the sync CLI.",{"path":142,"title":143,"navTitle":8,"seoTitle":8,"description":144,"type":10,"position":30,"updated":12,"release":13,"related":145,"plans":8},"\u002Fdocs\u002Fdesktop\u002Finstall-the-desktop-app","Install the desktop app","Download Treehouse for Mac, sign in and pick a folder, and your workspace's files appear on your computer and stay in sync.",[131,146,130],"\u002Fdocs\u002Fdesktop\u002Fmanage-synced-folders",{"path":146,"title":148,"navTitle":8,"seoTitle":8,"description":149,"type":10,"position":48,"updated":12,"release":13,"related":150,"plans":8},"Manage synced folders","Check sync status, pause, move or stop syncing a folder, add another workspace, and sign out, all from the Treehouse icon in your menu bar.",[131,130,151],"\u002Fdocs\u002Fhelp\u002Ftroubleshooting",{"path":130,"title":153,"navTitle":154,"seoTitle":8,"description":155,"type":10,"position":38,"updated":12,"release":13,"related":156,"plans":8},"Sync a folder with the CLI","Sync with the CLI","Install the treehouse command-line tool to sync a folder on Windows, Linux, a server or any machine where the desktop app doesn't run.",[124,131,146],{"path":93,"title":158,"navTitle":8,"seoTitle":8,"description":159,"type":37,"position":160,"updated":12,"release":13,"related":161,"plans":8},"Conflicted copies","When two edits to the same file collide, Treehouse keeps both. Here's what a conflicted copy is, how to spot one and how to resolve it.",9,[162,131,87],"\u002Fdocs\u002Ffiles\u002Fversion-history",{"path":164,"title":165,"navTitle":166,"seoTitle":8,"description":167,"type":10,"position":11,"updated":12,"release":13,"related":168,"plans":8},"\u002Fdocs\u002Ffiles\u002Fcreate-and-edit","Create and edit files","Create and edit","Make new files and folders in the web app, edit markdown, code and HTML, and save your changes.",[169,93,162],"\u002Fdocs\u002Ffiles\u002Ffront-matter",{"path":171,"title":172,"navTitle":173,"seoTitle":8,"description":174,"type":10,"position":128,"updated":12,"release":13,"related":175,"plans":8},"\u002Fdocs\u002Ffiles\u002Ffolder-pages","Turn a folder into a page or calendar","Folder pages and calendars","Give a folder a front page with a README, or show a folder of dated notes as a calendar you can reschedule by dragging.",[169,42,176],"\u002Fdocs\u002Fplaybooks\u002Fshape-your-workspace",{"path":169,"title":178,"navTitle":179,"seoTitle":8,"description":180,"type":29,"position":181,"updated":12,"release":13,"related":182,"plans":8},"Front matter reference","Front matter","The YAML block at the top of a markdown file, and the keys Treehouse reads from it to label, title and schedule your files.",6,[171,164,110],{"path":42,"title":184,"navTitle":185,"seoTitle":8,"description":186,"type":10,"position":25,"updated":12,"release":13,"related":187,"plans":8},"Publish an HTML page","HTML pages","Show HTML files as full pages, decide when their scripts may run, and share them publicly as reports, dashboards or decks.",[32,171,188],"\u002Fdocs\u002Ffiles\u002Fview-files",{"path":190,"title":191,"navTitle":8,"seoTitle":8,"description":192,"type":24,"position":48,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Ffiles","Files and folders","Find, read, write, upload and organise the files in a workspace, and get back anything that changed.",{"path":194,"title":195,"navTitle":196,"seoTitle":8,"description":197,"type":10,"position":38,"updated":12,"release":13,"related":198,"plans":8},"\u002Fdocs\u002Ffiles\u002Forganise-files","Rename, move and organise files","Organise files","Rename, move, reorder and delete files and folders, and give them icons, from the sidebar tree.",[162,41,176],{"path":41,"title":200,"navTitle":201,"seoTitle":8,"description":202,"type":10,"position":203,"updated":12,"release":13,"related":204,"plans":8},"Keep files private","Private files","Make a file or folder visible only to you and your own agents, even in a workspace you share with others.",10,[194,32,63],{"path":206,"title":207,"navTitle":208,"seoTitle":8,"description":209,"type":10,"position":48,"updated":12,"release":13,"related":210,"plans":8},"\u002Fdocs\u002Ffiles\u002Fupload-and-download","Upload and download files","Upload and download","Add files from your computer to a workspace, decide what happens when names clash, and download a copy of any file.",[164,131,15],{"path":162,"title":212,"navTitle":213,"seoTitle":8,"description":214,"type":10,"position":215,"updated":12,"release":13,"related":216,"plans":8},"See and restore earlier versions","Version history","Look through every change to a file, see who made it, view or restore an older version, and catch up on what changed while you were away.",8,[93,109,87],{"path":188,"title":218,"navTitle":219,"seoTitle":8,"description":220,"type":10,"position":30,"updated":12,"release":13,"related":221,"plans":8},"Find and view files","Find and view","Browse the file tree, search by name, and see how Treehouse shows markdown, HTML, code, images and everything else.",[164,171,162],{"path":136,"title":223,"navTitle":8,"seoTitle":8,"description":224,"type":37,"position":48,"updated":12,"release":13,"related":225,"plans":8},"How Treehouse works","Workspaces, versions, conflicted copies and attribution - the handful of ideas the rest of Treehouse is built on.",[162,93,63,87],{"path":227,"title":228,"navTitle":8,"seoTitle":8,"description":229,"type":24,"position":11,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fget-started","Get started","What Treehouse is, how to set up your first workspace, and how it works underneath.",{"path":50,"title":231,"navTitle":8,"seoTitle":8,"description":232,"type":233,"position":11,"updated":12,"release":13,"related":234,"plans":8},"Quickstart","Create a workspace, sync it to your computer, connect an agent and let it set things up. About ten minutes.","guide",[235,57,64],"\u002Fdocs\u002Fget-started\u002Fset-up-with-an-agent",{"path":235,"title":237,"navTitle":238,"seoTitle":8,"description":239,"type":10,"position":38,"updated":12,"release":13,"related":240,"plans":8},"Set up a workspace with an agent","Set up with an agent","Hand a new, empty workspace to an agent. It interviews you, proposes a structure and builds it once you agree.",[176,64,241],"\u002Fdocs\u002Fplaybooks\u002Finbox-and-filing",{"path":243,"title":244,"navTitle":244,"seoTitle":8,"description":245,"type":37,"position":30,"updated":12,"release":13,"related":246,"plans":8},"\u002Fdocs\u002Fget-started\u002Fwhat-is-treehouse","What is Treehouse?","A shared workspace of plain files that people and agents both work in, with the sharing, history and review that plain folders lack.",[50,136,63],{"path":248,"title":249,"navTitle":250,"seoTitle":8,"description":251,"type":29,"position":11,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fhelp\u002Ffaq","Frequently asked questions","FAQ","Short answers to the questions people ask most about Treehouse, agents, sharing and data.",{"path":253,"title":254,"navTitle":8,"seoTitle":8,"description":255,"type":29,"position":48,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fhelp\u002Fglossary","Glossary","The words Treehouse uses, and what each one means in the app and in these docs.",{"path":257,"title":258,"navTitle":8,"seoTitle":8,"description":259,"type":24,"position":215,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fhelp","Help","Fixes for common problems, answers to common questions, and the words Treehouse uses.",{"path":151,"title":261,"navTitle":8,"seoTitle":262,"description":263,"type":10,"position":30,"updated":12,"release":13,"related":264,"plans":8},"Troubleshooting","Troubleshooting Treehouse sync, agents and sharing","The problems people hit most often with sync, agent connections, sharing and limits, and how to fix each one.",[146,57,93],{"path":266,"title":267,"navTitle":8,"seoTitle":268,"description":269,"type":24,"position":270,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs","Treehouse docs","Treehouse documentation","How to set up a shared workspace for your team and your agents, and how to get the most out of it once you have.",0,{"path":272,"title":273,"navTitle":274,"seoTitle":8,"description":275,"type":233,"position":215,"updated":12,"release":13,"related":276,"plans":8},"\u002Fdocs\u002Fplaybooks\u002Fclient-work","Run client work","Client work","A folder per client, agents that prepare the deliverables, and share links that give clients exactly what they should see.",[32,42,88],{"path":241,"title":278,"navTitle":279,"seoTitle":8,"description":280,"type":233,"position":48,"updated":12,"release":13,"related":281,"plans":8},"Run an inbox your agent files","Inbox and filing","Drop anything into Inbox\u002F without deciding where it goes, and have an agent file it by rules you write once.",[110,282,176],"\u002Fdocs\u002Fplaybooks\u002Fsecond-brain",{"path":284,"title":285,"navTitle":8,"seoTitle":8,"description":286,"type":24,"position":181,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fplaybooks","Playbooks","Opinionated patterns for running a workspace with your agents, from the rulebook they follow to the routines that keep it alive.",{"path":288,"title":289,"navTitle":290,"seoTitle":8,"description":291,"type":233,"position":128,"updated":12,"release":13,"related":292,"plans":8},"\u002Fdocs\u002Fplaybooks\u002Fmemory-and-decisions","Give your agents a memory","Memory and decisions","Status pages, decision records and handoff notes that let any agent pick up where the last session left off.",[64,293,171],"\u002Fdocs\u002Fplaybooks\u002Fmultiple-agents",{"path":293,"title":295,"navTitle":296,"seoTitle":8,"description":297,"type":233,"position":25,"updated":12,"release":13,"related":298,"plans":8},"Work with several agents","Several agents","Give each agent its own key and its own lane, hand work over through files, and let versioning catch the collisions.",[40,288,93],{"path":88,"title":300,"navTitle":301,"seoTitle":8,"description":302,"type":233,"position":38,"updated":12,"release":13,"related":303,"plans":8},"Review your agent's work","Review loop","Let an agent draft, review it with comments in the web app, and have the agent work through your feedback thread by thread.",[304,162,57],"\u002Fdocs\u002Fsharing\u002Fcomments",{"path":110,"title":306,"navTitle":307,"seoTitle":8,"description":308,"type":233,"position":181,"updated":12,"release":13,"related":309,"plans":8},"Set up routines","Routines","Recurring agent work, like a morning inbox run or a weekly review, and where the schedule lives when Treehouse doesn't run agents itself.",[241,130,105],{"path":282,"title":311,"navTitle":8,"seoTitle":8,"description":312,"type":233,"position":160,"updated":12,"release":13,"related":313,"plans":8},"Build a second brain","A personal workspace where you capture everything quickly and an agent keeps it filed, linked and useful.",[241,110,171],{"path":176,"title":315,"navTitle":8,"seoTitle":8,"description":316,"type":233,"position":11,"updated":12,"release":13,"related":317,"plans":8},"Shape your workspace","Folder structures that work for people and agents alike, and the handful of habits that keep a workspace easy to navigate as it grows.",[64,171,194],{"path":64,"title":319,"navTitle":8,"seoTitle":8,"description":320,"type":233,"position":30,"updated":12,"release":13,"related":321,"plans":8},"Write your AGENTS.md","The one file every agent reads first. What to put in it so any agent, in any session, works the way your team does.",[176,63,235],{"path":323,"title":324,"navTitle":325,"seoTitle":8,"description":326,"type":24,"position":160,"updated":12,"release":13,"related":327,"plans":8},"\u002Fdocs\u002Fself-hosting","Self-host Treehouse","Self-hosting","Run your own Treehouse server - the architecture, required and optional environment variables, storage and encryption, and connecting clients.",[58,81,124],{"path":109,"title":329,"navTitle":330,"seoTitle":8,"description":331,"type":10,"position":38,"updated":12,"release":13,"related":332,"plans":8},"See what changed in a workspace","Activity","The activity feed shows every change and comment in a workspace, who made it, and whether it came from a person or an agent.",[63,40,162,93],{"path":304,"title":334,"navTitle":335,"seoTitle":8,"description":336,"type":10,"position":48,"updated":12,"release":13,"related":337,"plans":8},"Comment on a document","Comments","Leave comments on passages of a markdown file, reply and resolve threads, and let agents read and act on your feedback.",[88,162,109],{"path":51,"title":339,"navTitle":340,"seoTitle":8,"description":341,"type":10,"position":128,"updated":12,"release":13,"related":342,"plans":8},"Customise your workspace","Customise a workspace","Rename a workspace, give it an icon and colour, create new workspaces, and choose a theme for everyone or just for you.",[15,32],{"path":344,"title":345,"navTitle":8,"seoTitle":8,"description":346,"type":24,"position":38,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fsharing","Share and collaborate","Invite people into a workspace, share files with anyone by link, comment on documents and see who changed what.",{"path":16,"title":348,"navTitle":349,"seoTitle":8,"description":350,"type":10,"position":30,"updated":12,"release":13,"related":351,"plans":352},"Invite people to a workspace","Invite people","Bring teammates into a workspace with an invite link, see who's a member, and remove people when they no longer need access.",[32,5,40],[18,19],{"path":32,"title":354,"navTitle":355,"seoTitle":8,"description":356,"type":10,"position":11,"updated":12,"release":13,"related":357,"plans":8},"Share a file or folder with a link","Share links","Send members straight to a file, or give anyone read-only access to a file or folder, with an optional password and a pinned version.",[16,42,162,15],{"id":359,"title":319,"body":360,"description":320,"extension":893,"meta":894,"navTitle":8,"navigation":485,"path":64,"plans":8,"position":30,"related":895,"release":13,"seo":896,"seoTitle":8,"stem":897,"type":233,"updated":12,"__hash__":898},"docs\u002Fdocs\u002Fplaybooks\u002Fwrite-your-agents-md.md",{"type":361,"value":362,"toc":886},"minimark",[363,371,379,384,390,447,450,454,460,732,736,775,779,793,875,879,882],[364,365,366,370],"p",{},[367,368,369],"code",{},"AGENTS.md"," at the root of your workspace is its rulebook. The Treehouse MCP server tells every agent to read it before doing anything else, and coding agents like Claude Code, Codex and Cursor look for it by convention when they open a folder. Whatever you write there, every agent gets, every session, without you repeating yourself.",[364,372,373,374,378],{},"If an agent ",[375,376,377],"a",{"href":235},"set up your workspace",", it already wrote a first version. This guide is about making it good.",[380,381,383],"h2",{"id":382},"what-belongs-in-it","What belongs in it",[364,385,386,387,389],{},"A useful ",[367,388,369],{}," answers the questions a new teammate would ask on their first day:",[391,392,393,401,411,417,435,441],"ol",{},[394,395,396,400],"li",{},[397,398,399],"strong",{},"What is this workspace?"," One or two sentences. Who it's for and what it's used for.",[394,402,403,406,407,410],{},[397,404,405],{},"Where do things go?"," The top-level folders and what belongs in each. Keep it to a line per folder; each folder's own ",[367,408,409],{},"README.md"," carries the detail.",[394,412,413,416],{},[397,414,415],{},"How are things named?"," File naming, dates, how drafts and final versions are told apart.",[394,418,419,422,423,426,427,430,431,434],{},[397,420,421],{},"What front matter do you use?"," The keys your files carry, like ",[367,424,425],{},"status",", ",[367,428,429],{},"owner"," or ",[367,432,433],{},"date",", and what the values mean.",[394,436,437,440],{},[397,438,439],{},"What can an agent do on its own, and what needs a person?"," Be explicit. \"Never delete; move to Archive\u002F.\" \"Ask before creating a top-level folder.\" \"Anything in Clients\u002F is read by clients, so no internal notes there.\"",[394,442,443,446],{},[397,444,445],{},"How do you want to hear back?"," A summary at the end of a task, a note in a log file, a comment on the document.",[364,448,449],{},"Leave out anything an agent can see for itself, like a list of every file. That goes stale the day you write it.",[380,451,453],{"id":452},"a-template-to-start-from","A template to start from",[364,455,456,457,459],{},"Copy this into ",[367,458,369],{}," and make it yours. Every line should be true of your workspace; delete the ones that aren't.",[461,462,467],"pre",{"className":463,"code":464,"filename":369,"language":465,"meta":466,"style":466},"language-markdown shiki shiki-themes everforest-dark","# AGENTS.md\n\nAcme's product workspace: specs, research, decisions and meeting notes for the\nproduct team (four people) and the agents we work with.\n\n## Where things go\n\n- Inbox\u002F - anything unsorted. Filing rules are in Inbox\u002FREADME.md.\n- Specs\u002F - one folder per feature, each with a README.md that tracks its status.\n- Research\u002F - interviews and analysis. Raw notes in Research\u002Fraw\u002F.\n- Decisions\u002F - one file per decision, named YYYY-MM-DD-short-title.md.\n- Meetings\u002F - dated notes. Opens as a calendar.\n- Archive\u002F - anything retired. Move things here instead of deleting them.\n\nEvery folder has a README.md saying what belongs in it. Read it before adding\nfiles to that folder.\n\n## Conventions\n\n- File names are lowercase with hyphens: pricing-page-copy.md.\n- Front matter on every spec and research note:\n  - status: draft | review | final\n  - owner: the person responsible (first name)\n- Dates are always YYYY-MM-DD.\n\n## Working rules for agents\n\n- Never delete files. Move them to Archive\u002F and say so.\n- Don't create new top-level folders. Propose them instead.\n- Don't mark anything status: final. Only a person does that.\n- When you change a spec, add a line to its \"Changelog\" section.\n- Review comments on a file are the priority when you're asked to \"go through\n  feedback\". Reply to each thread with what you changed.\n\n## When you finish a task\n\nEnd with a short list of the files you created, changed or moved, and anything\nyou weren't sure about.\n","markdown","",[367,468,469,481,487,493,498,502,511,515,524,531,538,546,554,562,567,573,579,584,592,597,605,613,622,630,638,643,651,656,664,672,680,688,696,702,707,715,720,726],{"__ignoreMap":466},[470,471,473,477],"span",{"class":472,"line":30},"line",[470,474,476],{"class":475},"s3WQq","#",[470,478,480],{"class":479},"sPuRg"," AGENTS.md\n",[470,482,483],{"class":472,"line":11},[470,484,486],{"emptyLinePlaceholder":485},true,"\n",[470,488,489],{"class":472,"line":48},[470,490,492],{"class":491},"sY0Nt","Acme's product workspace: specs, research, decisions and meeting notes for the\n",[470,494,495],{"class":472,"line":38},[470,496,497],{"class":491},"product team (four people) and the agents we work with.\n",[470,499,500],{"class":472,"line":128},[470,501,486],{"emptyLinePlaceholder":485},[470,503,504,507],{"class":472,"line":181},[470,505,506],{"class":475},"##",[470,508,510],{"class":509},"sBO76"," Where things go\n",[470,512,513],{"class":472,"line":25},[470,514,486],{"emptyLinePlaceholder":485},[470,516,517,521],{"class":472,"line":215},[470,518,520],{"class":519},"safYi","-",[470,522,523],{"class":491}," Inbox\u002F - anything unsorted. Filing rules are in Inbox\u002FREADME.md.\n",[470,525,526,528],{"class":472,"line":160},[470,527,520],{"class":519},[470,529,530],{"class":491}," Specs\u002F - one folder per feature, each with a README.md that tracks its status.\n",[470,532,533,535],{"class":472,"line":203},[470,534,520],{"class":519},[470,536,537],{"class":491}," Research\u002F - interviews and analysis. Raw notes in Research\u002Fraw\u002F.\n",[470,539,541,543],{"class":472,"line":540},11,[470,542,520],{"class":519},[470,544,545],{"class":491}," Decisions\u002F - one file per decision, named YYYY-MM-DD-short-title.md.\n",[470,547,549,551],{"class":472,"line":548},12,[470,550,520],{"class":519},[470,552,553],{"class":491}," Meetings\u002F - dated notes. Opens as a calendar.\n",[470,555,557,559],{"class":472,"line":556},13,[470,558,520],{"class":519},[470,560,561],{"class":491}," Archive\u002F - anything retired. Move things here instead of deleting them.\n",[470,563,565],{"class":472,"line":564},14,[470,566,486],{"emptyLinePlaceholder":485},[470,568,570],{"class":472,"line":569},15,[470,571,572],{"class":491},"Every folder has a README.md saying what belongs in it. Read it before adding\n",[470,574,576],{"class":472,"line":575},16,[470,577,578],{"class":491},"files to that folder.\n",[470,580,582],{"class":472,"line":581},17,[470,583,486],{"emptyLinePlaceholder":485},[470,585,587,589],{"class":472,"line":586},18,[470,588,506],{"class":475},[470,590,591],{"class":509}," Conventions\n",[470,593,595],{"class":472,"line":594},19,[470,596,486],{"emptyLinePlaceholder":485},[470,598,600,602],{"class":472,"line":599},20,[470,601,520],{"class":519},[470,603,604],{"class":491}," File names are lowercase with hyphens: pricing-page-copy.md.\n",[470,606,608,610],{"class":472,"line":607},21,[470,609,520],{"class":519},[470,611,612],{"class":491}," Front matter on every spec and research note:\n",[470,614,616,619],{"class":472,"line":615},22,[470,617,618],{"class":519},"  -",[470,620,621],{"class":491}," status: draft | review | final\n",[470,623,625,627],{"class":472,"line":624},23,[470,626,618],{"class":519},[470,628,629],{"class":491}," owner: the person responsible (first name)\n",[470,631,633,635],{"class":472,"line":632},24,[470,634,520],{"class":519},[470,636,637],{"class":491}," Dates are always YYYY-MM-DD.\n",[470,639,641],{"class":472,"line":640},25,[470,642,486],{"emptyLinePlaceholder":485},[470,644,646,648],{"class":472,"line":645},26,[470,647,506],{"class":475},[470,649,650],{"class":509}," Working rules for agents\n",[470,652,654],{"class":472,"line":653},27,[470,655,486],{"emptyLinePlaceholder":485},[470,657,659,661],{"class":472,"line":658},28,[470,660,520],{"class":519},[470,662,663],{"class":491}," Never delete files. Move them to Archive\u002F and say so.\n",[470,665,667,669],{"class":472,"line":666},29,[470,668,520],{"class":519},[470,670,671],{"class":491}," Don't create new top-level folders. Propose them instead.\n",[470,673,675,677],{"class":472,"line":674},30,[470,676,520],{"class":519},[470,678,679],{"class":491}," Don't mark anything status: final. Only a person does that.\n",[470,681,683,685],{"class":472,"line":682},31,[470,684,520],{"class":519},[470,686,687],{"class":491}," When you change a spec, add a line to its \"Changelog\" section.\n",[470,689,691,693],{"class":472,"line":690},32,[470,692,520],{"class":519},[470,694,695],{"class":491}," Review comments on a file are the priority when you're asked to \"go through\n",[470,697,699],{"class":472,"line":698},33,[470,700,701],{"class":491},"  feedback\". Reply to each thread with what you changed.\n",[470,703,705],{"class":472,"line":704},34,[470,706,486],{"emptyLinePlaceholder":485},[470,708,710,712],{"class":472,"line":709},35,[470,711,506],{"class":475},[470,713,714],{"class":509}," When you finish a task\n",[470,716,718],{"class":472,"line":717},36,[470,719,486],{"emptyLinePlaceholder":485},[470,721,723],{"class":472,"line":722},37,[470,724,725],{"class":491},"End with a short list of the files you created, changed or moved, and anything\n",[470,727,729],{"class":472,"line":728},38,[470,730,731],{"class":491},"you weren't sure about.\n",[380,733,735],{"id":734},"keep-it-short-and-keep-it-true","Keep it short and keep it true",[737,738,739,748,760,766],"ul",{},[394,740,741,744,745,747],{},[397,742,743],{},"Aim for a page."," Agents read the whole file every session. A long ",[367,746,369],{}," dilutes the rules that matter, and people stop maintaining it.",[394,749,750,753,754,756,757,759],{},[397,751,752],{},"Push detail down."," Rules about one folder belong in that folder's ",[367,755,409],{},", where the agent reads them when it's working there. ",[367,758,369],{}," points to them.",[394,761,762,765],{},[397,763,764],{},"Write rules, not hopes."," \"Keep things tidy\" gives an agent nothing to act on. \"Move anything older than 90 days in Inbox\u002F to Archive\u002Finbox\u002F\" does.",[394,767,768,771,772,774],{},[397,769,770],{},"Update it when you correct an agent."," If you find yourself telling agents the same thing twice, it belongs in ",[367,773,369],{},". Ask the agent to add it: \"Add a rule to AGENTS.md so you don't do that again.\"",[380,776,778],{"id":777},"folder-readmes-are-local-rules","Folder READMEs are local rules",[364,780,781,782,784,785,788,789,792],{},"Each folder's ",[367,783,409],{}," is shown as its ",[375,786,787],{"href":171},"front page"," in the web app, so it serves people and agents at once. Use it to say what belongs in the folder, how files in it are named, and any rules that only apply there. For example, ",[367,790,791],{},"Decisions\u002FREADME.md",":",[461,794,796],{"className":463,"code":795,"filename":791,"language":465,"meta":466,"style":466},"---\ntitle: Decisions\nview: calendar\n---\n\nOne file per decision we've made, so we (and our agents) can find out why\nthings are the way they are.\n\n- Name files YYYY-MM-DD-short-title.md and set `date:` to the same day.\n- Use the template in Templates\u002Fdecision.md.\n- Decisions are never edited after the fact. If one is reversed, write a new\n  decision that links to the old one.\n",[367,797,798,804,809,814,818,822,827,832,836,856,863,870],{"__ignoreMap":466},[470,799,800],{"class":472,"line":30},[470,801,803],{"class":802},"sAuXP","---\n",[470,805,806],{"class":472,"line":11},[470,807,808],{"class":491},"title: Decisions\n",[470,810,811],{"class":472,"line":48},[470,812,813],{"class":491},"view: calendar\n",[470,815,816],{"class":472,"line":38},[470,817,803],{"class":509},[470,819,820],{"class":472,"line":128},[470,821,486],{"emptyLinePlaceholder":485},[470,823,824],{"class":472,"line":181},[470,825,826],{"class":491},"One file per decision we've made, so we (and our agents) can find out why\n",[470,828,829],{"class":472,"line":25},[470,830,831],{"class":491},"things are the way they are.\n",[470,833,834],{"class":472,"line":215},[470,835,486],{"emptyLinePlaceholder":485},[470,837,838,840,843,847,851,853],{"class":472,"line":160},[470,839,520],{"class":519},[470,841,842],{"class":491}," Name files YYYY-MM-DD-short-title.md and set ",[470,844,846],{"class":845},"sySyC","`",[470,848,850],{"class":849},"sRC7j","date:",[470,852,846],{"class":845},[470,854,855],{"class":491}," to the same day.\n",[470,857,858,860],{"class":472,"line":203},[470,859,520],{"class":519},[470,861,862],{"class":491}," Use the template in Templates\u002Fdecision.md.\n",[470,864,865,867],{"class":472,"line":540},[470,866,520],{"class":519},[470,868,869],{"class":491}," Decisions are never edited after the fact. If one is reversed, write a new\n",[470,871,872],{"class":472,"line":548},[470,873,874],{"class":491},"  decision that links to the old one.\n",[380,876,878],{"id":877},"check-its-working","Check it's working",[364,880,881],{},"Start a fresh session with an agent that hasn't seen the workspace and ask it to do an everyday task, like filing a note or drafting a spec. Then ask it: \"Which rules in AGENTS.md did you follow, and was anything unclear?\" Its answer tells you what to tighten.",[883,884,885],"style",{},"html pre.shiki code .s3WQq, html code.shiki .s3WQq{--shiki-default:#859289}html pre.shiki code .sPuRg, html code.shiki .sPuRg{--shiki-default:#E67E80;--shiki-default-font-weight:bold}html pre.shiki code .sY0Nt, html code.shiki .sY0Nt{--shiki-default:#D3C6AA}html pre.shiki code .sBO76, html code.shiki .sBO76{--shiki-default:#E69875;--shiki-default-font-weight:bold}html pre.shiki code .safYi, html code.shiki .safYi{--shiki-default:#E67E80}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sAuXP, html code.shiki .sAuXP{--shiki-default:#859289;--shiki-default-font-weight:bold}html pre.shiki code .sySyC, html code.shiki .sySyC{--shiki-default:#DBBC7F}html pre.shiki code .sRC7j, html code.shiki .sRC7j{--shiki-default:#A7C080}",{"title":466,"searchDepth":11,"depth":48,"links":887},[888,889,890,891,892],{"id":382,"depth":11,"text":383},{"id":452,"depth":11,"text":453},{"id":734,"depth":11,"text":735},{"id":777,"depth":11,"text":778},{"id":877,"depth":11,"text":878},"md",{},[176,63,235],{"title":319,"description":320},"docs\u002Fplaybooks\u002Fwrite-your-agents-md","QKXlieKwJx4p0_ev_Xb9iBHgPhnj-4nhaYwzuMBrCjE",1790706078879]