Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Planowanie

briefing

/briefing

Prowadzi ustrukturyzowany wywiad odkrywczy dla projektu: wizja, użytkownicy, ograniczenia i stos technologiczny.

Repozytorium
cstk ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Prowadzi ustrukturyzowany wywiad odkrywczy dla projektu: wizja, użytkownicy, ograniczenia i stos technologiczny.

Wyzwalacze z opisu

briefingdiscoveryiniciar projetokickoff

Argumenty

/briefing [descricao inicial do projeto ou vazio para entrevista completa]
Oryginalny opis (EN)

Structured project discovery interview (vision, users, constraints, stack). Triggers: "briefing", "discovery", "iniciar projeto", "kickoff". Skip if briefing already complete and user did not ask for update.

Jak działa

  1. Pre-requisitos
  2. Proximos passos
  3. Argumentos
  4. FLUXO DE EXECUCAO
  5. ETAPA 1: CONTEXTO
  6. ETAPA 2: TRIAGEM
  7. ETAPA 3: ENTREVISTA
  8. ETAPA 4: SINTESE
  9. ETAPA 5: VALIDACAO
  10. ETAPA 6: SALVAMENTO
Sekcje z nagłówków SKILL.md, w oryginale · 411 linii, 2 104 słów
Podgląd SKILL.md
---
name: briefing
description: 'Structured project discovery interview (vision, users, constraints, stack). Triggers: "briefing", "discovery", "iniciar projeto", "kickoff". Skip if briefing already complete and user did not ask for update.'
argument-hint: "[descricao inicial do projeto ou vazio para entrevista completa]"
allowed-tools:
  - Read
  - Write
  - Edit
  - Glob
  - Grep
  - Bash
  - AskUserQuestion
---

# Skill: Briefing de Projeto

Conduza uma entrevista estruturada de discovery para capturar a essencia do projeto,
produzindo um documento de briefing que serve de fundacao para todos os artefatos SDD.

## Pre-requisitos

Nenhum. Esta e tipicamente a primeira skill do pipeline SDD para novos projetos.
Se ja existe um briefing, esta skill pode atualiza-lo.

## Proximos passos

Apos salvar o briefing, o fluxo sugerido e:

1. `/constitution` — derivar principios de governanca a partir do briefing
2. `/specify` — especificar as features do MVP identificadas no briefing

## Argumentos

$ARGUMENTS

---

## FLUXO DE EXECUCAO

```
1. CONTEXTO        Detectar projeto e artefatos existentes
     |
2. TRIAGEM         Determinar profundidade da entrevista
     |
3. ENTREVISTA      Perguntas estruturadas por dimensao (interativo)
     |
4. SINTESE         Consolidar respostas em documento de briefing
     |
5. VALIDACAO       Confirmar com usuario antes de salvar
     |
6. SALVAMENTO      Salvar e recomendar proximos passos
```

---

## ETAPA 1: CONTEXTO

### 1.1 Detectar Projeto

Leia os seguintes arquivos (se existirem) para entender o que ja se sabe:

```
SEMPRE LER (se existirem):
-- README.md
-- CLAUDE.md
-- docs/briefing.md (briefing atual, caminho canonico)
-- docs/01-briefing-discovery/*.md (briefings legados)
-- docs/constitution.md
-- docs/specs/*/spec.md (specs existentes)
-- package.json, go.mod, pyproject.toml, Cargo.toml (stack tecnica)
```

### 1.2 Verificar Briefing Existente

Procurar briefings existentes (canonico primeiro, legado depois):
1. `docs/briefing.md` (caminho canonico)
2. `docs/01-briefing-discovery/briefing.md` (legado)
3. `docs/01-briefing-discovery/BRIEFING-*.md` (legado)

Se encontrado:
- Carregar conteudo atual
- Identificar secoes incompletas ou marcadas com TODO
- Perguntar ao usuario: "Encontrei um briefing existente. Deseja **atualizar** ou **criar um novo**?"
- Se encontrado APENAS no caminho legado: registrar que o salvamento
  continuara no caminho legado (ver Etapa 6.2) — nunca mover o arquivo
  sem o usuario pedir

