---
id: fix-adr-terminology
name: Fix ADR Terminology Inconsistencies
status: completed
depends_on: []
scope: narrow
risk: low
impact: isolated
level: implementation
---

## Description

W14: Three terminology inconsistencies across ADRs and docs:
- ADR-009 says "organization_members (membership with **roles**)" — contradicts ADR-012's rename to `membershipLevel`
- ADR-012:55 uses `accounts.role: "service"` in rationale, despite mandating the rename to `accessLevel`
- `agent-roles.md` also uses `accounts.role: "service"`

Update ADR-009 to say "membership with levels." Update ADR-012:55 and agent-roles.md to use `accounts.accessLevel: "service"`.

## Acceptance Criteria

- [ ] ADR-009 updated: "membership with levels" instead of "membership with roles"
- [ ] ADR-012:55 updated: `accounts.accessLevel: "service"` instead of `accounts.role: "service"`
- [ ] `agent-roles.md` updated: `accounts.accessLevel: "service"` instead of `accounts.role: "service"`
- [ ] No remaining references to the old terminology (`accounts.role`, `membershipLevel` as "roles")

## References

- docs/reviews/storage-architecture-review-2026-04-21.md#W14
- docs/decisions/ADR-009:13
- docs/decisions/ADR-012:55
- docs/architecture/agent-roles.md

## Notes

> To be filled by implementation agent

## Summary

> To be filled on completion