From 907f36c8208001afa4f9528408344a982a1ba1a8 Mon Sep 17 00:00:00 2001
From: frankbria <frank.bria@gmail.com>
Date: Wed, 27 Aug 2025 09:27:33 -0700
Subject: [PATCH] Add directory structure with .gitkeep files

- Add .gitkeep files to ensure all essential directories are tracked by git
- Update .gitignore to allow .gitkeep files in logs/ and docs/generated/
- Preserve directory structure for Ralph project template system
- Directories added: src/, examples/, specs/stdlib/, templates/specs/,
  logs/, docs/generated/

This ensures the complete Ralph project structure is available when
cloning the repository, even before any actual project files are created.
---
 .gitignore               | 6 ++++--
 docs/generated/.gitkeep  | 3 +++
 examples/.gitkeep        | 2 ++
 logs/.gitkeep            | 3 +++
 specs/stdlib/.gitkeep    | 2 ++
 src/.gitkeep             | 2 ++
 templates/specs/.gitkeep | 2 ++
 7 files changed, 18 insertions(+), 2 deletions(-)
 create mode 100644 docs/generated/.gitkeep
 create mode 100644 examples/.gitkeep
 create mode 100644 logs/.gitkeep
 create mode 100644 specs/stdlib/.gitkeep
 create mode 100644 src/.gitkeep
 create mode 100644 templates/specs/.gitkeep

diff --git a/.gitignore b/.gitignore
index 7d2d0ed..faf2e5c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,11 +5,13 @@
 status.json
 
 # Logs
-logs/
+logs/*
+!logs/.gitkeep
 *.log
 
 # Generated documentation
-docs/generated/
+docs/generated/*
+!docs/generated/.gitkeep
 
 # OS files
 .DS_Store
diff --git a/docs/generated/.gitkeep b/docs/generated/.gitkeep
new file mode 100644
index 0000000..0406914
--- /dev/null
+++ b/docs/generated/.gitkeep
@@ -0,0 +1,3 @@
+# This file ensures the docs/generated/ directory is tracked by git
+# Note: Generated documentation files are ignored by .gitignore
+# This directory is needed for Ralph loop execution
\ No newline at end of file
diff --git a/examples/.gitkeep b/examples/.gitkeep
new file mode 100644
index 0000000..ddb08c6
--- /dev/null
+++ b/examples/.gitkeep
@@ -0,0 +1,2 @@
+# This file ensures the examples/ directory is tracked by git
+# Remove this file when you add actual example files
\ No newline at end of file
diff --git a/logs/.gitkeep b/logs/.gitkeep
new file mode 100644
index 0000000..544fad2
--- /dev/null
+++ b/logs/.gitkeep
@@ -0,0 +1,3 @@
+# This file ensures the logs/ directory is tracked by git
+# Note: Actual log files are ignored by .gitignore
+# This directory is needed for Ralph loop execution
\ No newline at end of file
diff --git a/specs/stdlib/.gitkeep b/specs/stdlib/.gitkeep
new file mode 100644
index 0000000..5f3b7da
--- /dev/null
+++ b/specs/stdlib/.gitkeep
@@ -0,0 +1,2 @@
+# This file ensures the specs/stdlib/ directory is tracked by git
+# Remove this file when you add actual specification files
\ No newline at end of file
diff --git a/src/.gitkeep b/src/.gitkeep
new file mode 100644
index 0000000..cc237b5
--- /dev/null
+++ b/src/.gitkeep
@@ -0,0 +1,2 @@
+# This file ensures the src/ directory is tracked by git
+# Remove this file when you add actual source files
\ No newline at end of file
diff --git a/templates/specs/.gitkeep b/templates/specs/.gitkeep
new file mode 100644
index 0000000..3e44682
--- /dev/null
+++ b/templates/specs/.gitkeep
@@ -0,0 +1,2 @@
+# This file ensures the templates/specs/ directory is tracked by git
+# Remove this file when you add actual template specification files
\ No newline at end of file