Se nao encontrado:
- Seguir para entrevista completa (Etapa 2)

---

## ETAPA 2: TRIAGEM

### 2.1 Analisar Input

Analise $ARGUMENTS e o contexto coletado:

| Cenario | Acao |
|---------|------|
| Argumento vazio, projeto vazio | Entrevista COMPLETA (todas as dimensoes) |
| Argumento vazio, projeto existente | Entrevista FOCADA (apenas gaps detectados) |
| Argumento com descricao do projeto | Entrevista ADAPTADA (preencher o que falta da descricao) |
| Argumento com caminho para documento | Extrair contexto do documento + entrevista complementar |

### 2.2 Preencher o que ja se sabe

Para cada dimensao da entrevista, verificar se a informacao ja existe no contexto:
- Se inferivel de arquivos do projeto: preencher e marcar como `[inferido]`
- Se explicita no argumento: preencher e marcar como `[fornecido]`
- Se desconhecida: incluir na fila de perguntas

### 2.3 Calcular Fila de Perguntas

- **Entrevista completa**: ate 10 perguntas (todas as dimensoes)
- **Entrevista focada/adaptada**: apenas gaps, max 7 perguntas
- Nunca exceder 10 perguntas no total

---

## ETAPA 3: ENTREVISTA

### 3.1 Dimensoes de Discovery

A entrevista cobre 7 dimensoes, com 1-2 perguntas cada. O roteiro completo
(texto de cada pergunta, exemplos, formatos, regras) esta em
`references/discovery-guide.md`. Consultar sob demanda em vez de memorizar.

Dimensoes:

1. **Visao e Proposito** — elevator pitch
2. **Usuarios e Stakeholders** — atores e quem decide
3. **Escopo e Prioridades** — MVP vs pos-MVP, trade-offs
4. **Restricoes** — prazo, equipe, budget, tech
5. **Contexto Tecnico** — stack, infra, integracoes
6. **Qualidade e Padroes** — testes, seguranca, observabilidade, compliance
7. **Visao de Futuro** — evolucao em 6-12 meses

**Perguntas sao feitas UMA POR VEZ**, aguardando resposta antes de avancar.

### 3.1.1 Canal: `AskUserQuestion` para perguntas fechadas

Se a tool `AskUserQuestion` estiver disponivel na sessao, use-a (1 pergunta
por chamada) sempre que a resposta cabe em opcoes enumeraveis — o usuario
escolhe num seletor e ainda tem "Other" automatico para texto proprio:

