Team Onboarding Journey Diagrams
Complete Onboarding Timeline
timeline
title Two-Week Onboarding Journey
Day 1 : Environment Setup
pipx install capcat
cd ~/my-vault
First successful capcat catch
Join team channels
Day 2-3 : Codebase Exploration
Read architecture docs
Trace code execution
Explore vault structure
Ask lots of questions
Day 4-5 : First Contribution
Fix documentation detail
Add config-driven source
Create first PR
Participate in code review
Week 2 : Deep Dives
Architecture session
UX + vault model session
Testing workshop
Code review practice
Week 2 : Integration
Independent task
Pair programming
Team collaboration
Celebrate milestones
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Day 1: Setup Journey
flowchart TD
Start([New Team MemberStarts]) --> A[Prerequisites Check]
A --> B1{Python 3.10+ Installed?}
B1 -->|No| C1[Install Python]
C1 --> B1
B1 -->|Yes| B2{pipx installed?}
B2 -->|No| C2[pip install pipx]
C2 --> B2
B2 -->|Yes| D[pipx install capcat]
D --> E{Install Successful?}
E -->|No| G[Troubleshoot]
G --> G1[Check error messages]
G1 --> G2[Consult docs]
G2 --> G3{Resolved?}
G3 -->|No| G4[Ask Team for Help]
G4 --> D
G3 -->|Yes| E
E -->|Yes| F[Choose or create vault directory]
F --> H[cd ~/my-vault]
H --> K[capcat catch]
K --> L{First fetch works?}
L -->|No| G
L -->|Yes| M[Explore vault output]
M --> N[Read Config/Global-settings.yaml]
N --> O[Day 1 Complete [OK]]
O --> P[Read architecture docs]
P --> Q[Join Team Standup]
Q --> R[Ready for Day 2]
style Start fill:#d75f00,stroke:#333,stroke-width:2px,color:#fff
style O fill:#4ecdc4,stroke:#333,stroke-width:2px
style R fill:#4ecdc4,stroke:#333,stroke-width:2px
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Learning Path by Role
graph TB
subgraph Junior Developer Path
JD1[Day 1: pipx install + vault init]
JD2[Day 2-3: Code Exploration]
JD3[Day 4-5: Simple Contribution]
JD4[Week 2: Architecture + Vault Deep Dive]
JD5[Week 3-4: Independent Tasks]
end
subgraph Product Designer Path
PD1[Day 1: Install + first catch]
PD2[Day 2-3: Vault structure + UX context]
PD3[Day 4-5: Config hierarchy + heuristics]
PD4[Week 2: Technical Constraints]
PD5[Week 3-4: Design Collaboration]
end
subgraph Senior Developer Path
SD1[Day 1: Quick setup — pipx + vault]
SD2[Day 2: Architecture + ownership model]
SD3[Day 3: Code Review Practice]
SD4[Week 2: Lead Feature]
SD5[Week 3-4: Mentor Others]
end
JD1 --> JD2 --> JD3 --> JD4 --> JD5
PD1 --> PD2 --> PD3 --> PD4 --> PD5
SD1 --> SD2 --> SD3 --> SD4 --> SD5
JD5 --> Productive[ProductiveTeam Member]
PD5 --> Productive
SD5 --> Productive
style Productive fill:#d75f00,stroke:#333,stroke-width:4px,color:#fff
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
First Week Exercises
mindmap
root((Week 1Exercises))
Exercise 1: Install + First Run
pipx install capcat
cd into vault directory
capcat catch
Explore scaffolded Config/
Exercise 2: First Fetch
capcat catch — interactive TUI
capcat fetch hn --count 5
Check News/ output folder
Open article in Obsidian
Exercise 3: Config Tuning
Edit capcat.yml counts
Edit per-source config.yaml
Try --count flag override
Observe 4-level hierarchy
Exercise 4: Trace Code
Add debug prints
Follow execution
Identify vault resolution path
Map PDF manager flow
Exercise 5: First PR
Fix doc detail
Add config source
Update docs
Pass code review
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Architecture Learning Flow
sequenceDiagram
participant N as New Developer
participant D as Documentation
participant C as Codebase
participant M as Mentor
Note over N: Week 1 Learning
N->>D: Read architecture.md
D-->>N: High-level overview — 5 layers, vault model
N->>D: Read 01-architecture-logic.md
D-->>N: Vault separation, config hierarchy, ownership model
N->>C: Explore capcat.py and cli.py
C-->>N: Main application logic + vault resolution
N->>N: Run capcat catch in a test vault
Note over N: Self-test: observe scaffolded Config/ structure on first run
N->>M: Architecture questions
M-->>N: Clarifications on vault vs tool boundary
N->>C: Trace article fetch + PDF manager flow
C-->>N: Hands-on understanding of async drain
N->>M: Present understanding
M-->>N: Validation & corrections
N->>N: Architecture mastery [OK]
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Code Review Learning Progression
graph LR
A[Week 1Observe Reviews] --> B[Week 2Ask Questions]
B --> C[Week 3Review Simple PRs]
C --> D[Week 4Review Complex PRs]
D --> E[Month 2Lead Reviews]
A --> A1[Read PR comments]
A --> A2[Understand patterns]
A --> A3[Note common issues]
B --> B1[Why this approach?]
B --> B2[What's the pattern?]
B --> B3[How to test this?]
C --> C1[Doc fixes]
C --> C2[Config sources]
C --> C3[Simple bugs]
D --> D1[New features]
D --> D2[Refactoring]
D --> D3[Architecture changes]
E --> E1[Mentor others]
E --> E2[Design reviews]
E --> E3[Security reviews]
style E fill:#d75f00,stroke:#333,stroke-width:2px,color:#fff
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
First Contribution Types
graph TD
subgraph Beginner Tasks
B1[Fix Documentation TypoDifficulty: 1/5Time: 15 min]
B2[Add Config SourceDifficulty: 2/5Time: 30 min]
B3[Improve Error MessageDifficulty: 2/5Time: 45 min]
end
subgraph Intermediate Tasks
I1[Add Custom SourceDifficulty: 3/5Time: 4 hours]
I2[Fix Bug with TestsDifficulty: 3/5Time: 2 hours]
I3[Add Feature FlagDifficulty: 3/5Time: 3 hours]
end
subgraph Advanced Tasks
A1[Refactor ComponentDifficulty: 4/5Time: 1 day]
A2[Performance OptimizationDifficulty: 4/5Time: 2 days]
A3[Architecture ChangeDifficulty: 5/5Time: 1 week]
end
B1 --> Success1[Quick Win [OK]]
B2 --> Success1
B3 --> Success1
Success1 --> Confidence[Build Confidence]
I1 --> Success2[Solid Contribution [OK]]
I2 --> Success2
I3 --> Success2
Success2 --> Competence[Demonstrate Competence]
A1 --> Success3[Major Impact [OK]]
A2 --> Success3
A3 --> Success3
Success3 --> Mastery[Achieve Mastery]
style Success1 fill:#4ecdc4,stroke:#333,stroke-width:2px
style Success2 fill:#ffa500,stroke:#333,stroke-width:2px
style Success3 fill:#d75f00,stroke:#333,stroke-width:2px,color:#fff
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Knowledge Acquisition Stages
stateDiagram-v2
[*] --> Novice: Day 1
Novice --> AdvancedBeginner: Week 1
note right of Novice
Can follow instructions
Needs guidance
Understands basics
end note
AdvancedBeginner --> Competent: Month 1
note right of AdvancedBeginner
Can work independently
Understands patterns
Makes decisions
end note
Competent --> Proficient: Month 3
note right of Competent
Sees big picture
Anticipates issues
Helps others
end note
Proficient --> Expert: Month 6+
note right of Proficient
Intuitive understanding
Architectural decisions
Mentors team
end note
Expert --> [*]: Mastery
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Onboarding Checkpoint System
graph TB
Start([OnboardingBegins]) --> C1{Checkpoint 1Day 1}
C1 -->|Pass| C2{Checkpoint 2Week 1}
C1 -->|Fail| R1[Extra Support]
R1 --> C1
C2 -->|Pass| C3{Checkpoint 3Week 2}
C2 -->|Fail| R2[Pair Programming]
R2 --> C2
C3 -->|Pass| C4{Checkpoint 4Month 1}
C3 -->|Fail| R3[Mentoring Sessions]
R3 --> C3
C4 -->|Pass| Complete[OnboardingComplete [OK]]
C4 -->|Partial| R4[Extended Onboarding]
R4 --> C4
C1 --> M1[Vault init + first fetch successful]
C2 --> M2[Architecture + vault model understoodFirst PR merged]
C3 --> M3[Independent workCode review participation]
C4 --> M4[Feature deliveredTeam contributor]
Complete --> Next[Regular Team Member]
style Complete fill:#4ecdc4,stroke:#333,stroke-width:2px
style Next fill:#d75f00,stroke:#333,stroke-width:4px,color:#fff
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Skill Development Matrix
graph LR
subgraph Week 1 Skills
W1A[Vault Setup + pipx install]
W1B[Basic CLI + TUI Usage]
W1C[Code Reading]
W1D[Git Workflow]
end
subgraph Month 1 Skills
M1A[Architecture Knowledge]
M1B[Testing Practices]
M1C[Code Review]
M1D[Debugging]
end
subgraph Month 3 Skills
M3A[Feature Development]
M3B[Performance Optimization]
M3C[System Design]
M3D[Mentoring Others]
end
W1A --> M1A
W1B --> M1B
W1C --> M1C
W1D --> M1D
M1A --> M3A
M1B --> M3B
M1C --> M3C
M1D --> M3D
M3A --> Expert[ExpertDeveloper]
M3B --> Expert
M3C --> Expert
M3D --> Expert
style Expert fill:#d75f00,stroke:#333,stroke-width:4px,color:#fff
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Debugging Skills Development
flowchart TD
A[Encounter Issue] --> B{Can Solve?}
B -->|Yes| C[Solve Independently]
B -->|No| D[Debugging Strategy]
D --> E1[Read Error Message]
D --> E2[Check Documentation]
D --> E3[Search Past Issues]
D --> E4[Add Debug Logging]
D --> E5[Use Python Debugger]
E1 --> F{Understand?}
E2 --> F
E3 --> F
E4 --> F
E5 --> F
F -->|No| G[Ask for Help]
F -->|Yes| H[Implement Fix]
G --> I[Mentor Guides]
I --> H
H --> J[Test Fix]
J --> K{Works?}
K -->|No| D
K -->|Yes| L[Document Solution]
C --> L
L --> M[Learning Recorded]
M --> N[Skill Improved [OK]]
style N fill:#4ecdc4,stroke:#333,stroke-width:2px
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Pair Programming Flow
sequenceDiagram
participant J as Junior Dev
participant S as Senior Dev
participant C as Codebase
Note over J,S: Pair Programming Session
S->>J: Explain task context
J->>S: Ask clarifying questions
S->>J: Share screen / start session
loop Development Cycle
J->>C: Write code (driver)
S->>J: Suggest improvements (navigator)
J->>C: Refactor based on feedback
S->>J: Explain patterns & rationale
J->>S: Ask "why" questions
S->>J: Share best practices
end
J->>C: Commit changes
S->>J: Review together
J->>J: Summarize learnings
S->>J: Assign follow-up task
Note over J,S: Session Complete
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Success Metrics Dashboard
graph TB
subgraph Week 1 Goals
G1[Setup Complete: Target 100%]
G2[First Fetch: Target 95%]
G3[Docs Read: Target 80%]
G4[First PR: Target 50%]
end
subgraph Month 1 Goals
M1[Independent Tasks: Target 70%]
M2[Code Review: Target 80%]
M3[Testing: Target 85%]
M4[Team Integration: Target 90%]
end
subgraph Success Indicators
S1[Confidence Level]
S2[Code Quality]
S3[Team Collaboration]
S4[Learning Speed]
end
G1 --> S1
G2 --> S1
M1 --> S2
M2 --> S2
M3 --> S3
M4 --> S3
G4 --> S4
M1 --> S4
S1 --> Final[SuccessfulOnboarding]
S2 --> Final
S3 --> Final
S4 --> Final
style Final fill:#d75f00,stroke:#333,stroke-width:4px,color:#fff
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Learning Resources Map
mindmap
root((LearningResources))
Documentation
Architecture docs
API reference
Tutorials
Vault + config guides
Code Examples
Existing sources
Test files
Scripts
Examples directory
Team Support
Mentor 1-on-1s
Pair programming
Code reviews
Team chat
External Resources
Python docs
Web scraping guides
Testing tutorials
Design patterns
Practice
Hands-on exercises
Bug fixes
Feature additions
Refactoring tasks
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Onboarding Feedback Loop
flowchart LR
A[New MemberJoins] --> B[FollowOnboarding Guide]
B --> C[CompleteMilestones]
C --> D[ProvideFeedback]
D --> E[Pain PointsIdentified]
E --> F[UpdateDocumentation]
F --> G[ImproveProcess]
G --> H[BetterOnboarding]
H --> A
D --> I[SuccessPatterns]
I --> J[AmplifyWhat Works]
J --> G
style H fill:#4ecdc4,stroke:#333,stroke-width:2px
style G fill:#d75f00,stroke:#333,stroke-width:2px,color:#fff
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Team Integration Timeline
gantt
title New Team Member Integration
dateFormat X
axisFormat %M min
section Week 1
Environment Setup :done, 0, 240min
Code Exploration :done, 240min, 480min
First Contribution :active, 720min, 360min
section Week 2
Deep Dive Sessions :active, 1080min, 480min
Independent Task :active, 1560min, 600min
Code Review Practice :active, 2160min, 240min
section Month 1
Feature Development :crit, 2400min, 1200min
Team Collaboration :crit, 3600min, 600min
Fully Integrated :milestone, 4200min, 0min
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.
Mentorship Structure
graph TD
A[New Team Member] --> B{Assigned Mentor}
B --> C[Onboarding Buddy]
B --> D[Technical Mentor]
B --> E[Career Coach]
C --> C1[Day-to-day questions]
C --> C2[Cultural integration]
C --> C3[Team introductions]
D --> D1[Technical guidance]
D --> D2[Code review feedback]
D --> D3[Architecture discussions]
E --> E1[Career growth]
E --> E2[Skill development]
E --> E3[Goal setting]
C1 --> F[SuccessfulIntegration]
D1 --> F
E1 --> F
style F fill:#d75f00,stroke:#333,stroke-width:4px,color:#fff
Use the free software Draw.io to clearly visualize the mermaid diagrams.
Copy the mermaid code and from the drop-down menus select
Arrange → Insert → Advanced → Mermaid
.