Merge pull request #107 from braboj/chore/session-4-audit

chore: session 4 structural audit and CI improvements

Author: braboj

.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,23 @@
+---
+name: Bug
+about: Defect in existing functionality
+title: ""
+labels: bug
+assignees: ""
+---
+
+**Severity:** critical | major | minor | trivial
+
+## Expected
+[What should happen]
+
+## Actual
+[What happens instead]
+
+## Reproduce
+1. [Step 1]
+2. [Step 2]
+3. [Result]
+
+## Environment
+[dev/preview/production, browser, branch]

.github/ISSUE_TEMPLATE/epic.md

@@ -0,0 +1,20 @@
+---
+name: Epic
+about: Large initiative spanning multiple tasks or sessions
+title: ""
+labels: epic
+assignees: ""
+---
+
+## Goal
+[One sentence — what does success look like?]
+
+## Tasks
+- [ ] #XX — task description
+- [ ] #YY — task description
+
+## Out of scope
+[What this epic does NOT cover]
+
+## Definition of done
+[Measurable criteria for closing]

.github/ISSUE_TEMPLATE/git-tutorial-issue-template.md

@@ -0,0 +1,26 @@
+---
+name: Incident
+about: Production outage or degradation affecting users now
+title: ""
+labels: incident
+assignees: ""
+---
+
+**Severity:** critical | major
+**Status:** investigating | identified | mitigating | resolved
+
+## Impact
+[Who is affected, how severely]
+
+## Timeline
+- [HH:MM UTC] — [event]
+- [HH:MM UTC] — [event]
+
+## Root cause
+[What caused it — fill in after identified]
+
+## Resolution
+[What fixed it — fill in after resolved]
+
+## Prevention
+[What changes prevent recurrence — fill in after postmortem]

.github/ISSUE_TEMPLATE/incident.md

@@ -0,0 +1,19 @@
+---
+name: Spike
+about: Research or exploration — output is a decision or ADR
+title: ""
+labels: question
+assignees: ""
+---
+
+As a [role], I want to understand [topic] so that [decision can be made].
+
+## What
+[Question or area to explore]
+
+## Why
+[What decision is blocked without this research?]
+
+## Acceptance criteria
+- [ ] ADR documenting the decision
+- [ ] Recommendation with alternatives considered

.github/ISSUE_TEMPLATE/spike.md

@@ -0,0 +1,19 @@
+---
+name: Task
+about: Atomic implementable unit of work
+title: ""
+labels: enhancement
+assignees: ""
+---
+
+As a [user type], I want [capability] so that [benefit].
+
+## What
+[Clear description of the change]
+
+## Why
+[Motivation — which epic does this serve?]
+
+## Acceptance criteria
+- [ ] [Observable behavior 1]
+- [ ] [Observable behavior 2]

.github/ISSUE_TEMPLATE/task.md

@@ -0,0 +1,38 @@
+name: Build Astro site (PR validation)
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22.12.0"
+          cache: npm
+          cache-dependency-path: astro-site/package-lock.json
+
+      - name: Install dependencies
+        working-directory: astro-site
+        run: npm ci
+
+      - name: Create assets symlink
+        working-directory: astro-site/src/content
+        run: ln -s ../../../assets assets
+
+      - name: Build site
+        working-directory: astro-site
+        run: npm run build
+
+      - name: Check links
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: --base astro-site/dist astro-site/dist
+          fail: true

.github/workflows/build.yml

@@ -24,7 +24,9 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "22"
+          node-version: "22.12.0"
+          cache: npm
+          cache-dependency-path: astro-site/package-lock.json
 
       - name: Install dependencies
         working-directory: astro-site
@@ -38,6 +40,12 @@ jobs:
         working-directory: astro-site
         run: npm run build
 
+      - name: Check links
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: --base astro-site/dist astro-site/dist
+          fail: true
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:

.github/workflows/deploy.yml

@@ -48,4 +48,7 @@ Thumbs.db
 *.mov
 *.wmv
 
+# draw.io and image editor backup files
+*.bkp
+
 astro-site/src/content/assets

.gitignore

@@ -261,7 +261,7 @@ rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#D3D1C7;strokeWid
 
 ```bash
 # Astro site (from astro-site/)
-npm run dev       # develop — hot reload at localhost:4321
+npm run dev       # develop — hot reload at localhost:4321/tutorial-git/
 npm run build     # production build to dist/
 npm run preview   # preview production build locally
 ```