Skip to content

Commit efa60cc

Browse files
sjnimsclaude
andauthored
docs: document intentional git scope limitation in workflow commands (#139)
## Summary - Document that the `allowed-tools` git scope (`git init` only) in workflow commands is intentional - Add post-workflow git operation examples for users to run after completion ## Problem Fixes #136 The workflow commands (`create-plugin.md` and `create-marketplace.md`) only allow `Bash(git init:*)` in their `allowed-tools`. Issue #136 raised whether this should be expanded to include `git add`, `git status`, `git commit`, etc. ## Solution After analysis, the current limitation is **intentionally minimal** (Option C from the issue). This is the correct approach because: 1. **Write tool handles file creation** - Files are created via the Write tool, not bash commands, so `git add` isn't needed mid-workflow 2. **Respects user preferences** - Commit messages, timing, and git workflow vary by team/user 3. **Focus on structure** - The workflow's purpose is structure creation, not managing git history Rather than expanding git permissions, this PR documents the intentional design and provides post-workflow git examples for users. ### Alternatives Considered - **Option A** (`Bash(git:*)`): Too permissive - allows destructive operations like `push --force`, `reset --hard` - **Option B** (add specific subcommands): Unnecessary since Write tool handles file creation ## Changes - `plugins/plugin-dev/commands/create-plugin.md`: Updated Phase 4 step 7 with explanation, added post-workflow git examples - `plugins/plugin-dev/commands/create-marketplace.md`: Updated Phase 4 step 5 with explanation, added post-workflow git examples ## Testing - [x] markdownlint passes - [x] Changes limited to documentation only - [x] No functional changes to workflow behavior --- 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>
1 parent 3572b8a commit efa60cc

2 files changed

Lines changed: 16 additions & 2 deletions

File tree

plugins/plugin-dev/commands/create-marketplace.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -158,10 +158,17 @@ Guide the user through creating a complete plugin marketplace from initial conce
158158
- Available plugins table (to be filled in Phase 5)
159159
- Contributing guidelines (if community)
160160

161-
5. Initialize git repo if creating new directory
161+
5. Initialize git repo if creating new directory (only `git init` is available; additional git operations like staging and committing are left to the user after the workflow completes to respect their commit preferences)
162162

163163
**Output**: Marketplace directory structure created
164164

165+
**Post-workflow git operations** (user can run after completion):
166+
167+
```bash
168+
git add .
169+
git commit -m "feat: initial marketplace structure"
170+
```
171+
165172
---
166173

167174
## Phase 5: Plugin Entry Configuration

plugins/plugin-dev/commands/create-plugin.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -145,10 +145,17 @@ Guide the user through creating a complete, high-quality Claude Code plugin from
145145
```
146146
5. Create README.md template
147147
6. Create .gitignore if needed (for .claude/*.local.md, etc.)
148-
7. Initialize git repo if creating new directory
148+
7. Initialize git repo if creating new directory (only `git init` is available; additional git operations like staging and committing are left to the user after the workflow completes to respect their commit preferences)
149149

150150
**Output**: Plugin directory structure created and ready for components
151151

152+
**Post-workflow git operations** (user can run after completion):
153+
154+
```bash
155+
git add .
156+
git commit -m "feat: initial plugin structure"
157+
```
158+
152159
---
153160

154161
## Phase 5: Component Implementation

0 commit comments

Comments
 (0)