docs: roles, rails and hiring design draft (#1873) #1903

Merged
jason.woltje merged 2 commits from org-roles-design into refactor 2026-11-10 21:01:58 +00:00
Owner

Roles, rails and hiring design (#1873, doc only). This is a draft: two choices in it wait for Jason.

  • Records Jason's 2026-11-10 rulings: roles/ ship as templates; organization roles are imported, customized or invented; a hire is a decision the chief raises and a person with org.hire approves; no cap; no hire chains; credentials bind on approval; template copies stay frozen and the system offers a diff.
  • Sections: today's hire path; the rails (R1-R8, each with where it is enforced or which slice adds it); the role building blocks and a validator to replace HIRE_ALLOWED; templates; hire as a decision; plugins; the minimal base (user, assistant, chief); a usability vs security table; threat model; the proposed invariant 7 text (not applied); slices.
  • Open for Jason: (1) whether merge and policy decisions go to a person instead of the arbiter agent, which would partly reverse PRD 1.5 REQ-DEC-2; (2) loading pinned plugins from outside the loader's tree, which changes lead decision 143 (deferred to PL1).

Lane: Opus. Review: daybreak-blue security review, changes (2 P1, 2 P2), all fixed. Doc only: no change to AGENTS.md, roles/, contracts/ or code.

Roles, rails and hiring design (#1873, doc only). This is a draft: two choices in it wait for Jason. - Records Jason's 2026-11-10 rulings: roles/ ship as templates; organization roles are imported, customized or invented; a hire is a decision the chief raises and a person with org.hire approves; no cap; no hire chains; credentials bind on approval; template copies stay frozen and the system offers a diff. - Sections: today's hire path; the rails (R1-R8, each with where it is enforced or which slice adds it); the role building blocks and a validator to replace HIRE_ALLOWED; templates; hire as a decision; plugins; the minimal base (user, assistant, chief); a usability vs security table; threat model; the proposed invariant 7 text (not applied); slices. - Open for Jason: (1) whether merge and policy decisions go to a person instead of the arbiter agent, which would partly reverse PRD 1.5 REQ-DEC-2; (2) loading pinned plugins from outside the loader's tree, which changes lead decision 143 (deferred to PL1). Lane: Opus. Review: daybreak-blue security review, changes (2 P1, 2 P2), all fixed. Doc only: no change to AGENTS.md, roles/, contracts/ or code.
jason.woltje added 2 commits 2026-11-10 21:01:55 +00:00
Roles become templates plus organization copies built from known parts. A hire is a decision the chief raises and a human with org.hire approves. Rails listed with their enforcement points. Proposal only: no change to AGENTS.md, roles/, contracts/ or code.
Route merge, policy, hire, fire and credential decisions to the human and
keep merge and policy cross-role only. A person-started hire is a decision
record. Restructure the usability table by who acts, list template roles
explicitly, add the arbiter threat row and slice tests.
jason.woltje merged commit f98f278fbb into refactor 2026-11-10 21:01:58 +00:00
Sign in to join this conversation.