strands-agents · opieter-aws · Jun 15, 2026 · Jun 15, 2026
diff --git a/.gitignore b/.gitignore
@@ -73,7 +73,6 @@ Thumbs.db
 bin/
 
 # LLM
-CLAUDE.md
 .claude/settings.local.json
 
 # dev

diff --git a/CLAUDE.md b/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md
diff --git a/site/.gitignore b/site/.gitignore
@@ -21,6 +21,5 @@ docs/api-reference/
 __*__/
 .build
 
-CLAUDE.md
 mise.toml
 *.log
diff --git a/site/CLAUDE.md b/site/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md
diff --git a/strands-py/.gitignore b/strands-py/.gitignore
@@ -14,4 +14,3 @@ repl_state
 .kiro
 uv.lock
 .audio_cache
-CLAUDE.md
diff --git a/strands-py/AGENTS.md b/strands-py/AGENTS.md
@@ -179,7 +179,7 @@ from .tools import Tool
 - **Variables/Functions**: `snake_case`
 - **Classes**: `PascalCase`
 - **Constants**: `UPPER_SNAKE_CASE`
-- **Private members**: Prefix with `_`
+- **Private members, functions, and modules**: Prefix with `_` (e.g. `_helper()`, `_internal.py`)
 
 ### Error Handling
 

diff --git a/strands-py/CLAUDE.md b/strands-py/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md
diff --git a/strands-ts/AGENTS.md b/strands-ts/AGENTS.md
@@ -220,6 +220,7 @@ export class AgentSkillsPlugin implements Plugin { ... }
 - Do NOT include `@example` for type definitions, interfaces, or internal types
 - Interface properties MUST have single-line descriptions
 - TSDoc validation enforced by ESLint
+- Mark exported symbols that are not part of the public API with the `@internal` TSDoc tag. Use this for exports that other modules need but SDK consumers should not depend on.
 
 ### Code Style Guidelines
 

diff --git a/strands-ts/CLAUDE.md b/strands-ts/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md
diff --git a/test-infra/CLAUDE.md b/test-infra/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md
-Original file line number
+Diff line change
@@ Expand Up / @@ -73,7 +73,6 @@ Thumbs.db @@
     bin/
     # LLM
-    CLAUDE.md
     .claude/settings.local.json
     # dev
@@ Expand Down @@