DEV-006 recommended Team & Support
Team contacts and ownership documented
New developers should know who to ask for help with different areas. More important as team size grows.
Question to ask
"Auth is broken — who does the new hire Slack?"
Pass criteria
- ✓ Contact/ownership info exists
- ✓ Covers key areas
- ✓ Discoverable by new devs
Fail criteria
- ✗ No ownership documentation
- ✗ Only "ask in Slack" with no guidance
- ✗ CODEOWNERS not discoverable
Verification guide
Severity: Optional
New developers should know who to ask for help with different areas. This becomes more important as team size grows.
Check automatically:
# Look for team or contact documentation
find . -maxdepth 4 -type f \( -name "*team*" -o -name "*contact*" -o -name "*owner*" -o -name "*who*" \) -name "*.md" 2>/dev/null | grep -v node_modules
# Search for ownership content
grep -riE "contact|owner|ask|responsible|maintainer|point of contact|slack|team" docs/ README.md --include="*.md" 2>/dev/null | head -10
# Check for CODEOWNERS
ls -la .github/CODEOWNERS CODEOWNERS 2>/dev/null
# Look for on-call or escalation docs
grep -riE "on.call|escalat|support|help" docs/ --include="*.md" 2>/dev/null | head -5
Ask user:
- "Does a new dev know who to ask for help with different areas?"
- "Is there a CODEOWNERS file or equivalent?"
- "Are team/area owners documented somewhere?"
Pass criteria:
- Contact/ownership info exists (doc, CODEOWNERS, or team page)
- Covers key areas: frontend, backend, infra, key systems
- New dev knows where to get help without asking around
Fail criteria:
- No ownership documentation
- "Just ask in Slack" with no guidance on who/where
- CODEOWNERS exists but only for PR routing, not discoverable for questions
Note: Small teams where everyone knows everyone may not need formal ownership docs. This becomes more important at 5+ engineers.
Evidence to capture:
- Location of ownership info
- Format (CODEOWNERS, doc, wiki, Slack channel list)
- Areas covered
- Accessibility for new devs