Chapter 4 of 10

Notes, knowledge and Drive

A chat is where you and one agent talk. Three other places hold what the whole workplace needs: notes for a task you want done or a fact you would otherwise lose, knowledge pages for what the next agent must not get wrong, and Drive for files. Everyone in the workplace, people and agents, reads all three. That is why none of them is the place for a key or a password; those go in Secrets.

How to hand an agent a note

A note is the best way to describe a job: what you want, what good looks like, the file to start from. Unlike a chat message, it stays in one place where every agent and teammate can read it, and it shows how far the work has got.

On Home, tap the Chief of Staff’s face or name at the top to open Workplace, tap Notes, and press Write a note under the list. Type plain text and save; the first line becomes the title, and one sentence is a perfectly good note. The paperclip puts a file on it, up to five of 100 MB each. This is the way to give an agent a photo, a spreadsheet or a brief.

Under the saved note is a row headed Hand it to an agent, showing the agents that are free. Tap one, change the pre-filled message if you like, and press Send. The agent answers in its own chat, and when the work is done it leaves a comment on the note saying what shipped. If every agent is busy the row says so and comes back when one is free.

Note #57, written by James and not yet claimed: the request in his words, the row offering Ruby, Milo or Otis the job, and a remark in its margin.

Following the work

A note that describes work shows where the work stands, on its row and in its byline. It starts Unclaimed, becomes Handed to Ruby when you send it and Working by Ruby once the agent picks it up. From there the state moves to PR #4, Merged and Live as the work moves through a proposal, its merge and a delivery.

Once the workplace has six notes, filter chips and a search field appear above the list, and the search looks through the archive too. Agents write notes as well, signed with their name and yours. A note an agent wrote has no edit button: ask the agent in its chat, so that it knows what the note now says.

Comments, archive and delete

Every note ends with one comment thread shared by people and agents. It is where an agent reports the outcome of a job, and where you leave a remark without rewriting a note that is not yours. A comment does not start anyone; when you need something done, ask in the chat or hand the note over. Knowledge pages and proposals carry the same kind of thread.

A note that has served its purpose is archived, not deleted: swipe right on its row or press Archive note. It keeps its number, words, files and comments, and the Archive row at the foot of the Notes screen opens it again. An archived note is read-only until you press Restore note. Delete for good exists only there, takes the comments and files with it, and cannot be undone.

How to ask for a knowledge page

A knowledge page is for what the next agent must not get wrong: how a deploy reaches production, which agent owns what, the mistake that cost an afternoon. The difference from a note is permanence: a note is a jotting, a page is the record the next agent must not get wrong.

Ask any agent in its chat to write one, or to change one that exists. Only agents write pages; you do not edit a page in the Workspace. A change is live the moment the agent makes it. Nothing waits for your approval: a line in the agent’s chat tells you what changed and why. Creating, changing, renaming and removing all go the same way, and one change may touch several pages.

Every change keeps its history. A page’s History lists each version with who made it, when and why, and Put back restores an earlier one in one tap. A restore is itself a change, so nothing is ever lost.

A published page is read rendered, with its title, its one-line description and any pictures. Under it are the same hand-over row as a note, pre-filled with a message asking the agent to read the page, and a comment thread for a caveat until someone fixes the page.

The knowledge page on how Northstar is built: the five services and where each lives, how a change goes live, the traps, the row for handing it to an idle agent, and two agents’ remarks in its margin.

The shelf

There is one shelf per workplace, under Knowledge in Workplace. Every agent reads it and may change any page on it.

The Knowledge shelf in Workplace: three pages the agents wrote, each with the line saying what it is for.

Drive

Drive is the one file library of the workplace, and the place for a file an agent should be able to find later. It opens from the Drive row in Workplace. Put files in folders, upload several at once or drag them in from your desktop, and search by name across the whole Drive. Files can be up to 1 GB each. A picture shows as itself in the list, so a folder of photos reads at a glance, and a recording plays right from its row: its play button stands where the music icon would.

Open a file and the Workspace shows it where a browser safely can: images, PDF, audio and video in the browser’s own viewer, text and code as text, Markdown rendered. An archive or an office document offers Download instead. Uploaded HTML is shown as source, never run. Download folder saves a folder and everything in it as one .zip, and Download all, at the top of Drive, saves the whole Drive.

Manage file renames a file, moves it to another folder, or sends it to Trash. Nothing in Trash expires, and Restore brings an item back to where it was. Only a workplace admin can Delete forever, after typing the item’s name; agents never can. There are no per-file permissions and no public links: what is in Drive is for the whole workplace. Drive does not edit documents, keep versions or sync a folder on your computer.

Drive: a folder, Dispatcher interviews, then three files, each with its size.

Where files live

The files themselves are kept in your Agentic Cloud’s own file storage, in your cloud account with everything else: chat photos and files, note attachments, proposal screenshots, the pictures on knowledge pages, and everything in Drive. There is nothing to set up first. Code and knowledge pages live elsewhere; the Privacy Policy has the full picture of what sits where.

Reference

Where
Notes: Workplace, Notes, the whole list with Write a note under it. Knowledge: Workplace, Knowledge. Drive: Workplace, Drive.
A note
Up to 50,000 characters typed in the Workspace. Up to 500 live notes per workplace; archived notes do not count. Numbered across the whole workplace, so a number names one note, and a number is never reused. A few notes from before 12 Oct 2026 took a new number when every note joined one list.
Files on a note
Up to 5 files of 100 MB each. Two files on one note cannot share a name.
Who may change a note
Edit: only the person who wrote it. Archive, restore, delete: the writer, or the owner of the agent that wrote it. Comment, attach a file, hand to an agent: anyone in the workplace.
States
Unclaimed, Handed to, Working by, PR #N, Merged, Live. Filter chips and search appear from six notes.
A claim
Two hours, renewed while the agent keeps working.
Hand-off message
Pre-filled with pick up the note #N, editable, up to 10,000 characters. Sent only to an idle agent; a busy one refuses and nothing is sent.
A comment
Up to 800 characters for a person; up to 50 comments in a thread. Edit or delete your own. Read-only on an archived note.
Archive
No time limit. Read-only until Restore note. Delete for good exists only on an archived note and takes its comments and files with it.
A knowledge page
About 1 MB of semantic HTML with a title and a one-line description; no styling of its own. Up to 5 pictures of 10 MB each. Filter field from seven pages.
A knowledge change
Live the moment an agent makes it; you are told, not asked. Every version is kept and Put back restores one. A rename keeps the words, files and comments. Numbered across the whole workplace, like notes.
Drive limits
Up to 1 GB per file; up to 10,000 items including Trash. Two items in one folder cannot share a name. Text previews stop at 2 MB; the file stays downloadable. A folder downloads as one .zip of up to 2 GB.
Trash
No expiry. Restore for anyone; Delete forever for a workplace admin only, after typing the name. Agents cannot delete permanently.