chore: add org baseline (templates, CI, labels) (#11)

Org-wide bootstrap. Adds issue/PR templates, CI workflow, and labels. 🤖
Generated with Claude Code

Co-authored-by: Alexa Louise <YOUR_REAL_EMAIL@EXAMPLE.COM>
Co-authored-by: Claude <noreply@anthropic.com>

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,26 +1,33 @@
 ---
-name: Bug report
+name: Bug Report
-about: Create a report to help us improve
+about: Report something that isn't working correctly
-title: ''
+title: "[Bug] "
-labels: ''
+labels: type:bug, status:backlog
 assignees: ''
-
 ---
 
-**Title**
+## Summary
-Provide a concise title for your bug.
+<!-- One-sentence description of the bug -->
 
-**Description**
+## Steps to Reproduce
-Describe the bug in detail.
+1. Go to '...'
+2. Click on '...'
+3. See error
 
-**Reproduction Steps**
+## Expected Behavior
-Steps to reproduce the behavior:
+<!-- What should happen? -->
-1. ...
-2. ...
-3. ...
 
-**Expected Behaviour**
+## Actual Behavior
-Describe what you expected to happen.
+<!-- What actually happens? -->
 
-**Additional Context**
+## Environment
-Add any other context or screenshots that might help.
+- Service/Repo:
+- Environment: (local / staging / prod)
+- Browser/Client: (if applicable)
+- OS:
+
+## Logs / Screenshots
+<!-- Paste relevant logs or attach screenshots -->
+
+## Possible Fix
+<!-- If you have ideas on how to fix this -->

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: BlackRoad OS Docs
+    url: https://github.com/BlackRoad-OS/blackroad-os-docs
+    about: Check the docs before opening an issue

.github/ISSUE_TEMPLATE/doc_update.md

@@ -0,0 +1,22 @@
+---
+name: Documentation Update
+about: Improve or add documentation
+title: "[Docs] "
+labels: type:doc, team:docs, status:backlog
+assignees: ''
+---
+
+## Summary
+<!-- What documentation needs to be added/updated? -->
+
+## Location
+<!-- Which file(s) or section(s)? -->
+
+## Current State
+<!-- What's missing or incorrect? -->
+
+## Proposed Content
+<!-- Outline or draft of the new content -->
+
+## Related
+<!-- Links to related issues, PRs, or external docs -->

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,26 +1,26 @@
 ---
-name: Feature request
+name: Feature Request
-about: Suggest an idea for this project
+about: Propose a new feature or capability
-title: ''
+title: "[Feature] "
-labels: ''
+labels: type:feature, status:backlog
 assignees: ''
-
 ---
 
-**Title**
+## Summary
-Provide a concise title for your feature request.
+<!-- One-sentence description of the feature -->
 
-**Description**
+## Problem / Motivation
-Describe the feature you are proposing.
+<!-- What problem does this solve? Why do we need it? -->
 
-**Reproduction Steps**
+## Proposed Solution
-Steps to demonstrate how the feature would be used or how the current issue arises:
+<!-- How should this work? Be specific. -->
-1. ...
-2. ...
-3. ...
 
-**Expected Behaviour**
+## Alternatives Considered
-Describe what you expect to happen once the feature is implemented.
+<!-- What other approaches did you consider? Why not those? -->
 
-**Additional Context**
+## Acceptance Criteria
-Add any other context or screenshots that might help.
+- [ ] Criterion 1
+- [ ] Criterion 2
+
+## Additional Context
+<!-- Screenshots, links, related issues -->

.github/ISSUE_TEMPLATE/infra_task.md

@@ -0,0 +1,29 @@
+---
+name: Infrastructure Task
+about: CI/CD, deployment, DevOps work
+title: "[Infra] "
+labels: type:infra, team:infra, status:backlog
+assignees: ''
+---
+
+## Summary
+<!-- One-sentence description of the infra task -->
+
+## Scope
+- [ ] CI/CD pipeline
+- [ ] Deployment config
+- [ ] Monitoring/Observability
+- [ ] Security
+- [ ] Other:
+
+## Current State
+<!-- What exists now? -->
+
+## Desired State
+<!-- What should exist after this work? -->
+
+## Affected Services
+<!-- Which repos/services does this touch? -->
+
+## Rollback Plan
+<!-- How do we undo this if something goes wrong? -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,39 @@
+## Summary
+<!-- What does this PR do? One paragraph max. -->
+
+## Changes
+<!-- Bulleted list of specific changes -->
+-
+
+## Type
+<!-- Check one -->
+- [ ] Feature
+- [ ] Bug fix
+- [ ] Infrastructure / CI
+- [ ] Documentation
+- [ ] Refactor
+- [ ] Config change
+
+## Tests
+<!-- How was this tested? -->
+- [ ] Unit tests pass
+- [ ] Integration tests pass
+- [ ] Manual testing (describe below)
+- [ ] N/A (docs only)
+
+**Manual testing steps:**
+
+
+## Risk / Impact
+<!-- What could go wrong? What's the blast radius? -->
+- Risk level: Low / Medium / High
+- Affected services:
+
+## Checklist
+- [ ] Code follows project conventions
+- [ ] No secrets or credentials committed
+- [ ] README updated (if applicable)
+- [ ] This is a single logical change (atomic PR)
+
+## Related Issues
+<!-- Closes #123, Relates to #456 -->

.github/workflows/ci.yml

@@ -2,26 +2,39 @@ name: CI
 
 on:
   push:
-    branches: [work]
+    branches: [main]
   pull_request:
-    branches: [work]
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
 
 jobs:
-  lint-test-build:
+  build:
     runs-on: ubuntu-latest
+
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout
-      - uses: actions/setup-node@v4
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: '20'
-          cache: 'pnpm'
+          cache: 'npm'
-      - name: Enable corepack
+
-        run: corepack enable
       - name: Install dependencies
-        run: pnpm install --no-frozen-lockfile
+        run: npm ci
+
       - name: Lint
-        run: pnpm lint
+        run: npm run lint --if-present
-      - name: Test
+
-        run: pnpm test
+      - name: Type check
+        run: npm run type-check --if-present
+
       - name: Build
-        run: pnpm build
+        run: npm run build --if-present
+
+      - name: Test
+        run: npm test --if-present