Open a desk
Create a workshop desk by making its folder, persistent journal, and structured signal directory so a future independent GitHub Copilot session can sit down, read the trail, and continue the workstream.
When to invoke
- "Open a new desk for this workstream."
- "This topic needs its own desk and journal."
- "Create a desk for the security scan."
- "Start a separate frame for ops work."
Desk model
| Element |
Path |
Purpose |
| Desk root |
desks/<desk-name>/ |
Stable home for one focused workstream. |
| Journal |
desks/<desk-name>/journal.md |
Persistent memory; read at session start and written at session end. |
| Signals |
desks/<desk-name>/.signals/ |
Structured JSON signal output consumed by a dashboard. |
A desk is long-running in state, not runtime. The journal carries history forward; each GitHub Copilot session is independent and becomes associated with a desk only by reading and writing that desk's files.
Procedure
- Choose a short, descriptive kebab-case name such as
security-scan, api-review, ops, or cloud-workshop.
- Check whether
desks/<desk-name>/journal.md already exists.
- If the journal exists, do not overwrite it. Resume the desk by reading the journal, unless the operator explicitly renames or archives the existing desk first.
- If the desk is new, create
desks/<desk-name>/journal.md and desks/<desk-name>/.signals/.
- Write the first journal entry with purpose, scope, initial context, and next step.
- Announce the created paths and the desk focus.
Journal requirements
The first entry must be useful to a session starting from zero.
| Field |
What to record |
| Purpose |
The desk's specific focus and why it exists. |
| Scope |
Repositories, domains, systems, or workstreams covered by this desk. |
| Initial context |
Known constraints, assumptions, relevant links inside the repository, or starting state. |
| Next step |
The first concrete action the next session should take. |
When migrating older notes, map any focus/purpose wording into the Purpose field.
Use this exact starting shape:
# <Desk Name> — Journal
## <date> — Desk opened
- **Purpose:** <what this desk focuses on>
- **Scope:** <repos, areas, or work this desk covers>
- **Next step:** <what the first session should do>
Session orientation
- The operator or TA starts a session and says "sit at the
<desk-name> desk".
- The session reads
desks/<desk-name>/journal.md to load priors.
- Work happens; the session uses
signal-write to emit signals and desk-journal to persist state at the end.
- The next session repeats from step 2.
Principles
- A desk is a peer, not a sub-agent. It has equal standing to disagree with other desks.
- The journal is the memory. Without it, the next session starts blind.
- One desk, one focus. If the scope is too broad, open two desks.
- The desk identity comes from the journal that was read, not from a persistent process.
Gotchas
- Never overwrite a live desk: an existing
journal.md means the desk already has state.
- Do not use vague names:
misc and work make future routing worse; use a topic or system name.
- Do not create runtime expectations: opening a desk initializes storage only; it does not launch or keep a process alive.
Output template
## Desk opened
**Status:** created | resumed | blocked
**Desk:** `desks/<desk-name>/`
**Journal:** `desks/<desk-name>/journal.md`
**Signals:** `desks/<desk-name>/.signals/`
### Focus
- Purpose: <desk purpose>
- Scope: <repos, systems, or topics>
- Next step: <first action>
### Notes
- <existing desk handling, archive requirement, or other important detail>
Quality gate
1---2name: desk-open-23description: Create and open a new workshop desk with a journal and .signals directory. Use when the operator wants to start a new workstream, work does not belong to an existing desk, or a topic needs its own durable frame, history, priors, and signal trail.4---56# Open a desk78Create a workshop desk by making its folder, persistent journal, and structured signal directory so a future independent GitHub Copilot session can sit down, read the trail, and continue the workstream.910## When to invoke1112- "Open a new desk for this workstream."13- "This topic needs its own desk and journal."14- "Create a desk for the security scan."15- "Start a separate frame for ops work."1617## Desk model1819| Element | Path | Purpose |20| --- | --- | --- |21| Desk root | `desks/<desk-name>/` | Stable home for one focused workstream. |22| Journal | `desks/<desk-name>/journal.md` | Persistent memory; read at session start and written at session end. |23| Signals | `desks/<desk-name>/.signals/` | Structured JSON signal output consumed by a dashboard. |2425A desk is long-running in state, not runtime. The journal carries history forward; each GitHub Copilot session is independent and becomes associated with a desk only by reading and writing that desk's files.2627## Procedure28291. Choose a short, descriptive kebab-case name such as `security-scan`, `api-review`, `ops`, or `cloud-workshop`.302. Check whether `desks/<desk-name>/journal.md` already exists.313. If the journal exists, do not overwrite it. Resume the desk by reading the journal, unless the operator explicitly renames or archives the existing desk first.324. If the desk is new, create `desks/<desk-name>/journal.md` and `desks/<desk-name>/.signals/`.335. Write the first journal entry with purpose, scope, initial context, and next step.346. Announce the created paths and the desk focus.3536## Journal requirements3738The first entry must be useful to a session starting from zero.3940| Field | What to record |41| --- | --- |42| Purpose | The desk's specific focus and why it exists. |43| Scope | Repositories, domains, systems, or workstreams covered by this desk. |44| Initial context | Known constraints, assumptions, relevant links inside the repository, or starting state. |45| Next step | The first concrete action the next session should take. |4647When migrating older notes, map any `focus/purpose` wording into the Purpose field.4849Use this exact starting shape:5051```markdown52# <Desk Name> — Journal5354## <date> — Desk opened55- **Purpose:** <what this desk focuses on>56- **Scope:** <repos, areas, or work this desk covers>57- **Next step:** <what the first session should do>58```5960## Session orientation61621. The operator or TA starts a session and says "sit at the `<desk-name>` desk".632. The session reads `desks/<desk-name>/journal.md` to load priors.643. Work happens; the session uses `signal-write` to emit signals and `desk-journal` to persist state at the end.654. The next session repeats from step 2.6667## Principles6869- A desk is a peer, not a sub-agent. It has equal standing to disagree with other desks.70- The journal is the memory. Without it, the next session starts blind.71- One desk, one focus. If the scope is too broad, open two desks.72- The desk identity comes from the journal that was read, not from a persistent process.7374## Gotchas7576- **Never overwrite a live desk**: an existing `journal.md` means the desk already has state.77- **Do not use vague names**: `misc` and `work` make future routing worse; use a topic or system name.78- **Do not create runtime expectations**: opening a desk initializes storage only; it does not launch or keep a process alive.7980## Output template8182```markdown83## Desk opened8485**Status:** created | resumed | blocked86**Desk:** `desks/<desk-name>/`87**Journal:** `desks/<desk-name>/journal.md`88**Signals:** `desks/<desk-name>/.signals/`8990### Focus91- Purpose: <desk purpose>92- Scope: <repos, systems, or topics>93- Next step: <first action>9495### Notes96- <existing desk handling, archive requirement, or other important detail>97```9899## Quality gate100101- [ ] The desk name is short, descriptive, and kebab-case.102- [ ] Existing `desks/<desk-name>/journal.md` was checked before writing.103- [ ] A live desk was not overwritten.104- [ ] New desks include both `journal.md` and `.signals/`.105- [ ] The first journal entry records purpose, scope, and next step.106- [ ] The final response states whether the desk was created, resumed, or blocked.
paulasilvatech