diff --git a/docs/schema-validated-services_spec.md b/docs/schema-validated-services_spec.md
new file mode 100644
index 0000000..2af5c10
--- /dev/null
+++ b/docs/schema-validated-services_spec.md
@@ -0,0 +1,13 @@
+# Technical Specification: schema-validated services dashboard form with inline errors and live regions
+
+## Architectural Overview
+Technical documentation and modular design specification for **Agentpay-frontend** covering issue #628.
+
+## 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.