diff --git a/src/project_layouts/vendor/punk/project-0.1/bin/README.md b/src/project_layouts/vendor/punk/project-0.1/bin/README.md
new file mode 100644
index 00000000..3b3c1f98
--- /dev/null
+++ b/src/project_layouts/vendor/punk/project-0.1/bin/README.md
@@ -0,0 +1,3 @@
+Project scripts and executables
+
+These files usually shouldn't be modified directly as they are built from the files in the src folder 
\ No newline at end of file
diff --git a/src/project_layouts/vendor/punk/project-0.1/bin/runtime/README.md b/src/project_layouts/vendor/punk/project-0.1/bin/runtime/README.md
new file mode 100644
index 00000000..c3f03d26
--- /dev/null
+++ b/src/project_layouts/vendor/punk/project-0.1/bin/runtime/README.md
@@ -0,0 +1,26 @@
+runtime Tcl Executables are installed here under the appropriate os_architecture folder.
+e.g
+  windows 64bit binaries under win32-x86_64
+  linux 64 bit binaries under linux-x86_64
+
+The bin/runtime.cmd cross-platform script can be used to download prebuilt Tcl binaries.
+e.g ./bin/runtime.cmd fetch
+This will detect the platform and architecture, creating the containing folder as necessary.
+
+To see existing installed runtimes:
+ ./bin/runtime.cmd list
+Or to compare local runtimes with those available on the artifact server:
+ ./bin/runtime.cmd list -remote
+
+ An installed runtime can then be used to call the src/make.tcl file.
+
+e.g - initial check
+  ./bin/runtime.cmd run src/make.tcl check
+
+e.g - to build (or just copy with latest version number from src if build not required) modules to projectdir/modules 
+  ./bin/runtime.cmd run src/make.tcl modules
+ for libs & modules
+  ./bin/runtime.cmd run src/make.tcl packages
+
+
+
diff --git a/src/project_layouts/vendor/punk/project-0.1/lib/README.md b/src/project_layouts/vendor/punk/project-0.1/lib/README.md
new file mode 100644
index 00000000..693ecd33
--- /dev/null
+++ b/src/project_layouts/vendor/punk/project-0.1/lib/README.md
@@ -0,0 +1,6 @@
+Tcl Libraries which use the pkgIndex.tcl system to load.
+Each library will usually have its own folder in the lib folder.
+Some groups of libraries may have a deeper structure - usually with a pkIndex.tcl at the top level,
+and individual pkgIndex.tcl files further down.
+
+These files shouldn't be modified directly as they are built or copied from the files in the src folder 
diff --git a/src/project_layouts/vendor/punk/project-0.1/modules/README.md b/src/project_layouts/vendor/punk/project-0.1/modules/README.md
new file mode 100644
index 00000000..884a0680
--- /dev/null
+++ b/src/project_layouts/vendor/punk/project-0.1/modules/README.md
@@ -0,0 +1,9 @@
+Tcl Modules 
+These are packaged as .tm file extension and the loadable locations are controlled by functions such as tcl::tm::path add|list|remove
+
+Via the make process, the modules may come from from src/vendormodules - being modules not generally developed within the current project.
+
+They are built from src/modules for those that are directly part of the project.
+
+These files shouldn't be modified directly as they are built or copied from the files in the src folder structure. 
+   
\ No newline at end of file
diff --git a/src/vfs/critcl-3.3.1.vfs/TODO.txt b/src/vfs/critcl-3.3.1.vfs/TODO.txt
new file mode 100644
index 00000000..b0f216b3
--- /dev/null
+++ b/src/vfs/critcl-3.3.1.vfs/TODO.txt
@@ -0,0 +1,13 @@
+
+(7) Document the @placeholders@ available to the various C code fragments.
+
+(8) Note that we can use #define's to make the class and instance
+    types available as fixed named without resorting to placeholders,
+    and still keeping it in a local scope.
+
+---
+
+idea: critcl::cproc -- api to register return types, argument types
+
+      argument types: conversion from Tcl_Obj*, type checking (values)
+      return types:   conversion to Tcl_Obj*, (type/value checking ?)
diff --git a/src/vfs/critclxxx.vfs/TODO.txt b/src/vfs/critclxxx.vfs/TODO.txt
new file mode 100644
index 00000000..b0f216b3
--- /dev/null
+++ b/src/vfs/critclxxx.vfs/TODO.txt
@@ -0,0 +1,13 @@
+
+(7) Document the @placeholders@ available to the various C code fragments.
+
+(8) Note that we can use #define's to make the class and instance
+    types available as fixed named without resorting to placeholders,
+    and still keeping it in a local scope.
+
+---
+
+idea: critcl::cproc -- api to register return types, argument types
+
+      argument types: conversion from Tcl_Obj*, type checking (values)
+      return types:   conversion to Tcl_Obj*, (type/value checking ?)