chore: add GitHub templates and CI workflow (#7)

- Add issue templates (feature, bug, infra, docs)
- Add PR template
- Add CI workflow (lint, build, test)

🤖 Generated with Claude Code (https://claude.com/claude-code)

Co-authored-by: Alexa Louise <YOUR_REAL_EMAIL@EXAMPLE.COM>
Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
Alexa Amundson
2025-11-28 21:05:11 -06:00
committed by GitHub
parent 2f2f6d538d
commit 84bbcefdd2
7 changed files with 194 additions and 0 deletions

33
.github/ISSUE_TEMPLATE/bug_report.md vendored Normal file
View File

@@ -0,0 +1,33 @@
---
name: Bug Report
about: Report something that isn't working correctly
title: "[Bug] "
labels: type:bug, status:backlog
assignees: ''
---
## Summary
<!-- One-sentence description of the bug -->
## Steps to Reproduce
1. Go to '...'
2. Click on '...'
3. See error
## Expected Behavior
<!-- What should happen? -->
## Actual Behavior
<!-- What actually happens? -->
## Environment
- 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 -->

5
.github/ISSUE_TEMPLATE/config.yml vendored Normal file
View File

@@ -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

22
.github/ISSUE_TEMPLATE/doc_update.md vendored Normal file
View File

@@ -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 -->

View File

@@ -0,0 +1,26 @@
---
name: Feature Request
about: Propose a new feature or capability
title: "[Feature] "
labels: type:feature, status:backlog
assignees: ''
---
## Summary
<!-- One-sentence description of the feature -->
## Problem / Motivation
<!-- What problem does this solve? Why do we need it? -->
## Proposed Solution
<!-- How should this work? Be specific. -->
## Alternatives Considered
<!-- What other approaches did you consider? Why not those? -->
## Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2
## Additional Context
<!-- Screenshots, links, related issues -->

29
.github/ISSUE_TEMPLATE/infra_task.md vendored Normal file
View File

@@ -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? -->

39
.github/PULL_REQUEST_TEMPLATE.md vendored Normal file
View File

@@ -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 -->

40
.github/workflows/ci.yml vendored Normal file
View File

@@ -0,0 +1,40 @@
name: CI
on:
push:
branches: [main]
pull_request:
branches: [main]
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup Node
uses: actions/setup-node@v4
with:
node-version: '20'
cache: 'npm'
- name: Install dependencies
run: npm ci
- name: Lint
run: npm run lint --if-present
- name: Type check
run: npm run type-check --if-present
- name: Build
run: npm run build --if-present
- name: Test
run: npm test --if-present