feat: initial scaffold script and CI

Author: Thavarshan

.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.sh]
+indent_style = space
+indent_size = 2

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - 'development'
+      - 'feature/*'
+      - 'bugfix/*'
+      - 'hotfix/*'
+      - 'releases/*'
+      - 'v*.*.*'
+  pull_request:
+    branches:
+      - main
+      - 'development'
+      - 'feature/*'
+      - 'bugfix/*'
+      - 'hotfix/*'
+      - 'releases/*'
+      - 'v*.*.*'
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Ensure script is syntactically valid
+        run: bash -n scripts/scaffold-php-package.sh
+      - name: Print usage
+        run: bash scripts/scaffold-php-package.sh || true

LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Thavarshan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

README.md

@@ -0,0 +1,55 @@
+# atomic-php/package-scaffold
+
+Quickly scaffold a PHP package that follows the Atomic style (as used by `atomic-php/http-kernel` and `atomic-php/router`).
+
+- Structure: `src/`, `tests/`, `benchmarks/`, `.github/workflows/ci.yml`
+- QA: `.editorconfig`, `.php-cs-fixer.php`, `psalm.xml`, `phpunit.xml.dist`
+- Docs: `README.md`, `LICENSE` (MIT), `CONTRIBUTING.md`, `SECURITY.md`, `CHANGELOG.md`
+- Composer scripts: `test`, `test-coverage`, `psalm`, `cs-check`, `cs-fix`, `benchmark`, `qa`
+- Optional PSR requirements: PSR-7, PSR-15, PSR-11
+
+## Requirements
+- bash
+- git + GitHub CLI (`gh auth login`)
+- PHP 8.4+, Composer (for the generated package)
+
+## Usage
+
+```bash
+# Basic
+scripts/scaffold-php-package.sh http-foundation "PSR-7 utilities and factories" --with-psr7
+
+# With PSR-15 and Container
+scripts/scaffold-php-package.sh events "Lightweight event dispatcher" --with-psr15 --with-container
+
+# Customize vendor, org, keywords
+scripts/scaffold-php-package.sh cache "Simple cache library" \
+  --vendor atomic --org atomic-php --keywords "php cache performance library"
+```
+
+Options:
+- `--org` (default: `atomic-php`): GitHub organization used in README badges
+- `--vendor` (default: `atomic`): Composer vendor name
+- `--name-slug`: override the Composer package name (defaults to directory name)
+- `--keywords`: space‑separated keywords for composer.json
+- `--with-psr7`: add `psr/http-message`
+- `--with-psr15`: add `psr/http-server-handler` and `psr/http-server-middleware`
+- `--with-container`: add `psr/container`
+
+## What it generates
+- Composer metadata aligned with Atomic repos
+- CI workflow mirroring the Atomic style (tests, coverage, psalm, cs, validate)
+- Standard code quality and docs files
+
+## After scaffolding
+```bash
+cd <dir>
+composer install
+git init && git add . && git commit -m "chore: initial scaffold"
+# Create GitHub repo and push
+gh repo create atomic-php/<dir> --public --source=. --remote=origin --push
+```
+
+## License
+MIT
+