aws-samples / aws-samples/sample-autonomous-cloud-coding-agents

Docs: Zero Trust "impossible vs tedious" design test in SECURITY.md

Open Beginner friendly
#493 0 comments 0 reactions 0 assignees View on GitHub
documentation security
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.