mirror of
https://github.com/github/awesome-copilot.git
synced 2026-07-21 21:04:13 +00:00
Jenny Ferries
1794cd1b38
- desk-open: standard desk structure now creates .signals/ directory (prevents first signal-write from failing on missing parent dir) - signal-write: note that dashboard reads subtype field, falls back to signal_type for backward compat Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 26faf13e-639c-4a21-ac05-c0dc2bff7c62
68 lines
2.0 KiB
Markdown
68 lines
2.0 KiB
Markdown
---
|
|
name: desk-open
|
|
description: 'Create and open a new desk in the workshop. Sets up the folder structure, initial journal, and desk identity so the next session that sits down finds the trail.'
|
|
---
|
|
|
|
# Open a Desk
|
|
|
|
Create a new desk in the workshop with the standard structure.
|
|
|
|
## When to use
|
|
|
|
- The operator wants to start a new workstream
|
|
- Work arrives that doesn't belong to any existing desk
|
|
- A topic needs its own frame (its own history, its own priors)
|
|
|
|
## What it creates
|
|
|
|
Given a workshop directory and a desk name, create:
|
|
|
|
```
|
|
desks/<desk-name>/
|
|
journal.md # persistent memory — read at start, written at end
|
|
.signals/ # structured signal output (JSON) — dashboard reads this
|
|
```
|
|
|
|
## How to use
|
|
|
|
1. **Choose a name.** Short, descriptive, kebab-case. The name is
|
|
how the operator and other desks refer to this desk.
|
|
Examples: `security-scan`, `api-review`, `ops`, `cloud-workshop`
|
|
|
|
2. **Create the structure.** Make the directory, initial journal,
|
|
and signals folder:
|
|
|
|
```
|
|
desks/<desk-name>/journal.md
|
|
desks/<desk-name>/.signals/
|
|
```
|
|
|
|
3. **Write the first journal entry.** The journal starts with:
|
|
- What this desk is for (its focus/purpose)
|
|
- What repos or work it covers (if applicable)
|
|
- Any initial context the first session needs
|
|
|
|
4. **Announce it.** Tell the operator what was created and what
|
|
the desk's focus is.
|
|
|
|
## Journal format
|
|
|
|
```markdown
|
|
# <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>
|
|
```
|
|
|
|
## 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. Write enough that someone starting from zero finds the way.
|
|
- One desk, one focus. If the scope is too broad, open two desks.
|
|
Each desk's value comes from its specific frame — dilute the
|
|
frame and you lose the value.
|