This commit intertwines the twin strands of agents and tools, creating an SDK where autonomous intelligence can evolve.

Welcome to Strands Agents!

Author: awsarron

.github/CODEOWNERS

@@ -0,0 +1,5 @@
+# These owners will be the default owners for everything in
+# the repo. Unless a later match takes precedence,
+# @strands-agents/contributors will be requested for
+# review when someone opens a pull request.
+*       @strands-agents/maintainers

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,113 @@
+name: Bug Report
+description: Report a bug in the Strands CLI
+title: "[BUG] "
+labels: ["bug", "triage"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report for Strands AGENTS SDK!
+  - type: checkboxes
+    id: "checks"
+    attributes:
+      label: "Checks"
+      options:
+        - label: "I have updated to the lastest minor and patch version of Strands"
+          required: true
+        - label: "I have checked the documentation and this is not expected behavior"
+          required: true
+        - label: "I have searched [./issues](./issues?q=) and there are no duplicates of my issue"
+          required: true
+  - type: input
+    id: strands-agents-builder-version
+    attributes:
+      label: Strands CLI Version
+      description: Which version of Strands Agents Builder CLI are you using?
+      placeholder: e.g., 0.5.2
+    validations:
+      required: true
+  - type: input
+    id: strands-tools-version
+    attributes:
+      label: Strands Tools Version
+      description: Which version of Strands Agents Tools are you using?
+      placeholder: e.g., 0.5.2
+    validations:
+      required: true
+  - type: input
+    id: strands-version
+    attributes:
+      label: Strands Version
+      description: Which version of Strands Agents SDK are you using?
+      placeholder: e.g., 0.5.2
+    validations:
+      required: true
+  - type: input
+    id: python-version
+    attributes:
+      label: Python Version
+      description: Which version of Python are you using?
+      placeholder: e.g., 3.10.5
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      description: Which operating system are you using?
+      placeholder: e.g., macOS 12.6
+    validations:
+      required: true
+  - type: dropdown
+    id: installation-method
+    attributes:
+      label: Installation Method
+      description: How did you install Strands?
+      options:
+        - pip
+        - git clone
+        - binary
+        - other
+    validations:
+      required: true
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Detailed steps to reproduce the behavior
+      placeholder: |
+        1. Install Strands using...
+        2. Run the command...
+        3. See error...
+    validations:
+      required: true
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: A clear description of what you expected to happen
+    validations:
+      required: true
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: Actual Behavior
+      description: What actually happened
+    validations:
+      required: true
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Any other relevant information, logs, screenshots, etc.
+  - type: textarea
+    id: possible-solution
+    attributes:
+      label: Possible Solution
+      description: Optional - If you have suggestions on how to fix the bug
+  - type: input
+    id: related-issues
+    attributes:
+      label: Related Issues
+      description: Optional - Link to related issues if applicable

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,41 @@
+name: Feature Request
+description: Suggest a new feature or enhancement for Strands CLI
+title: "[FEATURE] "
+labels: ["enhancement", "triage"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature for Strands AGENTS SDK!
+  - type: textarea
+    id: problem-statement
+    attributes:
+      label: Problem Statement
+      description: Describe the problem you're trying to solve. What is currently difficult or impossible to do?
+      placeholder: I would like Strands to...
+    validations:
+      required: true
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: Proposed Solution
+      description: Optional - Describe your proposed solution in detail. How would this feature work?
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: Provide specific use cases for the feature. How would people use it?
+      placeholder: This would help with...
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives-solutions
+    attributes:
+      label: Alternatives Solutions
+      description: Optional - Have you considered alternative approaches? What are their pros and cons?
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Include any other context, screenshots, code examples, or references that might help understand the feature request.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,36 @@
+## Description
+[Provide a detailed description of the changes in this PR]
+
+## Related Issues
+[Link to related issues using #issue-number format]
+
+## Documentation PR
+[Link to related associated PR in the agent-docs repo]
+
+## Type of Change
+- Bug fix
+- New feature
+- Breaking change
+- Documentation update
+- Other (please describe):
+
+[Choose one of the above types of changes]
+
+
+## Testing
+[How have you tested the change?]
+
+* `hatch fmt --linter`
+* `hatch fmt --formatter`
+* `hatch test --all`
+
+
+## Checklist
+- [ ] I have read the CONTRIBUTING document
+- [ ] I have added tests that prove my fix is effective or my feature works
+- [ ] I have updated the documentation accordingly
+- [ ] I have added an appropriate example to the documentation to outline the feature
+- [ ] My changes generate no new warnings
+- [ ] Any dependent changes have been merged and published
+
+By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

.gitignore

@@ -0,0 +1,13 @@
+__pycache__*
+.coverage
+.models
+.mypy_cache
+.prompt
+.pytest_cache
+.ruff_cache
+.welcome
+build
+*.bak
+*.egg-info
+dist
+venv

.pre-commit-config.yaml

@@ -0,0 +1,29 @@
+repos:
+  - repo: local
+    hooks:
+      - id: hatch-format
+        name: Format code
+        entry: hatch fmt --formatter
+        language: system
+        pass_filenames: false
+        types: [python]
+        stages: [pre-commit]
+      - id: hatch-lint
+        name: Lint code
+        entry: hatch fmt --linter
+        language: system
+        pass_filenames: false
+        types: [python]
+        stages: [pre-commit]
+      - id: hatch-test
+        name: Unit tests
+        entry: hatch test --cover
+        language: system
+        pass_filenames: false
+        types: [python]
+        stages: [pre-commit]
+      - id: commitizen-check
+        name: Check commit message
+        entry: hatch run cz check --commit-msg-file
+        language: system
+        stages: [commit-msg]