Skip to content

Nebulab playbook

public

Hello! We are Nebulab, a full-service e-commerce agency. We specialize in building bespoke e-commerce experiences for disruptive brands.

The whole (almost) team meeting in Spain for the 2024 retreat

This playbook documents how we work, how we run the company, and how we deliver for clients. We were born in 2011 and have been remote-first since day one: it started as a humble GitHub Wiki, one of our very first company-wide initiatives, and it has changed shape more than once since. Our vision for it has stayed the same: to document both the kind of company we are creating and the kind of change we are effecting.

It’s plain Markdown, so it can be read by humans on GitHub and by AI agents from a local checkout.

Folders follow subjects, not teams. There are two kinds of content, and the folder tells you which one you are reading:

  • The playbook is every folder except the one below. A page there describes how we work today. If it is out of date, fix it.
  • Clients (delivery/clients/) holds one entry per client: the profile is current, the project material next to it is dated.

Every page declares who may read it: public for anyone, client for the clients we work with, internal for teammates only. The website shows each visitor only what they are allowed to see.

  • Company: who we are, our mission, values, culture, story, team, and Press Room.
  • Ways of working: how we communicate, run meetings, use our tools and make decisions, and the yearly calendar of our rituals.
  • Time: working hours, time tracking, and time off.
  • Pay and benefits: compensation, welfare, equipment, travel and expenses, and an overview of every benefit.
  • Growth: 1:1s, feedback, performance reviews, the career framework, and learning (Investment Time, conferences, English, internal training).
  • Team life: team retreats, the rituals that keep us connected, and celebrations.
  • Joining and leaving: hiring, onboarding, and offboarding.
  • Delivery: how we deliver client work: the disciplines every project draws on (project management, design, engineering, Shopify engineering), the services we sell (CRO, discovery workshops, Shopify replatforms), and Clients, the profiles and research for specific clients.
  • Business development: how we generate and win business, through Marketing (the channels and activities we use to build awareness), Sales (leads, opportunities, contracts, and pricing) and Partnerships (the partner program and directory).
  • Operations: how we run HR, finance and administration, including Finance, how we read the numbers and the administrative procedures behind them.

Start with Company, then find out why we’re doing it in Mission and vision and dig into Values to understand how we’re getting there. Continue with our Culture and find out how we Grow.

Hey… that’s great! ❤️

Read all the above, then continue with Pay and benefits, Learning, Team life, and Onboarding. Make sure you also read the Hiring process before sending your application!

Welcome to Nebulab! Onboarding can be a rough ride, so take some time to dig deeper into the Nebulab culture. Start with a full re-read of Onboarding, then the Ways of working, then find out more about Nebulab’s Story and get acquainted with the rest of the Team.

You should be pretty familiar with Ways of working, Time, Pay and benefits and Growth by now. Depending on your role, keep reading: Career explains how to write your journey at Nebulab, and the subject sections (Delivery, Business development, Operations) cover what your team does day to day.

CONTRIBUTING.md explains how pages, folders and frontmatter are organized and how to check your changes. AGENTS.md tells AI agents how to read and cite the playbook.