feat: add README template generator with Node.js workflow and configuration examples

.github/ISSUE_TEMPLATE/bug-report---.md

@@ -6,17 +6,22 @@ labels: bug
 ---
 
 ## Describe the bug
+
 A clear and concise description of what the bug is.
 
 ### Steps to reproduce
+
 Steps to reproduce the behavior.
 
 ### Expected behavior
+
 A clear and concise description of what you expected to happen.
 
 ### Environment
- - OS: [e.g. Arch Linux]
- - Other details that you think may affect.
+
+- OS: [e.g. Arch Linux]
+- Other details that you think may affect.
 
 ### Additional context
-Add any other context about the problem here.
+
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature-request---.md

@@ -6,10 +6,13 @@ labels: enhancement
 ---
 
 ## Summary
+
 Brief explanation of the feature.
 
 ### Basic example
+
 Include a basic example or links here.
 
 ### Motivation
-Why are we doing this? What use cases does it support? What is the expected outcome?
+
+Why are we doing this? What use cases does it support? What is the expected outcome?

.gitignore

@@ -0,0 +1,32 @@
+# Node.js
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+package-lock.json
+
+# Python virtual environment
+.venv/
+venv/
+
+# Generated files
+*.tmp
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Temporary files
+*.tmp
+*.temp

.markdownlint.json

@@ -0,0 +1,32 @@
+{
+  "MD013": {
+    "line_length": 80,
+    "code_blocks": false,
+    "tables": false,
+    "headings": false
+  },
+  "MD033": {
+    "allowed_elements": [
+      "a",
+      "div",
+      "img",
+      "h1",
+      "h2",
+      "h3",
+      "h4",
+      "h5",
+      "h6",
+      "p",
+      "br",
+      "strong",
+      "em",
+      "details",
+      "summary",
+      "ol",
+      "ul",
+      "li"
+    ]
+  },
+  "MD041": false,
+  "MD034": false
+}

.pre-commit-config.yaml

@@ -0,0 +1,39 @@
+fail_fast: false
+minimum_pre_commit_version: "2.6.0"
+repos:
+  # README Generator validation
+  - repo: https://github.com/actuarysailor/pre-commit-readme-generator
+    rev: v1.0.0
+    hooks:
+      - id: readme-generator-update
+        args: [configs/example.json, README.md, BLANK_README.md]
+
+  # Standard file checks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-merge-conflict
+      - id: check-yaml
+      - id: check-json
+      - id: check-added-large-files
+      - id: check-case-conflict
+      - id: mixed-line-ending
+        args: ['--fix=lf']
+
+  # Markdown linting
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.45.0
+    hooks:
+      - id: markdownlint
+        args: ['--fix']
+        exclude: '^CHANGELOG\.md$'
+
+  # JSON formatting
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v3.0.3
+    hooks:
+      - id: prettier
+        types: [json]
+        args: ['--write']