- **Atualizar vs criar novo** (Etapa 1) — 2 opcoes.
- **Confirmacao de inferencia** (`[inferido]`, ex.: "Detectei Go + PostgreSQL
  pelo `go.mod`/`docker-compose.yml`. Correto?") — opcao confirmando vem
  primeiro com ` (Recommended)`; alternativas plausiveis em seguida.
- **Dimensoes com respostas finitas** — ex.: nivel de testes esperado,
  hospedagem, tamanho de equipe, horizonte de prazo. Ate 4 opcoes; `header`
  com o nome curto da dimensao (<= 12 chars).

Perguntas ABERTAS (elevator pitch, quem sao os usuarios, visao de futuro)
continuam em texto livre — forcar opcoes ali induz a resposta e contamina o
briefing com palavras que nao sao do usuario (ver Gotcha "Nunca reescrever
em jargao tecnico"). Sem a tool (ex.: `claude -p`), tudo em texto.

### 3.2 Regras da Entrevista

Ver detalhamento em `references/discovery-guide.md#regras-da-entrevista`.
Resumo: uma pergunta por vez, maximo 10 total, adaptar ao contexto, confirmar
inferencias, nao julgar respostas.

### 3.3 Transicao entre Perguntas

Apos cada resposta:
- Agradecer brevemente (1 linha max, sem ser efusivo)
- Se a resposta levantar aspecto nao coberto: adicionar pergunta de follow-up (dentro do limite)
- Apresentar proxima pergunta

---

## ETAPA 4: SINTESE

### 4.1 Template do Briefing

Apos encerrar a entrevista, consolidar todas as respostas usando
`templates/briefing.md` (mesmo diretorio desta skill). Estrutura:

1. Visao e Proposito
2. Usuarios e Stakeholders
3. Escopo (MVP / Pos-MVP / Fora de Escopo)
4. Prioridades e Trade-offs
5. Restricoes (prazo, equipe, budget, tecnica)
6. Stack Tecnica
7. Qualidade e Padroes
8. Visao de Futuro
+ Itens a Definir (pendencias)

### 4.2 Regras de Sintese

- **Usar as palavras do usuario** — nao reescrever em jargao tecnico
- **Marcar inferencias** — se algo foi inferido (nao dito explicitamente), indicar com `[inferido]`
- **Marcar pendencias** — itens sem resposta vao para "Itens a Definir"
- **Remover secoes vazias** — se dimensao inteira nao se aplica, remover (nao deixar "N/A")
- **Nao inventar** — se o usuario nao mencionou, nao adicionar

---

## ETAPA 5: VALIDACAO

### 5.1 Apresentar Resumo

Antes de salvar, apresentar ao usuario um resumo executivo:

```markdown
## Resumo do Briefing

**Projeto**: [Nome]
**Resumo**: [1-2 frases]
**Atores**: [N] identificados
**Features MVP**: [N] features
**Stack**: [resumo da stack]
**Restricoes criticas**: [lista curta]
**Itens a definir**: [N] pendencias

Deseja que eu salve este briefing? Ou ha algo a corrigir/complementar?
```

### 5.2 Iterar se Necessario

- Se usuario pedir correcoes: aplicar e re-apresentar resumo
- Se usuario pedir mais perguntas: retomar entrevista (respeitando limite de 10)
- Se usuario aprovar: prosseguir para salvamento

---

## ETAPA 6: SALVAMENTO

### 6.1 Criar Diretorio

Se `docs/` nao existir, criar. O briefing vive na raiz de `docs/`, ao lado
de `constitution.md` — nao depende da hierarquia numerada legada (01-09,
removida na v7):

```
docs/
-- briefing.md
-- constitution.md
-- specs/
```

### 6.2 Salvar Briefing

Caminho canonico: `docs/briefing.md`.

**Excecao (legado preservado)**: se ja existe
`docs/01-briefing-discovery/briefing.md` e NAO existe `docs/briefing.md`,
atualizar o arquivo legado no lugar — nunca mover/duplicar sem o usuario
pedir. Se o usuario pedir migracao explicitamente, mover o arquivo para
`docs/briefing.md` (um unico briefing canonico; nao deixar copia para tras).

Se ja existe um briefing e o usuario pediu **criar um novo** (nao atualizar):
- Salvar o novo como `briefing-[DATE].md` no MESMO diretorio do briefing
  em uso (canonico ou legado)

### 6.3 Reportar

```markdown
## Briefing Salvo

**Arquivo**: docs/briefing.md  (ou o caminho legado, se foi o caso)
**Dimensoes cobertas**: [N]/7
**Itens a definir**: [N]

### Proximos Passos (fluxo SDD recomendado)

1. `/constitution` — Definir principios de governanca baseados no briefing
2. `/specify [feature]` — Especificar features do MVP identificadas
3. `/clarify` — Resolver ambiguidades nas specs geradas
4. `/plan` — Gerar planos tecnicos de implementacao
5. `/create-tasks` — Decompor planos em tarefas executaveis
```

---

## Pre-flight de Bootstrap (apos briefing + plan)

Stacks multi-workspace (monorepo npm/pnpm, Go modules multiplos, Cargo
workspaces, etc) historicamente geram um bloqueio humano cirurgico
`npm install` por workspace — 5 bloqueios em uma so execucao na rodada
de validacao do agente-00c. Cada bloqueio tem mesmo formato e mesma
resposta. Atrito mecanico previsivel deve ser amortizado em batch,
nao resolvido onda-a-onda.

Quando o briefing identificar stack multi-workspace, o agente DEVE
materializar um script de bootstrap antes de declarar o briefing
concluido:

### Passos

1. Identificar workspaces declarados (lendo `plan.md §Project Structure`
   se ja existe, ou pedindo ao usuario no proprio briefing).
2. Gerar `scripts/bootstrap-deps.sh` na raiz do projeto-alvo com uma
   linha por workspace agrupando as dependencias canonicas. Formato:

   ```sh
   #!/bin/sh
   # bootstrap-deps.sh — pre-flight de dependencias para evitar bloqueios
   # cirurgicos npm install no meio da pipeline agente-00c.
   #
   # Rode UMA VEZ antes de /agente-00c.
   #
   # Gerado por: briefing skill (pre-flight de bootstrap)
   # Data: <ISO>
   # Workspaces: <lista>

   set -eu

   echo "==> auth-service"
   npm install --workspace=services/auth-service \
     express@5 zod@3 jsonwebtoken pino

   echo "==> frontend-staff"
   npm install --workspace=services/frontend-staff \
     react@18 react-dom@18 @tanstack/react-query @radix-ui/react-dialog

   # ...
   ```

   Para monorepos com `package.json` na raiz que ja declara workspaces,
   uma alternativa equivalente e listar `npm install` (raiz) +
   `npm install --workspace=<nome> <dep>` para cada workspace.

3. Adicionar nota no `briefing.md` (secao "Setup / Bootstrap"):

   > **Pre-flight obrigatorio**: rode `bash scripts/bootstrap-deps.sh`
   > UMA VEZ antes de invocar `/agente-00c`. Stacks multi-workspace
   > exigem instalacao de dependencias previa para evitar N bloqueios
   > humanos cirurgicos durante a pipeline (FR-018 nao permite
   > `npm install` autonomo).

4. Se o briefing identifica que o projeto **NAO** e multi-workspace,
   pular esse passo — `bootstrap-deps.sh` so faz sentido quando ha 2+
   workspaces. Para single-package, o agente lida com `npm install`
   onda-a-onda sem atrito amplificado.

### Quando aplicar

| Sinal | Aplicar pre-flight? |
|-------|---------------------|
| `package.json` declara `workspaces: [...]` | Sim |
| Multiplos `package.json` em subdiretorios | Sim |
| Go modules multiplos (`go.work`) | Sim (com `go mod download` por modulo) |
| Cargo workspace (`Cargo.toml [workspace]`) | Sim (com `cargo fetch -p <crate>`) |
| Repo single-package | Nao |

### Quando NAO aplicar

- Projetos puramente documentais (sem `package.json`, `go.mod`, etc).
- Briefing identifica que a stack ainda nao esta decidida — gerar
  `bootstrap-deps.sh` antes da decisao de stack vira lixo. Aplicar apos
  o `plan.md` materializar `§Project Structure`.

### Criterio de aceitacao

Apos briefing salvo, executar `bash scripts/bootstrap-deps.sh` (se
gerado) instala todas as dependencias com zero erros. A primeira onda
do `/agente-00c` NAO encontra bloqueio `npm install`.

---

## DIRETRIZES RAPIDAS

- **Entrevista, nao interrogatorio** — tom conversacional, sem pressao
- **Capturar, nao julgar** — o briefing registra; o `/advisor` critica
- **Adaptar, nao seguir cegamente** — se o projeto e simples, pular dimensoes irrelevantes
- **Priorizar MVP** — focar no que importa AGORA, nao no que pode importar depois
- **Respeitar o usuario** — se ele ja sabe o que quer, nao forcar reflexao desnecessaria
- **Alimentar o pipeline** — o briefing deve ser util para `/constitution` e `/specify`

### Relacao com Outras Skills

| Skill | Relacao com Briefing |
|-------|---------------------|
| `constitution` | Consome briefing para derivar principios de governanca |
| `specify` | Consome briefing para contextualizar features |
| `clarify` | Pode refinar ambiguidades do briefing se necessario |
| `advisor` | Pode criticar decisoes registradas no briefing |
| `plan` | Usa briefing como contexto tecnico de alto nivel |

---

## Gotchas

### Uma pergunta por vez — aguardar resposta antes de avancar

Despejar 7 perguntas de uma vez quebra a entrevista. O valor esta no ciclo pergunta-resposta-reflexao-proxima. Enviar bloco significa que o usuario responde em batch, sem reflexao.

### Maximo 10 perguntas TOTAL

Nao exceda por "mais uma coisa importante". Se 10 nao resolveram, registre o que tem e marque o resto como "A Definir" — o briefing e draft, pode ser atualizado depois.

### Inferencias devem ser marcadas `[inferido]` e confirmadas

Quando preencher algo derivado do codigo (ex: stack detectada de `go.mod`), marque `[inferido]` e confirme com uma linha: "Detectei X, correto?". Assumir sem confirmar e arriscar registrar premissa errada como fato.

### Se o usuario responder varias dimensoes de uma vez, registre TODAS

Usuario pragmatico frequentemente responde em texto corrido cobrindo 3 dimensoes. Capture tudo e pule as perguntas equivalentes — nao repita o que ja foi dito so para seguir o roteiro.

### NAO julgar respostas — briefing registra, advisor critica

Se o usuario diz "vou lancar sem testes para ganhar velocidade", registre fielmente. Criticar aqui quebra a confianca da entrevista. A critica e papel do `/advisor`, se o usuario pedir.

### Remover secoes inteiras quando a dimensao nao se aplica

Se o projeto e uma biblioteca interna sem usuarios finais, remover a secao "Usuarios e Stakeholders" em vez de deixar "N/A". Secoes vazias sao ruido para `/constitution` e `/specify` downstream.

### Nunca reescrever em jargao tecnico

Usar as palavras do usuario. Se ele disse "app de caixa", nao trocar por "sistema de ponto-de-venda transacional". O briefing preserva linguagem; o `/plan` traduz em tecnico.

### Caminho canonico vs legado — nunca migrar em silencio

O canonico e `docs/briefing.md`. Projetos antigos tem
`docs/01-briefing-discovery/briefing.md` (hierarquia numerada legada) —
esses continuam sendo atualizados NO LUGAR, e todos os leitores do pipeline
(detect-completion, preflight do feature-00c) aceitam os dois caminhos.
Migrar so com pedido explicito do usuario, movendo (nao copiando): dois
briefings vivos = fonte de verdade ambigua para constitution/specify.
Pliki w paczce (4)
  • SKILL.md 15 KB
  • evals/triggers.jsonl 1 KB
  • references/discovery-guide.md 6 KB
  • templates/briefing.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · jotjunior/cstk100MIT
cwnaze/claude-secretary100MIT
lauradfarbo/chief-of-staff100MIT
getty/briefing100Artistic-2.0

Migawka bazy z 13.11.2026 · wersja paczki 323f3ba79fc7 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90kickoff
    Prowadzi sokratejski wywiad o użytkownikach, sukcesie i ograniczeniach, a wynik zapisuje jako VISION.md.
  • 95interview
    Prowadzi stopniowy wywiad przy wdrażaniu nowego produktu lub projektu: cel, wizja, gwiazda polarna i otoczenie konkurencyjne.
  • 95caro.discovery
    Prowadzi ustrukturyzowany wywiad odkrywczy z użytkownikiem dla Caro, zapisuje transkrypt z anonimizacją i syntetyzuje transkrypty w księdze hipotez po każdych pięciu wywiadach.
  • 100discovery-brief
    Prowadzi ustrukturyzowany wywiad discovery dla nowego projektu klienta i zamienia odpowiedzi w wypełniony brief oraz dokument startowy strategii, pomijając to, co już wiadomo.
  • 100interviewing
    Przepytuje użytkownika o plan lub otwarte pytanie, aż powstanie krótki briefing zawierający same wnioski do kolejnej sesji, bez rozpoczynania wdrożenia.
  • 90project-onboarding
    Ustawia projekt pod wizję operatora: zapisuje North Star, definiuje odbiorców i prowadzi wywiad odkrywczy, bez pisania kodu aplikacji.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.