| name | org-restructure |
| description | Restructure a living explicit org in LibrAgent without dissolving it. Use when an org already exists and you need to add/remove/merge roles in ROLES.md, update the org constitution (agents.md, MISSION.md), remove or retire org child sessions, reassign KANBAN owners, or record structural changes in coordination files. Not for initial org creation (use org), initial scaffolding (use teamwork), org dissolution, or archive. |
Org Restructure
Tune an existing explicit org. This is evolution, not creation and not teardown.
Use org when the org does not exist yet or you need runtime coordination (spawn, resume, getOrg).
Use teamwork when the teamwork artifact directory or constitution files do not exist yet.
Path conventions
Teamwork files live in the app-local artifact directory (Teamwork SSOT). Access them via:
@teamwork/... aliases in agent tools./.libragent/teamwork/... from shell in the org root workspace
Do not edit repo-root copies unless the user explicitly wants repo pollution.
Workflow
- Confirm this is restructure, not bootstrap.
.libragent/teamwork.json must exist with executionSubstrate.mode: "org" and orgLineage.intended: true.- An
orgId must already be set (from agent__createOrg or manifest).
- If not, stop and use
teamwork then org.
- Run pre-flight audit — see impact-analysis.md.
- Pick one primary operation (add, layoff, merge, constitution update, child removal). Load the matching reference checklist.
- Apply constitution + coordination changes in dependency order (decision record → ROLES/MISSION/agents → KANBAN/HANDOFF → sessions).
- Propagate refresh — constitution edits apply on a later execution step, not the current turn.
- Verify with
agent__getOrg and a quick coordination-file scan.
Operation routing
| User intent | Read first | Primary edits |
|---|
| Add a role | constitution-update.md | ROLES.md, MISSION.md, optional skills/tf-*, spawn child |
| Remove a role (layoff) | layoff-checklist.md | ROLES.md, KANBAN owners, HANDOFF, child sessions |
| Merge duplicate roles | merge-checklist.md | ROLES.md, MISSION.md, skills, session mapping |
| Change operating rules | constitution-update.md | agents.md, DECISIONS.md |
| Remove child from org view | layoff-checklist.md § Child sessions | stop/delete session; no detach API yet |
Core rules
- ROLES.md is the role contract; MISSION.md must stay in sync when roles change. Update both in the same change set.
- Record every structural change in
@teamwork/coordination/DECISIONS.md before or alongside file edits.
- Reassign before you delete. Move KANBAN owners and HANDOFF targets off a removed role before layoff or merge.
- Prefer org root for coordination. Resume or message the root (
orgLineage.rootSessionId) to broadcast constitution refresh.
- Do not call
agent__createOrg again. Restructure edits files and sessions; it does not recreate org identity.
- Refresh semantics: after
agents.md / ROLES.md edits, tell active members the new rules apply on their next execution step.
Child session removal (current platform limits)
There is no agent__detachFromOrg tool today. To remove a session from org view:
- Retire work:
agent__stopSession(sessionId) then agent__deleteSession(sessionId) if permanent removal is OK.
- Keep work, hide from org: not supported — document the limitation and ask the user to choose stop/delete or leave the session idle.
Passing None to update_org_identity exists in the backend but is not exposed as an agent tool.
Guardrails
- Do not dissolve the org, delete the org root, or archive the entire teamwork artifact directory — out of scope.
- Do not remove the org root session from the org; the root is the canonical entry point.
- Do not edit only ROLES.md while leaving stale role sections in MISSION.md.
- Do not lay off a role while its tasks remain assigned to that role in KANBAN.md.
- Do not merge roles without picking one canonical agent ID and one primary artifact owner per merged responsibility.
References
