Skip to content

Your guide through the complexities of software projects. A curated playbook of principles, checklists, and strategies for senior engineers and tech leads.

License

Notifications You must be signed in to change notification settings

PrzemyslawSagalo/vergilii

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 

Repository files navigation

vergilii

Your guide through the complexities of software projects. A curated playbook of principles, checklists, and strategies for senior engineers and tech leads.

Useful web resources

Project Kick-off

Project Kick-off: Core Questions

  • Cloud & Account: Which provider (AWS, GCP, Azure)? Existing client account or new?
  • Authentication & Authorization: What is the primary auth model for cloud services? (e.g., IAM Roles, Service Accounts).

Core Collaboration Principles

  • Sprint Commitment Tasks committed to a sprint must be completed by its end. This requires realistic planning, breaking down work properly, and flagging risks early to ensure predictable delivery.

  • Asynchronous-First Communication We communicate asynchronously to protect focus time. Do not expect immediate replies; we respond as soon as we are able. Plan your work accordingly and provide full context in your initial message to make this effective.

  • Ownership and Action Issues and setbacks are normal in development. When you discover a problem, convert complaints into action by creating a task so it can be tracked, prioritized, and solved.

Good coding practices

  • Instantly update the changelog with new information.
  • Use C4 model to model an architecture. You can draw blueprints in structurizr.
  • Use Mermaid for all graphs and flowcharts.
  • YAGNI
    • Write extensible code, but only add the functionalities needed now.
  • If your changes are not ready to be submitted at the end of your work day, make a dirty branch, commit all of your changes to it (typically git commit -am'WIP') and push it to a remote.
  • TDD works only when you fully understand the problem and interface. Building a thing is a good way to explore.
  • You should set up a clear naming convention at the beginning of your project and stick to it.

Daily Toolkit

Productivity

  • Nozbe - It serves as the primary source of truth for my family’s tasks and my own.
  • brain.fm - Music to focus
  • raindrop - A bookmark manager that offers tagging options and fully integrates through a RESTful HTTP API.

AI tools

  • Google Gemini - Similar to Chat GPT but developed by Google. Its full integration with Google Workspace is a significant advantage, allowing users access to both services for one fee.

🤝 Transparency Note

Just so you know, some of the links on this page are referral links. This means that if you click on them and make a purchase or sign up, I might receive a small commission or benefit from the company, at no extra cost to you.

I only recommend products and services that I've personally used and genuinely believe will be valuable to you. Your support through these links helps me continue to share valuable resources and content like this and improve the quality, also for you!

About

Your guide through the complexities of software projects. A curated playbook of principles, checklists, and strategies for senior engineers and tech leads.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published