appritechnologies · Yasirunet · Jul 2, 2026 · Apr 25, 2026 · Apr 25, 2026 · Apr 29, 2026
diff --git a/.claude/skills/create-pr/SKILL.md b/.claude/skills/create-pr/SKILL.md
@@ -1,48 +1,76 @@
 ---
 name: create-pr
-description: Generate a PR description and save to temp/pr-description.md.
+description: Generate a PR description for the current branch and save it to temp/pr-description.md. Analyzes commits against the base branch and fills in the project PR template exactly.
+argument-hint: "[base-branch]"
+allowed-tools: Bash, Read, Write
 ---
 
 # Create PR Skill
 
-Generate a standardized PR description for the PostKit project and save it to `temp/pr-description.md`.
+Generate a standardized PR description following the project template and save it to `temp/pr-description.md`. Does NOT push or create the PR on GitHub — description only.
 
-## Project Context
+## Arguments
 
-Read `CLAUDE.md` at the project root for project conventions.
-Use the PR template at `.github/pull_request_template.md`.
+Optional: base branch to compare against (e.g. `/create-pr development` or `/create-pr main`).
+Default to `main` if no argument is provided.
 
 ## Workflow
 
-### Step 1: Analyze Changes
-Gather branch information:
+### Step 1: Read the PR Template
+
+**Always read the template file first** before writing anything:
+
+```bash
+cat .github/pull_request_template.md
+```
+
+The output must use the **exact section headings and checkbox format** from that file. Do not add, remove, or reorder sections.
+
+### Step 2: Analyze Changes
+
+Get the current branch and compare against the remote base:
+
 ```bash
-git log origin/main...HEAD --oneline
-git diff origin/main...HEAD --stat
-git diff origin/main...HEAD
+git rev-parse --abbrev-ref HEAD
+git fetch origin <base>
+git log origin/<base>...HEAD --oneline
+git diff origin/<base>...HEAD --stat
 ```
-Categorize changes into: features, fixes, refactors, tests, docs, chore.
-
-### Step 2: Generate PR Description
-Using the PR template structure, generate:
-
-**Title** — under 70 characters with conventional commit prefix:
-- `feat: <description>` for new features
-- `fix: <description>` for bug fixes
-- `refactor: <description>` for code refactoring
-- `test: <description>` for test changes
-- `docs: <description>` for documentation changes
-- `chore: <description>` for build/tooling changes
-
-**Body** — using the template sections:
-- Summary (1-3 bullet points)
-- Changes (specific list)
-- Type of Change (check one)
-- Test Plan (checklist)
-
-### Step 3: Save to File
-Create `temp/` directory if needed and save to `temp/pr-description.md`.
-Use the exact format from `.github/pull_request_template.md` — read that file and follow its structure.
-
-### Step 4: Show to User
-Display the generated PR description and ask for confirmation or edits before saving.
+
+Always use `origin/<base>` so the comparison is against the remote state.
+
+### Step 3: Generate PR Title and Body
+
+**Title** — under 70 characters, conventional commit prefix:
+- `feat:` new feature
+- `fix:` bug fix
+- `refactor:` no functional change
+- `test:` test changes
+- `docs:` documentation only
+- `chore:` build/tooling/CI
+
+**Body** — fill in each template section in exact order:
+- `## Summary` — 1–3 bullet points of what the PR does
+- `## Changes` — bullet list of specific files/components changed
+- `## Type of Change` — mark exactly one checkbox `[x]`
+- `## Test Plan` — check completed items; fill in the "Manually tested:" line
+- `## Breaking Changes` — `[x] No breaking changes` if none; otherwise list them
+
+### Step 4: Save to `temp/pr-description.md`
+
+```bash
+mkdir -p temp
+```
+
+Write the file with this exact structure:
+```
+# <title>
+
+**Branch:** `<current-branch>` → `<base-branch>`
+
+<body following template sections exactly>
+```
+
+### Step 5: Show the Result
+
+Display the full content of `temp/pr-description.md` to the user and confirm it is saved.
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
@@ -1,3 +1,5 @@
+**Branch:** `<from-branch>` → `<to-branch>`
+
 ## Summary
 <!-- 1-3 bullet points describing what this PR does -->
 

