mirror of
https://github.com/github/awesome-copilot.git
synced 2026-07-21 21:04:13 +00:00
jennyf19
fa1f154155
Address the remaining doc/skill review findings: - workshop-create: 'gh repo create --clone' clones into the CWD, which nests the new repo when run from inside a checkout. Add an explicit clone-parent selection + 'rev-parse --is-inside-work-tree' guard, and run the create from that parent. - workshop-create: desks/ and bench/ were scaffolded empty, so Git drops them and a later clone loses the scaffold. Scaffold .gitkeep in each and commit the placeholders. - bench-read: make <workshop>/bench/ the primary shared location (the directory workshop-create actually establishes) with desk-local artifacts as a secondary source, instead of treating the repo root as the bench. - the-workshop README: add the Workshop Create skill to the component table so all six packaged components are documented. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 26faf13e-639c-4a21-ac05-c0dc2bff7c62
83 lines
2.9 KiB
Markdown
83 lines
2.9 KiB
Markdown
---
|
|
name: bench-read
|
|
description: 'Read artifacts from the shared bench — the workspace where desks leave findings, verdicts, and work products for each other and the operator.'
|
|
---
|
|
|
|
# Bench Read
|
|
|
|
Read artifacts from the shared workspace (the bench) where desks
|
|
leave work products for each other.
|
|
|
|
## When to use
|
|
|
|
- Starting a session and need to see what other desks have produced
|
|
- Reviewing work before routing it to another desk
|
|
- The operator asks "what's on the bench?" or "show me what desk X found"
|
|
- A desk needs context from another desk's output
|
|
|
|
## What the bench is
|
|
|
|
The bench is `<workshop>/bench/` — the shared workspace directory
|
|
that `workshop-create` establishes for cross-desk work. It's not a
|
|
message queue or a chat channel — it's files. When Desk A produces
|
|
a finding and Desk B needs to review it, the finding is a file
|
|
in `bench/`. When the operator asks "what did the scanning desk
|
|
find?" — you read the bench.
|
|
|
|
Typical bench artifacts:
|
|
- **Findings** — scan results, analysis output, data
|
|
- **Verdicts** — a desk's assessment of another desk's findings
|
|
- **Drafts** — work-in-progress documents, PRs, proposals
|
|
- **Reports** — summaries, dashboards, status updates
|
|
|
|
## Where to look
|
|
|
|
The primary shared location is the `bench/` directory at the
|
|
workshop root — the designated cross-desk workspace. Desk-local
|
|
artifacts under `desks/<desk-name>/` are a secondary source: read
|
|
them when you need a specific desk's own work, but shared artifacts
|
|
belong in `bench/`.
|
|
|
|
```
|
|
<workshop>/
|
|
bench/ # PRIMARY — shared cross-desk artifacts
|
|
<findings, verdicts, drafts, reports>
|
|
desks/<desk-name>/ # secondary — a desk's own workspace
|
|
journal.md # the desk's memory
|
|
<artifacts> # work still local to this desk
|
|
```
|
|
|
|
## How to read
|
|
|
|
1. **List what's there.** Start with the directory structure to see
|
|
what desks exist and what they've produced.
|
|
|
|
2. **Read journals first.** Each desk's journal tells you what it
|
|
worked on and where it left things. The most recent entry is
|
|
the current state.
|
|
|
|
3. **Read artifacts second.** Once you know what to look for from
|
|
the journals, read the specific files.
|
|
|
|
4. **Summarize for the operator.** Don't dump raw content — tell
|
|
the operator what's there, what state it's in, and what needs
|
|
attention.
|
|
|
|
## Cross-desk context
|
|
|
|
When one desk needs another desk's output:
|
|
- Read the producing desk's journal to understand what was done
|
|
- Read the artifact itself
|
|
- Form your own assessment — another desk's output is input, not
|
|
instruction. You can disagree.
|
|
|
|
## Principles
|
|
|
|
- The bench is files, not messages. Desks don't talk to each
|
|
other — they leave artifacts and read each other's work.
|
|
- Read the journal before the artifacts. Context matters.
|
|
- Another desk's verdict is input, not authority. Equal standing
|
|
means you assess independently.
|
|
- When summarizing for the operator, lead with what needs
|
|
attention, not what's routine.
|