Business analyst
“Do we agree on what ‘active customer’ means before we model it?”
The business glossary gives each term one definition, one technical name and one data type, and links it to every column that means the same thing. As Contributor you suggest changes to descriptions and metadata, and your suggestion is reviewed before it goes in. When several of you work on the same branch, you see each other in the diagram and who is editing what, as it happens.
Lead data modeler
“Does the model follow the same rules across teams?”
As Admin you define the data types and table types the project builds on, and which custom fields each table type should have. Changes are made in a branch, and you see them side by side with main in a comparison before they are merged. When several of you work on the same branch, you see each other in the diagram and who is editing what, as it happens.
Data engineer
“Which changes are ready for development, and is the spec complete enough to build?”
The statuses your project has set up show where each table stands. As Developer you edit the model in your own branch, and the model lives as files in the Git repo next to the code. Validation against Databricks, Fabric or dbt shows which tables and columns match, differ or are missing.
Platform engineer
“Can I change fifty tables from my editor and just keep Specly up to date?”
Yes. The model lives as files in its own Git repo, and each branch in Specly is one branch in the repo. When you make large changes to the files from your editor, with AI if you like, they come back into Specly through a review before they are merged. You work in the files, and Specly shows what they describe.