diff --git a/docs/fix-docker-compose-dev-ym_spec.md b/docs/fix-docker-compose-dev-ym_spec.md
new file mode 100644
index 0000000..5ae2714
--- /dev/null
+++ b/docs/fix-docker-compose-dev-ym_spec.md
@@ -0,0 +1,13 @@
+# Technical Specification: Fix docker-compose.dev.yml build contexts and env var mismatch
+
+## Architectural Overview
+Technical documentation and modular design specification for **chainlearn-infra** covering issue #1.
+
+## System Invariants & Design
+- **State Integrity**: Guarantees consistent state transitions across contract and service boundaries.
+- **Resource Efficiency**: Optimizes compute cycles and minimizes redundant state reads.
+- **Maintainability**: Enforces high cohesion and clear separation of concerns across modules.
+
+## Integration & Operational Notes
+- Adheres to standard protocol interfaces.
+- Safe for concurrent caller execution.