This folder contains internal documentation about how the Strands team builds and maintains the SDK. These documents help contributors understand our design philosophy and decision-making process.
| Document | Description |
|---|---|
| TENETS.md | Core principles that guide SDK design and implementation |
| DECISIONS.md | Record of design and API decisions with rationale |
| API_BAR_RAISING.md | Process for reviewing and approving API changes |
| AGENT_GUIDELINES.md | Guidelines for AI agents that interact with Strands repositories |
When proposing changes to the SDK, please review these documents to understand:
- Tenets — The principles your contribution should align with
- Decisions — Past decisions that may inform your approach
- API Bar Raising — The review process for API changes
- Agent Guidelines — Conventions for agents operating on our repos
If your contribution results in a new decision that could guide future work, consider adding it to DECISIONS.md.