docs: align RACI overview with actual Kosli roles

[mintlify]

Brings the RACI matrix overview page in sync with the four roles actually defined in Roles in Kosli.

Changes in implementation_guide/phase_1/roles_and_responsibilities/overview.md:

• Added the missing Snapshotter role to the "Connecting Responsibilities to Permissions" section (previously listed only Admin/Member/Reader).
• Fixed the trailing "Roles in Kosli" reference — now a real link to /administration/managing_users/roles_in_kosli, plus a link to /administration/managing_users/mapping_users_to_roles.

Drive-by fixes:

• app_developers.md and platform_engineers.md had empty [Kosli user roles and permissions]() links — now point to /administration/managing_users/roles_in_kosli (matching the already-correct links on sponsors.md and security_compliance.md).

The RACI table itself (Platform Engineer / Application Developer / Security & Compliance / Sponsor) was left as-is — those are organizational roles for implementation responsibilities, distinct from Kosli platform roles, and they line up with the per-role pages and mapping_users_to_roles.

---

Generated by Mintlify Agent.

Requested by: marko@kosli.com via Slack
Mintlify session: slack_1782401819.556499_C0AJTQ5633K

[claude]

Claude finished @mintlify[bot]'s task in 1m 8s —— View job

---

PR Review: Align RACI overview with actual Kosli roles

• Read CLAUDE.md and doc-review skill
• Read PR diff and changed files
• Verify link targets and role accuracy
• Post review findings

---

Review Summary

This is a clean, well-scoped PR. The changes are correct and improve the docs.

What the PR does well:

• Adds the missing Snapshotter role to the RACI overview — verified against the authoritative reference at /administration/managing_users/roles_in_kosli, the description matches.
• Fixes two empty [Kosli user roles and permissions]() links in app_developers.md and platform_engineers.md — now pointing to /administration/managing_users/roles_in_kosli. Both target files exist.
• Converts a plain-text "Roles in Kosli" reference in overview.md into proper links to both /administration/managing_users/roles_in_kosli and /administration/managing_users/mapping_users_to_roles. Both targets exist.
• All links are root-relative (per CLAUDE.md convention). No relative links introduced.
• No new pages added, so no navigation.json update needed.
• Writing style is consistent with existing content.

---

Findings

Improvement (pre-existing, not introduced by this PR)

app_developers.md:79-81 — Three "Where to start" links still have empty () targets and render as broken links:

- [**Getting Started**]()
- [**Querying Kosli**]()
- [**Concepts**]()

platform_engineers.md:87-89 — Same issue, three more empty-target links:

- [**Getting Started Guide**]()
- [**CLI Reference**]()
- [**Concepts Overview**]()

These were not introduced by this PR, but since both files were already touched, it would be a good opportunity to fill them in. The equivalent links on sponsors.md and security_compliance.md are already populated.

---

Overall: Looks good to merge. The changes are accurate, well-scoped, and follow all conventions. The empty links noted above are pre-existing — fixing them here would be a nice bonus but isn't blocking.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
kosli	🔴 Failed	–	Jun 25, 2026, 3:50 PM