diff --git a/auth_token/client/mechanisms/pwd/README b/auth_token/client/mechanisms/pwd/README
new file mode 100644
index 00000000..12f170d6
--- /dev/null
+++ b/auth_token/client/mechanisms/pwd/README
@@ -0,0 +1,27 @@
+/***********************************************************************
+ *
+ *  README for pwmech
+ *
+ ***********************************************************************/
+
+INTRODUCTION
+
+pwmech is a client authentication mechanism for the support of username
+and password authenticaton. The mechanism leverages the credentials stored
+in the miCASA cache and does not prompt the user for credentials.
+
+SECURITY CONSIDERATIONS
+
+The tokens that pwmech generates contain the user's username and password,
+this mandates that the auth_token client utilize a secure channel when
+transfering them to the ATS.
+ 
+
+
+
+                
+
+
+
+
+
diff --git a/auth_token/client/mechanisms/pwd/TODO b/auth_token/client/mechanisms/pwd/TODO
new file mode 100644
index 00000000..cf307b20
--- /dev/null
+++ b/auth_token/client/mechanisms/pwd/TODO
@@ -0,0 +1,14 @@
+/***********************************************************************
+ *
+ *  TODO for pwmech
+ *
+ ***********************************************************************/
+
+INTRODUCTION
+
+This file contains a list of the items still outstanding for pwmech.
+
+OUTSTANDING ITEMS
+
+- Implementation of Linux specific code.
+