aws-samples / aws-samples/sample-autonomous-cloud-coding-agents
Docs: Zero Trust "impossible vs tedious" design test in SECURITY.md
- Dominant language
- TypeScript
- Stars
- 143
- Forks
- 46
- Avg merge
- 3d 9h
- Merged PRs (30d)
- 20
Description
**Context:** ROADMAP.md → Zero Trust control review
---
## Doc area
Design / architecture (`docs/design/`)
## Describe the issue
Roadmap calls for a standing **design test** in `SECURITY.md`: prefer controls that **remove capability** over friction-only mitigations (rate limits, observe-only DNS). No documented criterion for prioritizing DNS enforcement, credential scoping, and containment vs throttling.
## Affected docs
- `docs/design/SECURITY.md` (primary)
- `docs/guides/DEVELOPER_GUIDE.md` (link from security section)
- ADR candidate if governance wants formal status
## Suggested change
1. Add section **"Impossible vs tedious"** with decision rubric and examples (DNS enforce mode, credential binding, circuit breaker vs turn caps only).
2. Checklist for PR reviewers on security-sensitive changes.
3. Cross-link behavioral circuit breaker and emergency containment drafts.
4. Run `mise //docs:sync` after edit.
## Other information
- Lightweight doc issue; no runtime code required.
- Aligns with ADR-009 security posture themes.
Contributor guide
Research direction
Start with docs/design/SECURITY.md and the Zero Trust control review in ROADMAP.md, then inspect docs/guides/DEVELOPER_GUIDE.md for the security-section link. Add the “Impossible vs tedious” rubric, reviewer checklist, examples, and cross-links to the behavioral circuit breaker and emergency containment drafts; run mise //docs:sync when finished.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation, security
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-2 days
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 75/100