Codebase Orientation Walkthrough
workflow:codebase-orientation-walkthrough
Workflowworkflows/workflows/workflows-onboarding-deep.yaml·Open in Graph → {
"id": "workflow:codebase-orientation-walkthrough",
"_kind": "Workflow",
"_file": "workflows/workflows/workflows-onboarding-deep.yaml",
"_cluster": "workflows",
"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\nonboarded engineers — walking through the repository layout and module\nboundaries, explaining the build system and CI pipeline from first\nprinciples, demonstrating local development environment setup with smoke\ntests, reviewing key architectural decisions and their ADR documentation,\ntracing a representative request end-to-end through the system layers, and\npairing on a small starter task that touches each layer. Produces onboarding\nchecklists with completion timestamps, architecture map annotations, and\nnew-hire feedback for documentation improvement. Excludes role-specific\ntraining.\n"
},
"outgoingEdges": [
{
"from": "workflow:codebase-orientation-walkthrough",
"to": "role:tech-lead",
"kind": "involves_role",
"attributes": {}
},
{
"from": "workflow:codebase-orientation-walkthrough",
"to": "role:explorer",
"kind": "involves_role",
"attributes": {}
},
{
"from": "workflow:codebase-orientation-walkthrough",
"to": "role:fullstack-engineer",
"kind": "involves_role",
"attributes": {}
},
{
"from": "workflow:codebase-orientation-walkthrough",
"to": "skill-area:c4-modeling",
"kind": "requires_skill_area",
"attributes": {}
},
{
"from": "workflow:codebase-orientation-walkthrough",
"to": "skill-area:docs-as-code",
"kind": "requires_skill_area",
"attributes": {}
},
{
"from": "workflow:codebase-orientation-walkthrough",
"to": "domain:software-engineering",
"kind": "applies_to_domain",
"attributes": {}
},
{
"from": "workflow:codebase-orientation-walkthrough",
"to": "domain:knowledge-management",
"kind": "applies_to_domain",
"attributes": {}
},
{
"from": "workflow:codebase-orientation-walkthrough",
"to": "responsibility:onboard-new-engineer",
"kind": "triggers_responsibility",
"attributes": {}
},
{
"from": "workflow:codebase-orientation-walkthrough",
"to": "responsibility:adr-curation",
"kind": "triggers_responsibility",
"attributes": {}
},
{
"from": "workflow:codebase-orientation-walkthrough",
"to": "org-unit:engineering",
"kind": "performed_by_org_unit",
"attributes": {}
},
{
"from": "workflow:codebase-orientation-walkthrough",
"to": "org-unit:engineering-productivity",
"kind": "performed_by_org_unit",
"attributes": {}
}
],
"incomingEdges": []
}