diff --git a/.github/workflows/pr-checks.yml b/.github/workflows/pr-checks.yml
@@ -0,0 +1,114 @@
+name: PR Checks
+
+on:
+  pull_request:
+    branches:
+      - main
+      - development
+
+concurrency:
+  group: pr-checks-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  # ── CLI: Build + Type check ─────────────────────────────────────────────────
+  cli-build:
+    name: CLI Build
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: cli
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: cli/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Type check
+        run: npx tsc --noEmit
+
+      - name: Upload build artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: cli-dist
+          path: cli/dist
+          retention-days: 1
+
+  # ── CLI: Unit tests ─────────────────────────────────────────────────────────
+  cli-unit-tests:
+    name: CLI Unit Tests
+    runs-on: ubuntu-latest
+    needs: cli-build
+    defaults:
+      run:
+        working-directory: cli
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: cli/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run unit tests
+        run: npm run test
+
+  # ── CLI: E2E tests (requires Docker) ───────────────────────────────────────
+  cli-e2e-tests:
+    name: CLI E2E Tests
+    runs-on: ubuntu-latest
+    needs: cli-build
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: cli/package-lock.json
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Start Docker daemon and verify
+        run: |
+          sudo systemctl start docker || true
+          docker version
+          docker info
+
+      - name: Pull PostgreSQL image (cache warm-up)
+        run: docker pull postgres:16-alpine
+
+      - name: Install dependencies
+        working-directory: cli
+        run: npm ci
+
+      - name: Download build artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: cli-dist
+          path: cli/dist
+
+      - name: Run E2E tests
+        working-directory: cli
+        run: npm run test:e2e
+        env:
+          TESTCONTAINERS_RYUK_DISABLED: true
+          DOCKER_HOST: unix:///var/run/docker.sock
+
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -10,9 +10,14 @@ permissions:
   id-token: write
 
 jobs:
-  test:
-    name: Test
+  # ── Unit tests ──────────────────────────────────────────────────────────────
+  unit-tests:
+    name: Unit Tests
     runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: cli
+
     steps:
       - uses: actions/checkout@v4
 
@@ -22,19 +27,62 @@ jobs:
           cache: npm
           cache-dependency-path: cli/package-lock.json
 
-      - run: npm ci
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run unit tests
+        run: npm run test
+
+  # ── E2E tests (requires Docker) ─────────────────────────────────────────────
+  e2e-tests:
+    name: E2E Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: cli/package-lock.json
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Start Docker daemon and verify
+        run: |
+          sudo systemctl start docker || true
+          docker version
+          docker info
+
+      - name: Pull PostgreSQL image (cache warm-up)
+        run: docker pull postgres:16-alpine
+
+      - name: Install dependencies
+        working-directory: cli
+        run: npm ci
+
+      - name: Build
         working-directory: cli
+        run: npm run build
 
-      - run: npm run test:all
+      - name: Run E2E tests
         working-directory: cli
+        run: npm run test:e2e
+        env:
+          TESTCONTAINERS_RYUK_DISABLED: true
+          DOCKER_HOST: unix:///var/run/docker.sock
 
+  # ── Release & Publish (only after all tests pass) ───────────────────────────
   release:
     name: Release & Publish
-    needs: test
+    needs: [unit-tests, e2e-tests]
     runs-on: ubuntu-latest
     defaults:
       run:
         working-directory: cli
+
     steps:
       - uses: actions/checkout@v4
 
@@ -45,9 +93,11 @@ jobs:
           cache-dependency-path: cli/package-lock.json
           registry-url: https://registry.npmjs.org
 
-      - run: npm ci
+      - name: Install dependencies
+        run: npm ci
 
-      - run: npm run build
+      - name: Build
+        run: npm run build
 
       - name: Extract version from tag
         id: version
@@ -94,6 +144,7 @@ jobs:
               prerelease: false
             });
 
-      - run: npm publish --provenance --access public
+      - name: Publish to npm
+        run: npm publish --provenance --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}