diff --git a/AGENTS.md b/AGENTS.md
index 4ec00aa..eed7787 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -22,7 +22,42 @@ See @pyproject.toml for project metadata and dependencies.
 ### Repository Layout
 
 ```
-TODO
+.agents/                          # LLM assistant skills and context
+    skills/
+        create-pr/
+            SKILL.md
+        dependencies-management/
+            SKILL.md
+        update-agents-md/
+            SKILL.md
+.github/                          # GitHub configuration and CI/CD workflows
+    workflows/
+        build-test.yml            # Runs full test suite on platform/python matrix
+        draft-release-notes.yml   # Drafts release notes from merged PRs
+        release.yml               # Releases a new version to PyPI
+    release-drafter.yml           # Configuration for release notes drafter
+docs/                             # Documentation
+    tutorials/
+        tutorial.ipynb            # Walk-through of all functionality
+    readme_examples.ipynb         # README examples
+src/
+    valimp/
+        valimp.py                 # Single-module source implementing all functionality
+tests/
+    test_valimp.py                # All tests (comprehensive test suite)
+.pre-commit-config.yaml
+.python-version                   # Pinned python version
+AGENTS.md
+CLAUDE.md
+LICENSE.txt
+MANIFEST.in
+README.md
+mypy.ini
+pyproject.toml
+pytest.ini
+requirements.txt
+ruff.toml
+uv.lock
 ```
 
 ## Technology Stack