Skip to content

Commit 7fd4eb2

Browse files
villainscodeclaude
villainscode
and
claude
committed
docs: update CHANGELOG, ARCHITECTURE, CONTRIBUTING for v1.1.0
- Add v1.1.0 changelog entry documenting safety rules and consistency fixes - Document Pipeline context table and tool ordering standard in ARCHITECTURE - Add Boundaries requirement and tool ordering convention to CONTRIBUTING - Bump VERSION to 1.1.0 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 08fba9c commit 7fd4eb2

4 files changed

Lines changed: 131 additions & 4 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,22 @@
22

33
All notable changes to this project will be documented in this file.
44

5+
## [1.1.0] - 2026-04-01
6+
7+
### Fixed
8+
9+
- **squad-docs**: Added safety rules — NEVER modify source code, Boundaries (Will/Will Not)
10+
- **squad-plan**: Added safety rules, Boundaries, Bash Whitelist/BLACKLIST (had Write+Bash with zero restrictions)
11+
12+
### Improved
13+
14+
- All 8 agents now include `Pipeline:` line in description for workflow context
15+
- Standardized tool ordering across all agents (`Read, Bash, Glob, Grep` / `Read, Write, Edit, Bash, Glob, Grep`)
16+
- Extracted inline bash restrictions into dedicated `Allowed Commands` / `NEVER Run` sections (squad-audit, squad-review, squad-gitops)
17+
- Replaced emoji (✅/❌) with text (PASS/FAIL) in squad-qa output format for consistency
18+
- Enhanced squad-plan command with output description
19+
- Enhanced squad-debug command with input format and output description
20+
521
## [1.0.0] - 2026-04-01
622

723
### Added

‎CONTRIBUTING.md‎

Lines changed: 55 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,15 +18,53 @@ name: squad-{name}
1818
description: >
1919
What this agent does. Include trigger keywords.
2020
Use PROACTIVELY if it should auto-invoke.
21-
tools: Read, Grep, Glob
21+
Pipeline: where this agent sits in the workflow
22+
tools: Read, Bash, Glob, Grep
2223
model: opus
2324
maxTurns: 15
2425
---
2526

