grok-bot

Grok Bot desks sharing files: one owner per file and a handoff note

When several Grok Bot desks work on one project, file sharing is a convention you set up, not a feature to rely on. Pick an agreed folder for the project, give every file exactly one owner desk, let the other desks read but not edit it, and have the owner leave a short handoff note when work changes hands. Grok Bot gives you separate bots with their own chats, messages between bots, and group chats. Use the messages to say "this is ready"; use the files to hold the work. Write the rules into each bot's description, including a stop-before-send rule, so every desk follows the same contract.

Who this is for

You have a writer desk, a reviewer desk, and maybe a publisher desk working on the same project, and you've already seen two of them edit the same file in the same hour.

What Grok Bot gives you, and what you add

From Grok BotConvention you add
Separate desksSeparate bots, each with its own chatsOne role per desk, written in its description
Telling the next deskMessages between bots, group chats"Message the owner when your file is ready"
Where work lives—One agreed folder per project
Who edits what—One owner per file; everyone else reads only
Context at handoff—A short handoff note next to the file
External actions—A stop-before-send rule in each description

Nothing in the right-hand column is enforced for you. It works because every desk's instructions say the same thing.

Set it up

  1. Agree on a folder. For example `projects/<project>/` with `drafts/`, `reviews/`, and `handoffs/` inside it. Put the layout in every desk's description.
  2. Assign owners. A short ownership list at the top of the folder: `drafts/* → Writer`, `reviews/* → Reviewer`. One owner per file, no exceptions.
  3. Read, don't edit. Non-owners read the file and ask the owner for changes by message.
  4. Leave a handoff note. When work moves, the owner writes a note in `handoffs/`.
  5. Add stop-before-send. Each description says: "Before sending, posting, or publishing anything outside the project, stop and ask me."

A sample handoff note

markdown
# Handoff: post-12 draft → Reviewer
- File: projects/blog/drafts/post-12.md
- Changed: rewrote the intro, added the FAQ
- Owner now: Writer (unchanged); Reviewer comments go in reviews/post-12.md
- Next: Reviewer checks claims and links
- Open questions: is the pricing line current?

Then the owner messages the next desk, or posts in the group chat, with the note's path.

Pitfalls

  • Two owners for one file. "Both desks can edit it" is how changes get lost. Split the file or pick one owner.
  • Silent handoffs. A file that changed without a message waits until someone happens to look. Always pair the note with a message.
  • Rules in one desk only. If the reviewer's description doesn't say "read only," the convention breaks. Put the same rules in every description.
  • Assuming the product guards the files. Don't count on locking or conflict detection. The ownership list is your guard, so keep it current.
  • Leaving out stop-before-send. Shared files make it easy for a desk to pick up finished work and act on it. Write the rule down.

How to check it

  1. Open the ownership list and confirm every file in the folder has one owner.
  2. Pick a recent handoff and check that there's a note and a matching message.
  3. Ask a non-owner desk to "fix a typo" in a file it doesn't own and confirm it asks the owner instead.
  4. Ask a desk to send something and confirm it stops and asks you first.

For more on keeping agent instructions in one predictable file, see the AGENTS.md guide for Cursor, Claude Code, and Codex. Pair this convention with a handoff state file and a desk action log.

Where ShipKits fits

The Operator Pack ($47) is markdown seats + skills + install.sh — not a hosted app, not a chatbot. Seven named seats, three skills, an ops playbook and a token-cost playbook. Done means a file, PR, or URL. Role-file templates include sections for folder layout, file ownership, handoff notes, and a stop-before-send rule. Soft path: start at /free. Cheat Sheet for the skim checklist mindset.

Soft next step

Write a one-page ownership list for your busiest project folder and paste the same rules into each desk's description. Soft ladder: /free, then the Operator Pack ($47). Related: AGENTS.md guide, desk handoff, action log.

FAQ

Can Grok Bot desks work on the same files?+

They can work from the same project files if you set them up that way. How they share is a convention you write into each desk's instructions, such as a folder per project and an owner for each file.

How do I stop two desks overwriting the same file?+

Give every file one owner desk, and tell the other desks to read it but not edit it. If another desk needs a change, it asks the owner.

What is a file owner in a desk setup?+

The one desk allowed to edit a given file. It's a rule you write into the desks' instructions, not something the product enforces.

What goes in a handoff note?+

Which file changed, what changed, who owns it now, and what the next desk should do. Keep it to a few lines.

Should desks message each other or just edit files?+

Both. Files hold the work, and a message between bots, or a post in a group chat, tells the next desk it's ready.

How does this differ from a handoff state file?+

A handoff state file tracks where a task stands and who owns the next step. File ownership rules decide who may edit each piece of work.

Get the free starter

Value first, then a kit when you are ready. No fake urgency. Start with Harness Desk Starter at /free.