Criar um Workshop

Configure um novo workshop — o diretório raiz onde as mesas ficam.

Quando usar

• O operador diz "criar um workshop" ou "iniciar um novo workshop"
• O operador quer organizar o trabalho sob uma raiz compartilhada
• O operador tem um diretório existente que quer usar como workshop

Dois caminhos

Caminho A: Usar um diretório existente

O operador já tem uma pasta que quer usar. Talvez seja um repositório que ele clonou, talvez seja uma pasta de projeto local.

1. Confirme se o caminho existe. Se não, peça ao operador um caminho válido.
2. Detecte marcadores de workshop existentes. Procure por pastas desks/ ou classroom/, um workshop.md, CAIRN.md ou hands-up.md. Encontrar qualquer um desses indica que este é um workshop existente — mas isso é apenas detecção, não um ponto de parada. Continue para a próxima etapa e adicione o que estiver faltando; nunca sobrescreva o que já está lá.
3. Estruture a estrutura do workshop (apenas o que estiver faltando):

   <path>/
     desks/           # where desks live
     bench/            # shared workspace
     CAIRN.md          # operating disposition
     README.md         # workshop map
   

4. NÃO execute git init. O diretório pode já ser um repositório git, ou o operador pode não querer um ainda. Deixe o estado do git como está.
5. NÃO crie um repositório GitHub. Este caminho é apenas local.

Caminho B: Criar um novo repositório privado no GitHub

O operador quer um workshop novo com suporte de um repositório GitHub.

1. Obtenha o nome do workshop. Curto, sem espaços, preferencialmente em kebab-case.
2. Escolha e valide um pai de clone. gh repo create --clone clona para o diretório de trabalho atual, então escolha um diretório pai explícito primeiro (pergunte ao operador, ou use o diretório de workshops configurado dele) e confirme que ele não está dentro de um repositório git:

   git -C <parent-dir> rev-parse --is-inside-work-tree
   

   Se isso imprimir true, escolha um pai diferente — caso contrário, o novo repositório será aninhado dentro do existente. Crie o pai, se necessário.
3. Crie e clone o repositório a partir desse pai:

   cd <parent-dir>
   gh repo create <owner>/<name> --private --clone
   

   Use a conta GitHub conectada do operador como <owner>.
4. Estruture a estrutura do workshop dentro do repositório clonado. O Git não rastreia diretórios vazios, então adicione um placeholder em cada pasta que, de outra forma, estaria vazia, ou a estrutura não sobreviverá ao próximo clone:

   <name>/
     desks/.gitkeep
     bench/.gitkeep
     CAIRN.md
     README.md
   

5. Faça commit e push da estrutura, incluindo os placeholders .gitkeep.

Crítico: Nunca aninhe repositórios

Nunca execute git init dentro de um diretório que já está dentro de um repositório git. Antes de inicializar, verifique:

git -C <parent-dir> rev-parse --is-inside-work-tree

Se isso retornar true, o pai já é um repositório git. NÃO crie outro repositório dentro dele. Ou:

• Use o Caminho A (apenas estruture, sem git)
• Ou clone para um local diferente que não esteja dentro de um repositório

Conteúdo do CAIRN.md

A disposição operacional que cada mesa lê:

# cairn

the trail markers that say: someone was here, and they were honest.

## how a desk stands

- **stop is a valid finish.** don't force a result when the evidence
  says stop. "this doesn't work" is a finding, not a failure.
- **"done" means it holds.** if you'd bet your desk on it, ship it.
  if not, say what's uncertain and why.
- **hold scope.** touch only what the task needs. if you find something
  outside scope, note it and move on — don't chase it.
- **never go silent, never bluff.** partial + honest > complete + wrong.
  if you're stuck, say so. if you're unsure, say that too.
- **equal standing.** you can say "that's the wrong question." you can
  disagree with another desk. you answer to evidence, not hierarchy.

## the bench

the shared workspace. leave your work where others can find it.
label it. if it supersedes earlier work, say so.

## hands-up

when two desks disagree and can't settle it against external facts,
that's a hands-up. it goes to the operator. this is the system
working, not failing.

Após a criação

Informe ao operador:

• Onde o workshop está localizado (caminho completo)
• Que ele agora pode abrir mesas nele com desk-open
• Que o Cairn mostrará sinais assim que as mesas começarem a emiti-los

Princípios

• Um workshop é um lugar, não um produto. Mantenha-o simples.
• O operador decide onde as coisas vão. Não presuma.

…