populated the project with data subfolders.
diff --git a/def/README.md b/def/README.md
new file mode 100644
index 0000000..f613979
--- /dev/null
+++ b/def/README.md
@@ -0,0 +1 @@
+This folder contains all *.def files related to this project
diff --git a/doc/README.md b/doc/README.md
new file mode 100644
index 0000000..76f6c83
--- /dev/null
+++ b/doc/README.md
@@ -0,0 +1 @@
+This folder contains key documents related to this project
diff --git a/gds/README.md b/gds/README.md
new file mode 100644
index 0000000..95722a7
--- /dev/null
+++ b/gds/README.md
@@ -0,0 +1 @@
+This folder contains all *.gds files related to this project
diff --git a/lef/README.md b/lef/README.md
new file mode 100644
index 0000000..387f60b
--- /dev/null
+++ b/lef/README.md
@@ -0,0 +1 @@
+This folder contains all *.lef files related to this project
diff --git a/macros/README.md b/macros/README.md
new file mode 100644
index 0000000..76768c7
--- /dev/null
+++ b/macros/README.md
@@ -0,0 +1 @@
+This folder contains all subcell & macro files related to this project
diff --git a/mag/README.md b/mag/README.md
new file mode 100644
index 0000000..925c17b
--- /dev/null
+++ b/mag/README.md
@@ -0,0 +1 @@
+This folder contains all *.mag files related to this project
diff --git a/ngspice/README.md b/ngspice/README.md
new file mode 100644
index 0000000..f4719ab
--- /dev/null
+++ b/ngspice/README.md
@@ -0,0 +1 @@
+This folder contains all ngspice related files related to this project
diff --git a/openlane/README.md b/openlane/README.md
new file mode 100644
index 0000000..29a345b
--- /dev/null
+++ b/openlane/README.md
@@ -0,0 +1 @@
+This folder contains all openlane related files related to this project
diff --git a/pkg/README.md b/pkg/README.md
new file mode 100644
index 0000000..d87e96e
--- /dev/null
+++ b/pkg/README.md
@@ -0,0 +1 @@
+This folder contains all packaging-related files related to this project
diff --git a/print.sh b/print.sh
new file mode 100644
index 0000000..af1bff1
--- /dev/null
+++ b/print.sh
@@ -0,0 +1,3 @@
+#!/bin/bash
+echo $PWD
+echo /home/mk/zooz/designs/caravel
diff --git a/scripts/README.md b/scripts/README.md
new file mode 100644
index 0000000..20a8231
--- /dev/null
+++ b/scripts/README.md
@@ -0,0 +1 @@
+This folder contains miscelleneous useful scripts
diff --git a/scripts/edit.tcl b/scripts/edit.tcl
new file mode 100644
index 0000000..7b30db2
--- /dev/null
+++ b/scripts/edit.tcl
@@ -0,0 +1,11 @@
+drc off
+puts "Small delay..."
+set macro_mags "digital_pll.mag lvlshiftdown.mag striVe2_soc.mag striVe_clkrst.mag striVe_spi.mag"
+
+gds readonly yes
+gds rescale no
+gds read ../gds/sram_1rw1r_32_256_8_sky130.gds
+lef read ../lef/sram.abs.lef
+foreach ff $macro_mags { drc off; load $ff -dereference; after 1000; select top cell; property LEFview TRUE }
+load striVe2 -dereference
+select top cell
diff --git a/scripts/extract.tcl b/scripts/extract.tcl
new file mode 100644
index 0000000..e5b3731
--- /dev/null
+++ b/scripts/extract.tcl
@@ -0,0 +1,14 @@
+lef read /ef/tech/SW/EFS8A/libs.ref/techLEF/scs8hd/scs8hd_tech.lef
+set macro_mags "./scs8hd_tapvpwrvgnd_1.mag ./scs8hd_conb_1.mag digital_pll.mag lvlshiftdown.mag striVe2_soc.mag striVe_clkrst.mag striVe_spi.mag"
+lef read ../lef/sram.abs.lef
+foreach ff $macro_mags { drc off; after 500; load $ff -dereference; select top cell; property LEFview TRUE }
+
+load striVe2 -dereference
+
+select top cell
+extract do local
+extract
+ext2spice lvs
+ext2spice striVe2.ext
+feedback save warnings.log
+exit
diff --git a/scripts/mag2gds.tcl b/scripts/mag2gds.tcl
new file mode 100644
index 0000000..add65bd
--- /dev/null
+++ b/scripts/mag2gds.tcl
@@ -0,0 +1,21 @@
+# assumes an /ef tree or at least a symlink
+drc off
+gds readonly true
+gds rescale false
+set ::env(MAGTYPE) mag
+
+gds read ../gds/sram_1rw1r_32_256_8_sky130.gds
+
+load striVe2_soc -dereference
+load striVe_spi -dereference
+load striVe_clkrst -dereference
+load digital_pll -dereference
+load lvlshiftdown -dereference
+load striVe2 -dereference
+
+
+select top cell
+
+cif *hier write disable
+
+gds write striVe2.gds
diff --git a/scripts/mag2gds.top.tcl b/scripts/mag2gds.top.tcl
new file mode 100644
index 0000000..80de84a
--- /dev/null
+++ b/scripts/mag2gds.top.tcl
@@ -0,0 +1,24 @@
+# assumes an /ef tree or at least a symlink
+drc off
+gds readonly true
+gds rescale false
+set ::env(MAGTYPE) mag
+
+gds read ../gds/sram_1rw1r_32_256_8_sky130.gds
+
+load striVe2_soc -dereference
+load striVe_spi -dereference
+load striVe_clkrst -dereference
+load digital_pll -dereference
+load lvlshiftdown -dereference
+load striVe2 -dereference
+
+move origin -1209um -1452um
+box position 0 0
+getcell advSeal_6um_gen
+
+select top cell
+
+cif *hier write disable
+
+gds write striVe2.gds
diff --git a/scripts/wrap.tcl b/scripts/wrap.tcl
new file mode 100644
index 0000000..a8e5593
--- /dev/null
+++ b/scripts/wrap.tcl
@@ -0,0 +1,13 @@
+drc off
+gds readonly yes
+gds rescale no
+
+gds read ../macros/sram/riscv-sky130/sram_1rw1r_32_256_8_sky130.gds
+load sram_1rw1r_32_256_8_sky130
+
+select top cell
+property LEFview "TRUE"
+
+save pk_sram_1rw1r_32_256_8_sky130.mag
+
+# exec sed -i -E "/^.*GDS_END.*$/d" sram_1rw1r_32_256_8_sky130_original.mag
diff --git a/scripts/wrap2.tcl b/scripts/wrap2.tcl
new file mode 100644
index 0000000..5ed83f1
--- /dev/null
+++ b/scripts/wrap2.tcl
@@ -0,0 +1,21 @@
+drc off
+gds readonly yes
+gds rescale no
+
+lef read ../lef/sram.abs.con.lef
+load sram_1rw1r_32_256_8_sky130
+
+select top cell
+expand
+property LEFview ""
+property LEFsymmetry ""
+property LEFclass ""
+
+box position 5um 5um
+getcell pk_sram_1rw1r_32_256_8_sky130
+
+save sram_1rw1r_32_256_8_sky130.mag
+
+gds write output.gds
+
+save
diff --git a/test/README.md b/test/README.md
new file mode 100644
index 0000000..3440a7e
--- /dev/null
+++ b/test/README.md
@@ -0,0 +1 @@
+This folder contains all test-related files related to this project
diff --git a/verilog/README.md b/verilog/README.md
new file mode 100644
index 0000000..86dd11a
--- /dev/null
+++ b/verilog/README.md
@@ -0,0 +1 @@
+This folder contains all *.v files related to this project
