diff --git a/.gitignore b/.gitignore
index e69de29..e60a357 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1,90 @@
+############################################################
+#  Core language + tooling
+############################################################
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.egg-info/
+*.egg
+*.trace
+pip-wheel-metadata/
+
+# Virtual-envs
+.venv/
+venv/
+.env/
+# Poetry / pipenv virtual envs
+.poetry/
+.pipenv/
+
+# Ruff / pytest cache
+.cache/
+.pytest_cache/
+
+# Node (used by markdownlint-cli2, etc.)
+node_modules/
+npm-debug.log*
+pnpm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+############################################################
+#  Containers & Podman Compose
+############################################################
+# Podman/Docker build cache & artifacts
+*.tar
+*.oci
+# Local image layers (rootless)
+~/.local/share/containers/
+# Podman-compose temp files
+podman-compose.env
+
+############################################################
+#  Infrastructure-as-Code generated artifacts
+############################################################
+# Terraform
+.terraform/
+terraform.tfstate
+terraform.tfstate.*
+crash.log
+# TFLint / tfsec results
+.tflint.*
+tfsec.log
+
+# Helm
+charts/
+*.tgz
+# Helmfile diff/output
+helmfile*.yaml.orig
+
+############################################################
+#  Documentation & diagrams
+############################################################
+# Structurizr export cache
+docs/architecture/c4/*.png
+docs/architecture/c4/*.svg
+
+############################################################
+#  IDE / Editor cruft
+############################################################
+# VS Code
+.vscode/
+.history/
+# JetBrains
+.idea/
+*.iml
+
+############################################################
+#  OS-level temp files
+############################################################
+.DS_Store
+Thumbs.db
+ehthumbs.db
+desktop.ini
+$RECYCLE.BIN/
+
+############################################################
+#  Secrets — keep these paths tracked if you use SOPS/Vault!
+##############