II.
Workflow overview
Reference · liveworkflow:codebase-orientation-walkthrough
Codebase Orientation Walkthrough overview
Delivers a structured deep-dive into the codebase architecture for newly onboarded engineers — walking through the repository layout and module boundaries, explaining the build system and CI pipeline from first principles, demonstrating local development environment setup with smoke tests, reviewing key architectural decisions and their ADR documentation, tracing a representative request end-to-end through the system layers, and pairing on a small starter task that touches each layer. Produces onboarding checklists with completion timestamps, architecture map annotations, and new-hire feedback for documentation improvement. Excludes role-specific training.
Attributes
displayName
Codebase Orientation Walkthrough
workflowKind
operational
triggerType
event-driven
typicalCadence
per-event
complexity
single-team
description
Delivers a structured deep-dive into the codebase architecture for newly
onboarded engineers — walking through the repository layout and module
boundaries, explaining the build system and CI pipeline from first
principles, demonstrating local development environment setup with smoke
tests, reviewing key architectural decisions and their ADR documentation,
tracing a representative request end-to-end through the system layers, and
pairing on a small starter task that touches each layer. Produces onboarding
checklists with completion timestamps, architecture map annotations, and
new-hire feedback for documentation improvement. Excludes role-specific
training.
Outgoing edges
applies_to_domain2
- domain:software-engineering·DomainSoftware Engineering
- domain:knowledge-management·DomainKnowledge Management
involves_role3
- role:tech-lead·RoleTech Lead
- role:explorer·RoleExplorer
- role:fullstack-engineer·RoleFullstack Engineer
performed_by_org_unit2
- org-unit:engineering·OrgUnitEngineering
- org-unit:engineering-productivity·OrgUnitEngineering Productivity
requires_skill_area2
- skill-area:c4-modeling·SkillAreaC4 Modeling
- skill-area:docs-as-code·SkillAreaDocs-as-Code
triggers_responsibility2
- responsibility:onboard-new-engineer·ResponsibilityOnboard new engineer
- responsibility:adr-curation·ResponsibilityADR curation
Incoming edges
None.