diff --git a/docs/architecture/package-map.md b/docs/architecture/package-map.md
new file mode 100644
index 0000000..c8762cf
--- /dev/null
+++ b/docs/architecture/package-map.md
@@ -0,0 +1,9 @@
+# Package Responsibility Map
+
+| Package        | Responsibility                                  | Forbidden Dependencies |
+|----------------|------------------------------------------------|------------------------|
+| controller     | Handles user input and orchestrates payment    | domain                 |
+| service        | Contains business logic for payment processing  | integration            |
+| repository     | Data access layer for payment records           | service                |
+| domain         | Defines the core domain models and business rules| controller             |
+| integration     | Communicates with external payment gateways     | domain, service        |
\ No newline at end of file