Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,19 @@ You are the one holding it all together. You are the human API.

---

## See it

<p align="center">
<img src="./orgx-live-mission-control-0.7.15-check.png" alt="OrgX Mission Control showing coordinated initiatives, workstreams, and execution state inside OpenClaw" width="48%" />
<img src="./orgx-live-activity-0.7.15-check.png" alt="OrgX Activity view showing live agent updates, decisions, and shared execution history inside OpenClaw" width="48%" />
</p>

<p align="center">
<em>Mission Control for shared execution state. Activity for the live history your agents can build on.</em>
</p>

---

## What changes after you install this

| Before OrgX | After OrgX |
Expand Down
3 changes: 2 additions & 1 deletion skills/orgx-design-agent/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,4 +35,5 @@ For UI changes:
## Reporting Protocol (OrgX)

- `orgx_emit_activity` for intent/execution/review/completed.
- `orgx_apply_changeset` for decisions and state updates.
- `orgx_request_decision` for the default-safe human approval path.
- Use `orgx_apply_changeset` only when your scope explicitly exposes mutation tools.
3 changes: 2 additions & 1 deletion skills/orgx-marketing-agent/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,4 +37,5 @@ When asked for a campaign/content:
## Reporting Protocol (OrgX)

- `orgx_emit_activity` for progress updates.
- `orgx_apply_changeset` to request decisions when messaging needs approval.
- `orgx_request_decision` when messaging, positioning, or approval needs a human call.
- Use `orgx_apply_changeset` only when your scope explicitly exposes mutation tools.
3 changes: 2 additions & 1 deletion skills/orgx-operations-agent/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,4 +37,5 @@ For ops deliverables:
## Reporting Protocol (OrgX)

- `orgx_emit_activity` for progress and status.
- `orgx_apply_changeset` for blocking decisions and state changes.
- `orgx_request_decision` for blocking human decisions in default-safe mode.
- `orgx_apply_changeset` for state changes when the operations scope exposes mutation tools.
3 changes: 2 additions & 1 deletion skills/orgx-orchestrator-agent/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,4 +42,5 @@ When creating work:
## Reporting Protocol (OrgX)

- Use `orgx_emit_activity` frequently (append-only).
- Use `orgx_apply_changeset` for entity mutations and decisions.
- Use `orgx_apply_changeset` for entity mutations when the orchestration scope exposes it.
- Use `orgx_request_decision` for human approvals or when running in a default-safe surface.
103 changes: 103 additions & 0 deletions skills/orgx-power/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
---
name: orgx-power
description: Power-user OrgX skill for OpenClaw. Use when you explicitly need the full mutation surface for entity CRUD, run control, checkpoints, stream reassignment, or agent-config policy changes.
version: 1.0.0
user-invocable: true
tags:
- orchestration
- orgx
- power-user
- openclaw
---

# OrgX Power (OpenClaw)

Use this skill only when the caller explicitly needs the **full mutation surface** exposed by the OrgX OpenClaw plugin. This is the elevated counterpart to the default-safe `orgx` skill.

> Use `orgx` by default. Use `orgx-power` when you need admin or orchestration operations that change entity state directly.

## When to use this skill

- creating or updating OrgX entities directly
- reassigning streams or changing execution ownership
- pausing, resuming, cancelling, or rolling back runs
- listing or restoring checkpoints
- inspecting or updating managed agent config policy
- working against the unscoped `/orgx/mcp` endpoint rather than a domain-scoped safe surface

## Elevated tool surface

These tools are part of the plugin registry, but are elevated and should be used intentionally:

- `orgx_apply_changeset`
- `orgx_create_entity`
- `orgx_update_entity`
- `orgx_list_entities`
- `orgx_reassign_stream`
- `orgx_reassign_streams`
- `orgx_delegation_preflight`
- `orgx_run_action`
- `orgx_checkpoints_list`
- `orgx_checkpoint_restore`
- `orgx_agent_sessions`
- `orgx_resume_agent_session`
- `orgx_clear_agent_session`
- `update_agent_config`
- `orgx_sentinel_catalog`

The default-safe reporting tools still apply and should usually wrap elevated work:

- `orgx_emit_activity`
- `orgx_request_decision`
- `orgx_register_artifact`
- `orgx_spawn_check`
- `orgx_proof_status`
- `orgx_verify_completion`

## Operating discipline

1. Announce intent with `orgx_emit_activity` before making mutations.
2. Prefer `orgx_request_decision` before irreversible or org-wide changes.
3. Use `orgx_apply_changeset` when you need idempotent batched state updates.
4. Register artifacts for anything another operator would need to inspect later.
5. Verify completion and proof state after major mutations.

## Examples

### Batched entity mutation

```js
orgx_apply_changeset({
initiative_id: "aa6d16dc-d450-417f-8a17-fd89bd597195",
idempotency_key: "run_abc_turn_7_commit_1",
operations: [
{ op: "task.update", task_id: "task_uuid", status: "in_progress" },
{ op: "decision.create", title: "Use SSE for live updates", urgency: "medium" }
]
})
```

### Reassign a stream

```js
orgx_reassign_stream({
initiative_id: "aa6d16dc-d450-417f-8a17-fd89bd597195",
workstream_id: "7f8e2f61-...",
domain: "operations",
role: "reliability"
})
```

### Run control

```js
orgx_run_action({
runId: "9d5c8b2b-...",
action: "pause",
reason: "Waiting for approval on production cutover"
})
```

## Safety note

This skill assumes the runtime actually exposes the elevated tools. In the managed OrgX agent suite, many domain-scoped surfaces intentionally hide them. If a tool is unavailable, fall back to the safe `orgx` skill and request the necessary human decision or orchestration context.
3 changes: 2 additions & 1 deletion skills/orgx-product-agent/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,4 +36,5 @@ When producing product artifacts:
## Reporting Protocol (OrgX)

- Use `orgx_emit_activity` for progress updates and next steps.
- Use `orgx_apply_changeset` for decisions and task/workstream status changes.
- Use `orgx_request_decision` for product tradeoff approvals in default-safe mode.
- Use `orgx_apply_changeset` for task/workstream mutations only when your scope explicitly exposes mutation tools.
3 changes: 2 additions & 1 deletion skills/orgx-sales-agent/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,4 +37,5 @@ When producing sales materials:
## Reporting Protocol (OrgX)

- `orgx_emit_activity` for progress.
- `orgx_apply_changeset` for decisions and approvals when required.
- `orgx_request_decision` for pricing, messaging, and approval gates in default-safe mode.
- Use `orgx_apply_changeset` only when your scope explicitly exposes mutation tools.
Loading
Loading