golem15/msd-core
3
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

docs(#3043): add caution blocks for --dangerously-skip-permissions (#3121)

Browse Source 
* docs(#3043): add caution blocks for --dangerously-skip-permissions

The flag was presented without a caveat in docs/USER-GUIDE.md,
docs/tutorials/onboarding-an-existing-codebase.md, and all four translated
locales. Only the English first-project tutorial carried a proper [!CAUTION]
block. All 10 uncaveated occurrences now carry the same caution block
(optional flag, throwaway/low-stakes use, how to keep confirmations, link
to security model).

* chore(#3043): backfill changeset PR number 3121

---------

Co-authored-by: sim <sim@local>
This commit is contained in:
Tom Boucher
2026-08-06 10:56:53 -04:00
committed by GitHub
parent b181c2f8c3
commit 610ebdebe8
11 changed files with 75 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
.changeset/steady-seals-march.md Normal file
View File

@@ -0,0 +1,5 @@
---
type: Fixed
pr: 3121
---
**Documentation now consistently warns about `--dangerously-skip-permissions`** — the flag was presented without a caveat in the user guide, the onboarding tutorial, and all four translated locales (ja-JP, zh-CN, ko-KR, pt-BR), while the English first-project tutorial carried a proper caution. All occurrences now carry the same `[!CAUTION]` block. (#3043)

7
docs/USER-GUIDE.md
View File

@@ -524,6 +524,13 @@ claude --dangerously-skip-permissions
/gsd-pause-work --report # Generate session summary
```
> [!CAUTION]
> **The permissions flag is optional.** It skips per-file confirmation while
> GSD's sub-agents read and write files. Use it only in low-stakes or
> throwaway contexts. To keep confirmations enabled, start with `claude` instead.
> For real work, read the [security model](../explanation/security-model.md) first.
### New Project from Existing Document
```bash

7
docs/ja-JP/USER-GUIDE.md
View File

@@ -458,6 +458,13 @@ claude --dangerously-skip-permissions
/gsd-pause-work --report # Generate session summary
```
> [!CAUTION]
> **The permissions flag is optional.** It skips per-file confirmation while
> GSD's sub-agents read and write files. Use it only in low-stakes or
> throwaway contexts. To keep confirmations enabled, start with `claude` instead.
> For real work, read the [security model](../explanation/security-model.md) first.
### 既存ドキュメントからの新規プロジェクト
```bash

7
docs/ja-JP/tutorials/onboarding-an-existing-codebase.md
View File

@@ -42,6 +42,13 @@ npx @opengsd/gsd-core@latest
claude --dangerously-skip-permissions
```
> [!CAUTION]
> **The permissions flag is optional.** It skips per-file confirmation while
> GSD's sub-agents read and write files. Use it only in low-stakes or
> throwaway contexts. To keep confirmations enabled, start with `claude` instead.
> For real work, read the [security model](../explanation/security-model.md) first.
---
## ステップ 3 — Brownfield オンボーディングの開始

7
docs/ko-KR/USER-GUIDE.md
View File

@@ -463,6 +463,13 @@ claude --dangerously-skip-permissions
/gsd-pause-work --report # Generate session summary
```
> [!CAUTION]
> **The permissions flag is optional.** It skips per-file confirmation while
> GSD's sub-agents read and write files. Use it only in low-stakes or
> throwaway contexts. To keep confirmations enabled, start with `claude` instead.
> For real work, read the [security model](../explanation/security-model.md) first.
### 기존 문서로 새 프로젝트
```bash

7
docs/ko-KR/tutorials/onboarding-an-existing-codebase.md
View File

@@ -42,6 +42,13 @@ npx @opengsd/gsd-core@latest
claude --dangerously-skip-permissions
```
> [!CAUTION]
> **The permissions flag is optional.** It skips per-file confirmation while
> GSD's sub-agents read and write files. Use it only in low-stakes or
> throwaway contexts. To keep confirmations enabled, start with `claude` instead.
> For real work, read the [security model](../explanation/security-model.md) first.
---
## Step 3 — 브라운필드 온보딩 시작

7
docs/pt-BR/USER-GUIDE.md
View File

@@ -463,6 +463,13 @@ claude --dangerously-skip-permissions
/gsd-pause-work --report # Generate session summary
```
> [!CAUTION]
> **The permissions flag is optional.** It skips per-file confirmation while
> GSD's sub-agents read and write files. Use it only in low-stakes or
> throwaway contexts. To keep confirmations enabled, start with `claude` instead.
> For real work, read the [security model](../explanation/security-model.md) first.
### Novo projeto a partir de um documento existente
```bash

7
docs/pt-BR/tutorials/onboarding-an-existing-codebase.md
View File

@@ -42,6 +42,13 @@ Escolha **Claude Code** e **local** quando solicitado. Você verá:
claude --dangerously-skip-permissions
```
> [!CAUTION]
> **The permissions flag is optional.** It skips per-file confirmation while
> GSD's sub-agents read and write files. Use it only in low-stakes or
> throwaway contexts. To keep confirmations enabled, start with `claude` instead.
> For real work, read the [security model](../explanation/security-model.md) first.
---
## Passo 3 — Iniciar o onboarding brownfield

7
docs/tutorials/onboarding-an-existing-codebase.md
View File

@@ -42,6 +42,13 @@ Choose **Claude Code** and **local** when prompted. You'll see:
claude --dangerously-skip-permissions
```
> [!CAUTION]
> **The permissions flag is optional.** It skips per-file confirmation while
> GSD's sub-agents read and write files. Use it only in low-stakes or
> throwaway contexts. To keep confirmations enabled, start with `claude` instead.
> For real work, read the [security model](../explanation/security-model.md) first.
---
## Step 3 — Start brownfield onboarding

7
docs/zh-CN/USER-GUIDE.md
View File

@@ -462,6 +462,13 @@ claude --dangerously-skip-permissions
/gsd-pause-work --report # Generate session summary
```
> [!CAUTION]
> **The permissions flag is optional.** It skips per-file confirmation while
> GSD's sub-agents read and write files. Use it only in low-stakes or
> throwaway contexts. To keep confirmations enabled, start with `claude` instead.
> For real work, read the [security model](../explanation/security-model.md) first.
### 从现有文档新建项目
```bash

7
docs/zh-CN/tutorials/onboarding-an-existing-codebase.md
View File

@@ -42,6 +42,13 @@ npx @opengsd/gsd-core@latest
claude --dangerously-skip-permissions
```
> [!CAUTION]
> **The permissions flag is optional.** It skips per-file confirmation while
> GSD's sub-agents read and write files. Use it only in low-stakes or
> throwaway contexts. To keep confirmations enabled, start with `claude` instead.
> For real work, read the [security model](../explanation/security-model.md) first.
---
## 第 3 步 — 开始 brownfield onboarding