Write the rules once. Every agent reads them.
Project rules, checklists and references live as documents in Roles, for the whole project or one role. The role document links them.
Role documents 2
NewUpload .mdOnly this role sees these, together with the project documents; a role document with the same name replaces the project one.
empty-statesv1Empty statesRead before you build a list, a table or a search: what to show when there is nothing.
ui-kitv2UI kitRead before any UI change: buttons, fields, colours and spacing the shop uses.
From the project 2
api-conventionsv3API conventionsRead before you add or change an endpoint.
ui-kitv1UI kit
Written once
For the project or one role.
A project document reaches every role; a role document, only that role. Release checklists, coding rules, a style guide, how to deploy: whatever the team should follow.
You or the lead write them.
Write in the dashboard’s editor or drop .md files onto the Documents block. The project’s lead saves them too; other agents read them and can’t change them.
Part of the role.
Duties and goals stay in the role document; documents hold the rules and references around them.
Read when needed
Listed in the role document.
Every agent reads its role document at start. It lists the documents a line each: name, level, version, what it’s for, and a link.
Full text on demand.
An agent opens a document only when its work needs it, so its context isn’t spent on rules it won’t use today.
Kept current
Every change is a version.
Saving adds a new version; nothing is overwritten. Compare versions, roll back by making an older one active, take a document away and bring it back.
Holders are told.
When a document changes, the agents in the roles it reaches are told, so their next step follows the new rules.
Open what agents make.
Attachments open in the task window as they should: CSV and TSV as a table, JSON as a tree you can collapse and search, JSON Lines as a table, diffs coloured by line, code with highlighting, Mermaid diagrams with zoom, pan and full screen, SVG pictures, Jupyter notebooks and XLSX sheets. Video and audio (MP4, WebM, MP3, M4A, OGG, WAV, GIF, up to 200 MB) open in a player.
Limits, honestly
- Documents live per project and per role; there’s no company-wide level.
- Agents read documents; only you and the project’s lead change them.
- A document is text you write, not a memory of past work.
Your first team is one prompt away.
Installing takes one sentence to your agent. To run your agents, harnsy drives a terminal: tmux if it is installed, otherwise its own terminal host (on Windows, always its own).
Install harnsy following https://harnsy.dev/llms.txtQuestions
Do agents remember everything between sessions?
No. Handover notes and consultants carry the work.