Gitlab hero border pattern left svg Gitlab hero border pattern right svg

Solutions Architects

Solutions Architect Handbook

Solutions Architects (SA) are the trusted advisors to GitLab prospects and customers during the presales motion, demonstrating how the GitLab application and GitLab Professional Services address common and unique business requirements. SA's add value to GitLab by providing subject matter expertise and industry experience throughout the sales process.

SA's identify and propose comprehensive solutions to complex business problems and workflow scenarios after compiling inputs from customer conversations. Desired inputs include pain points, role-based visibility concerns, opportunities for improved efficiencies, current technologies and tools, corporate initiatives, target outcomes and more. SA's also act as the technical liaison between the sales team and other groups within GitLab, engaging GitLab employees from other teams as needed in order meet the needs of the customer.

Role & Responsibilities

See the Solutions Architect role description

In addition to core responsibilities, Solutions Architects may assist in other client-facing activities aligned to Content Marketing or Strategic Marketing such as blogs, videos, webinars, presentations and industry trade show presence. Some examples are listed below:

Demo Readiness

Solutions Architects are occasionally called on at a moments notice to give a demo or join a call to show a prospect or customer specific GitLab functionality. A best practice for being prepared for these demo requests is to have a minimized browser window with various content preloaded into the browser tabs. Examples of common environments utilized are listed below. Note that accessing some of these links are only enabled for GitLab team-members.

Solutions Architects frequently interact with customers for demos, presentations or Q&A. These calls should enable the customer to clearly experience the value of GitLab without distraction or interruption. The below list of tools was compiled by the GitLab SA team as commonly used solutions. Note, this list does not represent a requirement to use any of these products or an endorsement for these products.

Related Mac OS tips

Working Agreements

Enterprise Solutions Architects typically support two sales teams made up of Sales Development Representatives, Strategic Account Leaders and Technical Account Managers. Commercial Sales Solutions Architects support Mid-Market Account Executives and SMB Customer Advocates in a pooled model. When joining a sales team, establishing working agreements is critical to providing optimal service to the customers as well as the GitLab team. A sample template of working agreements is found below to help facilitate conversation and establish these agreements:

  1. Customer response time for emails and meeting followups I will always do my best to provide same-day responses to customer inquiries and follow ups unless otherwise noted. I like to provide customers top-notch service, but interruptions can affect that target. I will use my out of office when traveling so customers can expect delayed responses during those times. Feel free to contact me if it's approaching the end of the day and you didn't see me address a customer request. Slack is the easiest way to find me most of the time.
  2. Calendar Schedule things as necessary right on my calendar during working hours - I'll do my best to keep my calendar up to date. However, if you see only one empty slot for a day or if it looks like the meeting would be back to back with something else, please check with me before confirming dates and times with the customer. If you want me at my best for you, I will need time to prepare and followup. If we schedule back to back, I've found I'm often late to arrive due to the last meeting, flustered as I context shift, lacking answers for known questions, unprepared with demo environments that were altered in the last call, etc.
  3. Regular communication A weekly strategy hour-long call with the SA, SAL, SDR and TAM is preferred. If more frequent synchronous communication is desirable or required, we should work together as a team to identify a viable cadence, required attendees, convenient time and agenda for those calls.
  4. Elevated conversations The more we focus on value and stay away from very deep technical and troubleshooting conversations, the more I can help you achieve target sales. I'm happy to review and contribute to business plans so we remain in sync.
  5. Professional Services I'm happy to recommend and propose services for prospects and customers. I will write the initial SOW and get approvals from the Professional Services team.
  6. Travel While strategic enterprise sales absolutely require travel, each day on the road can increase the volume of work and calls on other days of the week as my dialogs with customers often require extensive time commitments to research and model specific customer solutions. Please plan strategically when looking at on-sites, considering that I support at least two sales teams. Additionally, please do what you can to avoid scheduling on-site visits less than one week out to help me be able to commit to family and local things.
  7. Notes Unless otherwise directed, call notes will be linked to a Google document from Salesforce. Email communication with customers will also be bcc'd to Salesforce. If you prefer to record notes and actions differently, please let me know what that collaborative method is.
  8. Continuous learning Things at GitLab move really fast, and I need time to keep up. I'll block a few hours on my calendar coincident with releases to absorb the latest GitLab feature set, but new technologies and competitive products also appear regularly. Please expect that I will need to allocate additional time to learning about those on a regular basis to sufficiently support our customers.

