Skip to content

Repository navigation

docs: Update design review workflow docs [doc-updater] #880

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jwbron merged 1 commit into from
Feb 22, 2026
Merged

docs: Update design review workflow docs [doc-updater] #880

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/guides/github-automation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -219,6 +219,8 @@ Only runs on PRs that modify agent-related files:
- `action/**` — Action code and prompt builders
- `.github/workflows/**` — Workflow definitions
- `sandbox/**/*.md` — Sandbox documentation
- `sandbox/bin/**` — Sandbox CLI tools
- `shared/prompts/**` — Shared prompt criteria
- `docs/guides/agent-mode-design.md` — The design guide itself
- `docs/guides/sdlc-pipeline.md` — SDLC pipeline operational guide
- `docs/architecture/**` — Architecture documentation
Expand All @@ -235,6 +237,9 @@ handles correctness, security, and style. Design Review focuses exclusively on:
| Post-processing pipelines | Scripts that parse agent output to take actions the agent could take directly |
| Rigid procedures | Micromanaging step-by-step procedures when objectives would suffice |
| Prompt-level security | Using instructions for constraints that should be sandbox-enforced |
| Direct LLM API calls outside sandbox | Calling the Anthropic API from orchestrator, gateway, or shared code instead of delegating to sandbox containers (enforced by EGG200 linter) |
| Direct API calls bypassing Claude Code | Using raw HTTP calls to the Anthropic API instead of `claude --print` (Claude Code headless mode), which provides tool access and consistent configuration |
| Hardcoded model identifiers | Using full model IDs like `claude-sonnet-4-20250514` instead of short aliases (`sonnet`, `opus`, `haiku`) which auto-adopt the latest version (enforced by EGG201 linter) |

### Review Philosophy

Expand Down