Documentation

How GitSyntropy Works

A complete guide to the platform — from psychometric profiling to AI-synthesised team reports.

01

Getting Started

Three steps to your first team analysis.

02

Behavioral Assessment

The assessment measures 8 behavioural dimensions on a weighted scale. Each dimension feeds directly into the compatibility engine — higher-weight dimensions have more influence on the final score.

8pt

Chronotype Sync

Peak work-hour overlap — when energy peaks align across the team

7pt

Stress Response

How you respond under pressure and tight deadlines

6pt

Risk Tolerance

Bold vs cautious decision-making tendencies

5pt

Decision Style

Data-driven vs intuitive reasoning preference

4pt

Work Style

Solo-focus vs collaborative working preference

3pt

Team Resilience

Capacity to absorb and recover from setbacks

2pt

Leadership Orientation

Tendency to lead, follow, or self-direct

1pt

Innovation Drive

Appetite for novel approaches vs proven methods

info

Your profile is saved automatically after submission. You can retake the assessment at any time — the latest submission is always used. All team members should complete it before running a team analysis.

03

GitHub Sync

The GitHub Analyst agent fetches the last 30 days of commit activity from a member's public GitHub handle to build their chronotype profile — their natural work-hour pattern.

schedule What gets fetched

  • Commit timestamps (hour of day distribution)
  • PR merge frequency and review patterns
  • Collaboration index (cross-author review activity)
  • Activity rhythm score (consistency of schedule)

bedtime Chronotype categories

  • Lark — peaks before 10 AM, consistent early committer
  • Daytime — active 10 AM – 5 PM, standard schedule
  • Evening — ramps up after 5 PM, collaborative afternoon
  • Owl — peaks after 10 PM, late-night deep work
  • Flexible — uniform distribution, no strong peak
warning

GitHub Sync only works with public repositories. The sync runs via the Dashboard's GitHub Sync card — enter the member's GitHub handle, not their GitSyntropy user ID.

04

Compatibility Engine

Pairwise compatibility is scored across 8 dimensions each with a maximum weight, totalling 36 points. Scores above 28/36 are considered excellent collaboration potential.

Score Interpretation

Max: 36 points
28 – 36

Excellent

High alignment across all dimensions. Strong collaboration potential.

21 – 27

Good

Solid compatibility with minor friction areas. Will work well together.

14 – 20

Workable

Mixed alignment. Requires active communication in weak dimensions.

0 – 13

Challenging

Significant misalignment. Consider pairing strategies and coaching.

Dimensions flagged as "weak" (scoring below 40% of their maximum) are highlighted as critical vulnerabilities — these are the areas where the pair is most likely to experience friction.

05

Team Analysis Pipeline

"Run Full Analysis" triggers a LangGraph multi-agent pipeline that streams results in real time. Four agents run in sequence, each building on the previous.

hub
01

GitHub Analyst

Fetches the last 30 days of commit and PR activity for every team member. Classifies each member's chronotype and computes collaboration index and rhythm score.

psychology
02

Psychometric Profiler

Loads each member's assessment answers and maps them to the 8 dimensions. Produces a weighted behavioural profile per person.

compare_arrows
03

Compatibility Engine

Runs pairwise scoring across all member pairs. Identifies strong and weak dimensions, surfaces risk flags (e.g. chronotype mismatches), and computes the aggregate team score.

auto_awesome
04

Claude Synthesis

Claude Sonnet 4.6 streams a structured narrative report — strengths, vulnerabilities, hiring recommendations, and a Monte Carlo candidate simulation for optimal team fit.

06

Insights Report

The Insights page displays Claude's structured narrative. Each section is clickable and expandable. The report covers:

verified

Team Strengths

Dimensions where the team scores highest — what to double down on.

gpp_bad

Critical Vulnerabilities

Weak dimension pairs that are most likely to cause friction or delays.

bedtime

Chronotype Dynamics

Work-hour overlap analysis — who's in sync and who's asynchronous.

person_add

Hiring Recommendations

What behavioural profile would complement the current team's gaps.

casino

Monte Carlo Simulation

1000-iteration simulation of candidate profiles to find the statistically optimal hire.

directions

Recommended Actions

Concrete next steps for improving team health and collaboration.

tips_and_updates

Reports are saved to your browser's local storage. You can access any previous report by clicking "View Full Report" from the Dashboard, or navigating directly to /report?id=...

Ready to get started?

Complete your assessment first — it takes about 5 minutes and unlocks the full pipeline.