Engaging a Solutions Architect


  1. What is the reason to engage the SA team?
    • Discovery after lead qualification is complete
    • GitLab demos
    • GitLab technical deep dives
    • Customer GitLab days
    • Whiteboarding sessions
    • Customer questions
    • RFI/RFP/Security audits
    • Marketing event support
    • Statement of Work for Professional Services
  2. What is the opportunity?
    • Share any existing notes about the opportunity
    • Key players and personas
    • Other relevant information shaping an engagement
    • Is there a business plan or sales approach defined?


  1. Outcome:
    • What’s in it for the client?
    • Why look at a new strategy for software development?
    • Solutions Architects need to be able to tailor conversations and demos to demonstrate value as well as how to address current problem areas.
  2. Infrastructure:
    • What tools are currently in place?
    • What tools have potential to be replaced?
    • What processes or workflows have potential to change?
  3. Challenges:
    • What problems/roadblocks have been uncovered?
    • What is the current release velocity?
    • What is the current planning process?
    • What visibility, traceability or efficiency concerns exist?
    • What collaboration or governance opportunities exist?
    • What security or compliance inefficiencies exist?

SA/TAM engagement overlap

The SA owns all pre-sales technical relationships and activities. The SA quarterbacks technical conversations prior to the sale. TAM involvement prior to the sale models the expectations for customer relationships after the sale. TAM involvement should supplement, not displace, SA pre-sales ownership of the account.

TAM engagement prior to the sale should occur in the following situations:

The TAM owns the account post-sale. SA's are to remain involved in the following situations:

When and How to Engage a Solutions Architect

The SA should either be included in a discovery call or provided with Outcome / Infrastructure / Challenges information uncovered by prior interactions with the account. Occasionally, SA's may support a combination call of discovery and technical demonstration/deep-dive on a single call, but this is suboptimal as the latter approach does not allow the SA time to prepare for and/or tailor the discussion.

The SA is also responsible for any pre-sales technical customer inquiry or audit from associated accounts, including RFI, RFP or security audits. For details on the audit process, proceed to the Security page.

The SA is always responsible for drafting Professional Services SOW's, regardless of the account status (pre- and post-sales).

As a general guideline, no more than 2 Solutions Architects should join any single client-facing call, whether it be assistive for the topic or for learning / shadowing.

Engaging a Solutions Architect for Marketing Events

When technical staff is required for a marketing event, follow the process outlined on the Marketing Events page. SA managers and others in Customer Success should monitor the Event Staffing Board regularly for new events (although Marketing staff will CC the appropriate managers on issues.)

U.S. Strategic Account Engagement Model

U.S. Enterprise SA's are aligned regionally with Strategic Account Leaders and aligned in their respective account activities. Each team collaborates according to their own Working Agreements.

When workload exceeds the SA's capacity or when there is a request from other departments, please submit the request for assistance on either of the enterprise triage boards based on region: US EAST Triage Board or US WEST Triage Board. The issue creation and triage processes are described in detail below.

EMEA Account Engagement Model

SA engagement for customer interactions, RFP's, audits and more can be requested by any EMEA-based sales executive or other GitLab team-member using the appropriate GitLab issue board. The EMEA Triage Board is leveraged by the team in order to ensure coverage for all sales activity. The issue creation and triage processes are described in detail below.

Commercial Engagement Model

SA engagement for customer interactions, RFP's, audits and more can be requested by an SMB or Mid-Market Account Executive or other GitLab team-member using the appropriate GitLab issue board. Commercial boards exist for both the Americas and EMEA. The Americas Commercial Triage Board and the EMEA Commerical Triage Board are leveraged by the team in order to ensure coverage for all sales activity. The issue creation and triage processes are described in detail below.

APAC Account Engagement Model

Customer Success Team (SA/TAM) engagement for customer interactions, RFP's, audits and more can be requested by a Strategic Account Leaders, an SMB or Mid-Market Account Executive or other GitLab team-member using the appropriate GitLab issue board. A single APAC Triage board exists that serves both Enterprise and Commerical markets. The APAC Triage Board is leveraged by the team in order to ensure coverage for all sales activity. The issue creation and triage processes are described in detail below.

Issue Creation Details

1) Navigate to the correct board for your region. NOTE: All triage boards are located in the SA Triage Boards group in projects broken out by region or engagement model.

2) Create a new issue.

3) Use one of the available templates:

4) To help the SA group ensure success for the client, the following information should be made available prior to SA engagement

5) Add one or more of the following labels as needed (labels listed below).

Board Label Descriptions

Triage of Issues

The SA team associated with each region will monitor the triage board and/or an associated Slack channel for incoming work and will contact the appropriate Customer Success team members via Slack, email or phone depending on required skills, schedules and availability. SLA for activity is 48 hours unless the issue is marked with an 'Expedite' label.