Team Onboarding

Introduce new teammates to Kiket quickly and consistently.

Pre-Onboarding Checklist

• Add the teammate to your identity provider (if using SSO).
• Ensure the organization has available seats/licenses.
• Confirm repositories contain project.yaml and team.yaml with role definitions.

Step-by-Step

1. Invite the User – In Organization settings, send an invitation by email. New users authenticate via email link or OAuth.
2. Grant Roles – Assign organization and project roles. If you manage roles via team.yaml, add the user to the relevant group and sync.
3. Provide Repository Access – Ensure the user can read the Git repositories that store .kiket/ configurations.
4. Walk Through the Board – Open the main project board, highlight provenance badges, and explain how workflow states map to columns.
5. Show Workflow Updates – Demonstrate editing a workflow file, opening a pull request, and seeing changes after sync.
6. Review CLI & Docs – Ask the teammate to install the CLI (gem install kiket-cli) and bookmark https://docs.kiket.dev.

Training Materials

• Recorded walkthroughs of creating an issue, moving it through the workflow, and using analytics dashboards.
• Cheat sheets for YAML snippets stored alongside your .kiket/ repository so they stay versioned with the rest of the configuration.
• Extension usage guides if your team relies on custom tooling.

Post-Onboarding

• Set up a check-in after the first sprint to gather feedback.
• Monitor activity to ensure the user participates in workflows without errors.
• Update documentation when new questions surface.

A structured onboarding keeps everyone aligned on the Git-first way of working.