Tools and first-week setup

The tools a Software Architecture intern uses and how to set up your workspace in week one.

These are the main tools for Software Architecture tasks. You do not need all of them on day one; the Level 1 tasks tell you when to install each one.

  • C4 diagrams
  • ADRs
  • Docker
  • Message queues
  • OpenTelemetry

Set up your workspace

  • Create a free GitHub account if you do not have one, with a professional username, and set up your LinkedIn profile: every task is submitted with a LinkedIn post.
  • Create one repository for the internship, for example software-architecture-internship, with a README that says who you are and what the repo holds.
  • Keep one folder per task, named with the task number and title, so mentors find your work quickly.
  • Commit small changes every day with clear messages. Your daily work report uses these commits as proof.
  • Never commit passwords, API keys or personal data. Put secrets in a .env file and add it to .gitignore.

Your first tasks

TaskWhat to do
What architects doWrite a page on the role of a software architect: decisions, trade-offs, communication and quality attributes.
Quality attributesDefine performance, scalability, availability, security, maintainability and cost, with a measurable example for each.
Layered architectureBuild a small app with presentation, business and data layers, and explain what each layer may and may not call.
SOLID principlesShow each SOLID principle with a short bad and good code example.
โ† What a Software Architecture intern doesAll 60 tasks, level by level โ†’