26-
System prompt for the agent goes here.
27-
Describe its role, rules, process, and output format.
27+
You are a [role description].
28+
29+
## Process
30+
1. Step 1...
31+
32+
## Rules
33+
- NEVER [safety constraint]
34+
35+
## Allowed Commands
36+
```
37+
git log, git diff, ...
2838
```
2939
40+
## NEVER Run
41+
```
42+
rm, git commit, ...
43+
```
44+
45+
## Boundaries
46+
47+
**Will:**
48+
- [explicit scope items]
49+
50+
**Will Not:**
51+
- [explicit out-of-scope items] (→ /squad-{other})
52+
53+
## Output Format
54+
```markdown
55+
## Report Title
56+
**Date**: {YYYY-MM-DD}
57+
...
58+
```
59+
```
60+
61+
**Required sections for all agents / 모든 에이전트 필수 섹션:**
62+
- `## Rules` with at least one NEVER clause / NEVER 규칙 최소 1개
63+
- `## Allowed Commands` + `## NEVER Run` (if agent has Bash) / Bash 도구 시 필수
64+
- `## Boundaries` (Will/Will Not) for Write-enabled agents / Write 도구 시 필수
65+
- `## Output Format` with markdown template / 출력 형식 템플릿
66+
- `Pipeline:` line in description / description에 파이프라인 위치
67+
3068
### 2. Command definition: `commands/squad-{name}.md`
3169
3270
```markdown
@@ -71,13 +109,27 @@ Add the new agent name to the `SQUAD_AGENTS` array in `install.sh`.
71109

72110
---
73111

112+
## Tool Ordering Convention / 도구 순서 규칙
113+
114+
Follow this canonical order for the `tools:` field:
115+
116+
`tools:` 필드에 다음 표준 순서를 따르세요:
117+
118+
- **Read-only**: `Read, Bash, Glob, Grep`
119+
- **Write (no Bash)**: `Read, Write, Edit, Glob, Grep`
120+
- **Write + Bash**: `Read, Write, Edit, Bash, Glob, Grep`
121+
122+
---
123+
74124
## Pull Request Guidelines / PR 가이드라인
75125

76126
1. One agent per PR / PR당 하나의 에이전트
77127
2. Include both `agents/` and `commands/` files / 두 파일 모두 포함
78128
3. Test with `bash install.sh` locally / 로컬에서 설치 테스트
79129
4. Update README agent table if adding new agents / 새 에이전트 추가 시 README 테이블 갱신
80130
5. Use [Conventional Commits](https://www.conventionalcommits.org/) / Conventional Commits 사용
131+
6. All Write-enabled agents MUST have Boundaries section / Write 에이전트는 반드시 Boundaries 포함
132+
7. All Bash-enabled agents MUST have Allowed Commands + NEVER Run / Bash 에이전트는 명령어 제한 필수
81133

82134
---
83135

‎VERSION‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
1.0.0
1+
1.1.0

‎docs/ARCHITECTURE.md‎

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,8 @@ squad-plan → [implement] → squad-review → squad-qa → squad-gitops
7171

7272
- User stories (US-001...) + SVG/HTML wireframes (`docs/wireframes/`) + implementation plan
7373
- Analyzes existing code structure before designing
74+
- **Boundaries**: NEVER modifies source code. Writes only to `docs/wireframes/` and `docs/plans/`
75+
- **Bash restricted**: Whitelist (git, grep, cat, find) / Blacklist (npm, node, rm, mv)
7476

7577
### squad-refactor — Refactoring / 리팩토링
7678

@@ -95,6 +97,7 @@ squad-plan → [implement] → squad-review → squad-qa → squad-gitops
9597

9698
- README, API docs, architecture docs, JSDoc/TSDoc
9799
- `<!-- auto-generated -->` markers for auto-generated sections
100+
- **Boundaries**: NEVER modifies source code logic. Documentation files and JSDoc comments only
98101

99102
### squad-gitops — Git Automation / Git 자동화
100103

@@ -108,8 +111,29 @@ squad-plan → [implement] → squad-review → squad-qa → squad-gitops
108111

109112
---
110113

114+
## Pipeline Context / 파이프라인 컨텍스트
115+
116+
Each agent's `description` includes a `Pipeline:` line indicating its position in the workflow. This provides workflow context both to Claude Code (for auto-delegation) and to the SubagentStop hook.
117+
118+
각 에이전트의 `description`에 `Pipeline:` 라인이 포함되어 워크플로우 위치를 명시합니다. Claude Code의 자동 위임과 SubagentStop 훅 양쪽에 컨텍스트를 제공합니다.
119+
120+
| Agent | Pipeline Position |
121+
|-------|-------------------|
122+
| squad-plan | `START → implement → /squad-review` |
123+
| squad-review | `APPROVE → /squad-qa, REQUEST_CHANGES → /squad-refactor` |
124+
| squad-refactor | `→ /squad-review (re-verify)` |
125+
| squad-qa | `→ /squad-gitops` |
126+
| squad-gitops | `after /squad-qa PASS → commit/PR` |
127+
| squad-debug | `on-demand. After fix → /squad-qa → /squad-gitops` |
128+
| squad-audit | `on-demand, typically before deployment` |
129+
| squad-docs | `on-demand, any time during development` |
130+
111131
## SubagentStop Chaining / 체이닝
112132

133+
The `subagent-chain.sh` hook complements the Pipeline context by showing next-step guidance after each agent completes.
134+
135+
`subagent-chain.sh` 훅은 에이전트 완료 후 다음 단계 안내를 표시하여 Pipeline 컨텍스트를 보완합니다.
136+
113137
| Completed | Suggests |
114138
|-----------|----------|
115139
| squad-plan | → implement, then `/squad-review` |
@@ -136,6 +160,41 @@ Global override: `export CLAUDE_CODE_SUBAGENT_MODEL=sonnet`
136160

137161
---
138162

163+
## Tool Ordering Standard / 도구 순서 표준
164+
165+
All agents follow a canonical tool ordering convention:
166+
167+
모든 에이전트는 통일된 도구 순서 규칙을 따릅니다:
168+
169+
| Type | Tools | Agents |
170+
|------|-------|--------|
171+
| Read-only | `Read, Bash, Glob, Grep` | audit, debug, gitops, review |
172+
| Read + Bash | `Read, Bash, Glob, Grep` | qa |
173+
| Write (no Bash) | `Read, Write, Edit, Glob, Grep` | docs |
174+
| Write + Bash | `Read, Write, Edit, Bash, Glob, Grep` | plan, refactor |
175+
176+
### Bash Restriction Format / Bash 제한 형식
177+
178+
All agents with Bash access use standardized sections:
179+
180+
Bash 접근 권한이 있는 모든 에이전트는 표준화된 섹션을 사용합니다:
181+
182+
```markdown
183+
## Allowed Commands
184+
185+
```
186+
{whitelisted commands}
187+
```
188+
189+
## NEVER Run
190+
191+
```
192+
{blacklisted commands}
193+
```
194+
```
195+
196+
---
197+
139198
## Frontmatter Reference / Frontmatter 레퍼런스
140199

141200
| Field | Required | Default | Description |

0 commit comments

Comments
 (0)