From 2e81489f664f17a2944375d52c29c7a9f0415114 Mon Sep 17 00:00:00 2001
From: hassana123 <hassanaabdll1@gmail.com>
Date: Thu, 26 Mar 2026 16:23:00 +0100
Subject: [PATCH] feat: add ci workflow baseline

---
 .github/workflows/ci.yml | 29 +++++++++++++++++++++++++++++
 README.md                |  3 +++
 docs/ci.md               | 15 +++++++++++++++
 3 files changed, 47 insertions(+)
 create mode 100644 .github/workflows/ci.yml
 create mode 100644 docs/ci.md

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..639dd32
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  workspace-check:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Verify repository structure
+        run: |
+          test -f README.md
+          test -d tooling
+          test -d docs
+
+      - name: Report baseline status
+        run: echo "CI baseline passed for repository scaffolding."
diff --git a/README.md b/README.md
index c032058..533e35d 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,6 @@
 # Timely Capsule App 🕰️
 
+## Automation templates
+
+The repository includes a merge-safe CI workflow baseline in `.github/workflows/ci.yml`.
 
diff --git a/docs/ci.md b/docs/ci.md
new file mode 100644
index 0000000..391e6fb
--- /dev/null
+++ b/docs/ci.md
@@ -0,0 +1,15 @@
+# Continuous Integration
+
+The repository includes a baseline GitHub Actions workflow for pull requests and pushes to `main`.
+
+## Current scope
+
+- checks out the repository
+- configures Node.js
+- verifies baseline repository structure
+
+## Current location
+
+`.github/workflows/ci.yml`
+
+This workflow is intentionally lightweight so it can merge safely before full package-level scripts exist.