🚀 Welcome to BeWith

Welcome to the team! This guide will get you from zero to productive.

Your first week — checklist

Week 1
├── Day 1 — Access & accounts
│   ├── [ ] GitHub org invite (@eng-lead to send)
│   ├── [ ] AWS console access (SSO via Auth0)
│   ├── [ ] Jira + Confluence access
│   ├── [ ] Slack — join #engineering #product #general #docs
│   └── [ ] 1:1 with your manager
│
├── Day 2-3 — Codebase orientation
│   ├── [ ] Read Architecture Overview
│   ├── [ ] Run the app locally (see Development Setup)
│   ├── [ ] Read the 3 most recent ADRs
│   └── [ ] Pair with a teammate on a small task
│
├── Day 4-5 — Product understanding
│   ├── [ ] Read the top 3 active Specs
│   ├── [ ] Watch the product demo recording (link in Slack #product)
│   └── [ ] Meet the PM and one customer-facing team member

Key links

Resource	Link
Architecture overview	/architecture
Active specs	/specs
ADRs	/adrs
Jira board	https://bewith.atlassian.net
GitHub org	https://github.com/bewith-dev
Figma	(link in Slack #design)

Documentation conventions

When you write docs here:

• Use the templates in /templates
• Every doc needs status, owner, and updated in the frontmatter
• PRDs in Draft must move to In Review within 5 business days
• Merge via PR — at least one reviewer from the relevant team

Who to ask

Topic	Person
Product / specs	@product-team
Backend architecture	@eng-lead
Frontend	@frontend-lead
DevOps / infra	@devops
Design	@design-lead

Getting unstuck

Stuck? Don't wait more than 30 minutes before asking. Post in the relevant Slack channel with a short summary of what you tried. We don't judge — we've all been new.