Skip to content

Lesson 5: Where things belong

In this lesson: where work is saved so that colleagues and agents find it later.

Chat is the working conversation. Agents treat it as a cache: what stays only in a chat is lost to everyone else. Each kind of result has its home:

WhatWhere it belongs
Shared knowledge: procedures, context, what you have learnedthe Organization’s Knowledgebase
Plans, their status and who is responsiblethe Organization’s Mission Control
An open problem or an uncertaintya GitHub Issue in the repository it concerns
Software and documentationa repository on GitHub, changed by a pull request
A finished file that belongs in no repository, such as a presentationFiles of the Environment
Personal mattersyour Personal Environment, never a Work Environment

Every change to a repository goes as a pull request. If you can only read the repository, the agent writes the proposal as an issue there and mentions who can make the change. Your Organization may call its Modules differently; the agent finds them in the Organization’s own instructions and documents.

Pick one thing from your recent work that a new colleague would need to know: a term, a step of a procedure or a rule. Write it down in two or three sentences. Then send in Chat:

I want to save this for colleagues: [your two or three sentences].
Tell me where it belongs in our Organization (Knowledgebase, Mission
Control, an issue or Files) and why. Check whether something similar
already exists. Do not save anything yet.

Done means: you have one small, real piece of work and you know where it belongs. You will have it saved in lesson 7.