Scaffold reusable DevEx workflows, release pipeline, and onboarding docs

.github/workflows/ci.yml

@@ -0,0 +1,19 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  quality:
+    uses: ./.github/workflows/reusable-quality.yml
+    with:
+      setup-node: false
+      run-format-check: false
+      run-lint: false
+      run-test: false

.github/workflows/release.yml

@@ -0,0 +1,22 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Release Please
+        uses: googleapis/release-please-action@v4
+        with:
+          release-type: simple
+          changelog-types: '[{"type":"feat","section":"Features","hidden":false},{"type":"fix","section":"Bug Fixes","hidden":false},{"type":"chore","section":"Maintenance","hidden":false}]'

.github/workflows/reusable-quality.yml

@@ -0,0 +1,84 @@
+name: Reusable Quality Checks
+
+on:
+  workflow_call:
+    inputs:
+      checkout-fetch-depth:
+        description: Git checkout fetch depth.
+        required: false
+        default: 0
+        type: number
+      setup-node:
+        description: Enable Node.js setup.
+        required: false
+        default: true
+        type: boolean
+      node-version:
+        description: Node.js version for JS/TS projects.
+        required: false
+        default: '20'
+        type: string
+      run-format-check:
+        description: Run formatting validation command.
+        required: false
+        default: true
+        type: boolean
+      format-command:
+        description: Command used for format validation.
+        required: false
+        default: npm run format:check --if-present
+        type: string
+      run-lint:
+        description: Run lint command.
+        required: false
+        default: true
+        type: boolean
+      lint-command:
+        description: Command used for lint validation.
+        required: false
+        default: npm run lint --if-present
+        type: string
+      run-test:
+        description: Run automated tests.
+        required: false
+        default: true
+        type: boolean
+      test-command:
+        description: Command used to run test suite.
+        required: false
+        default: npm test --if-present
+        type: string
+
+jobs:
+  quality:
+    name: Quality
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: ${{ inputs.checkout-fetch-depth }}
+
+      - name: Set up Node.js
+        if: ${{ inputs.setup-node }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ inputs.node-version }}
+          cache: npm
+
+      - name: Install dependencies
+        if: ${{ inputs.setup-node }}
+        run: npm ci
+
+      - name: Format check
+        if: ${{ inputs.run-format-check }}
+        run: ${{ inputs.format-command }}
+
+      - name: Lint
+        if: ${{ inputs.run-lint }}
+        run: ${{ inputs.lint-command }}
+
+      - name: Test
+        if: ${{ inputs.run-test }}
+        run: ${{ inputs.test-command }}

CONTRIBUTING.md

@@ -12,7 +12,7 @@ Thanks for your interest in contributing.
 
 1. Fork and create a branch: `feature/short-description`
 2. Make your changes with clear commit messages.
-3. Run tests/lint locally (if configured).
+3. Run local validation (`format:check`, `lint`, `test`) before opening your PR.
 4. Open a pull request using the PR template.
 
 ## Pull request checklist
@@ -22,3 +22,8 @@ Thanks for your interest in contributing.
 - [ ] Docs are updated (if behavior changed)
 - [ ] Changelog updated (if needed)
 
+## Local automation defaults
+
+- Bootstrap: `./scripts/bootstrap.sh`
+- Setup guide: `docs/developer-setup.md`
+- CI workflows: `.github/workflows/`

docs/developer-setup.md

@@ -0,0 +1,69 @@
+# Developer Setup
+
+This guide provides generic onboarding defaults intended for template-based repositories.
+
+## 1) Prerequisites
+
+- Git 2.40+
+- A language runtime/toolchain for your project (Node, Python, Go, etc.)
+- A package manager (`npm`, `pnpm`, `pip`, `poetry`, `go`, etc.)
+
+## 2) Bootstrap locally
+
+```bash
+git clone <your-repo-url>
+cd <your-repo>
+./scripts/bootstrap.sh
+```
+
+If your repository is not Node.js based, adapt `scripts/bootstrap.sh` to your stack and keep command names consistent with CI.
+
+## 3) Recommended task contract
+
+To keep automation portable, define task commands with predictable names:
+
+- `format:check` — formatting validation
+- `lint` — static analysis/linting
+- `test` — automated tests
+
+This template's reusable workflow can call any shell command, but these names improve discoverability.
+
+## 4) CI customization
+
+The repository ships with:
+
+- `.github/workflows/reusable-quality.yml` (reusable workflow)
+- `.github/workflows/ci.yml` (default entry workflow)
+- `.github/workflows/release.yml` (semantic release PR/tag automation)
+
+In `ci.yml`, enable checks by setting:
+
+- `setup-node: true` for JS/TS projects
+- `run-format-check: true`
+- `run-lint: true`
+- `run-test: true`
+
+Then optionally override commands:
+
+```yaml
+with:
+  setup-node: true
+  format-command: npm run format:check
+  lint-command: npm run lint
+  test-command: npm test
+```
+
+## 5) Branch and PR workflow
+
+1. Create a branch from `main`.
+2. Run local validation commands before opening a PR.
+3. Open a focused PR and include context for reviewers.
+4. Merge only when CI checks pass.
+
+## 6) Lightweight automation standards
+
+- Keep workflows minimal and composable.
+- Prefer reusable workflows (`workflow_call`) over duplicated YAML.
+- Avoid stack-specific assumptions in template defaults.
+- Keep commands configurable through workflow inputs.
+- Fail fast in CI and keep logs clear.

scripts/bootstrap.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ ! -f package.json ]]; then
+  echo "No package.json found. This bootstrap script is currently oriented to Node.js projects."
+  echo "Copy and adapt scripts/bootstrap.sh for your stack (Python, Go, Rust, etc.)."
+  exit 0
+fi
+
+if command -v npm >/dev/null 2>&1; then
+  npm ci
+  echo "Dependencies installed."
+else
+  echo "npm is not installed. Please install Node.js 20+ and retry."
+  exit 1
+fi