Agent Operation

operating base · v1.0

8 entity types · 33 relationships · 17 named queries · 3 guards

Agent-native operation state for coordinating human and agent work over one or more durable domain ontologies. Models the operating layer: work, reviews, decisions, risks, open questions, actors, lifecycle, blockers, dependencies, composition, lineage, and optional references out to domain state. Not a domain model, ticketing clone, document inventory, workflow catalog, or memory store.

source on GitHub →

Entity types

Actor

Human, agent, service account, or system actor referenced by operation state. Auth-managed: instances materialize from runtime-credential mints (identity source of truth = the credential store) and are writable by no other path, so every property is a credential-derived fact. label is the credential label; kind derives from the authenticated actor type.label · kind · status

SubjectRef

Lightweight reference to an external/cross-instance/not-yet-modeled subject. In a composed same-instance graph, prefer explicit typed operation-to-domain relationships over wrapping modeled domain entities in SubjectRef.label · subject_type · subject_id · state_ref · summary

WorkItem

Execution-level item an agent or human can work, review, close, defer, or supersede.title · summary · description · rationale · type · status · priority · target_date

ReviewRequest

Review checkpoint that can gate completion of a work item.title · status · summary · change_repo · change_base · change_head · requested_at · resolved_at

Decision

Durable operating decision with lifecycle, rationale, impact, and supersession context.title · summary · rationale · status · decided_at

Risk

Operational risk that can block or materially delay work.title · summary · status · priority

OpenQuestion

Open question that can block work or decisions until answered.title · summary · status · due_date

StateNote

Durable dated note about operation state (corrections, field notes, rationale updates, implementation notes, review notes). Preserves evolving interpretation without turning current entity summaries into changelogs.kind · title · summary · body · created_at

Relationships

governed33

work_item_owned_by_actor

WorkItem → Actor

review_request_requested_by_actor

ReviewRequest → Actor

review_request_assigned_to_actor

ReviewRequest → Actor

decision_owned_by_actor

Decision → Actor

risk_owned_by_actor

Risk → Actor

open_question_owned_by_actor

OpenQuestion → Actor

state_note_authored_by_actor

StateNote → Actor

review_request_for_work_item

ReviewRequest → WorkItem

state_note_about_work_item

StateNote → WorkItem

state_note_about_review_request

StateNote → ReviewRequest

state_note_about_decision

StateNote → Decision

state_note_about_risk

StateNote → Risk

state_note_about_open_question

StateNote → OpenQuestion

state_note_about_subject

StateNote → SubjectRef

state_note_about_actor

StateNote → Actor

state_note_supersedes_state_note

StateNote → StateNote

state_note_resolves_state_note

StateNote → StateNote

work_item_depends_on_work_item

WorkItem → WorkItem

work_item_part_of_work_item

WorkItem → WorkItem

work_item_spawned_from_work_item

WorkItem → WorkItem

work_item_supersedes_work_item

WorkItem → WorkItem

risk_blocks_work_item

Risk → WorkItem

open_question_blocks_work_item

OpenQuestion → WorkItem

open_question_blocks_decision

OpenQuestion → Decision

work_item_mitigates_risk

WorkItem → Risk

work_item_answers_open_question

WorkItem → OpenQuestion

decision_answers_open_question

Decision → OpenQuestion

decision_supersedes_decision

Decision → Decision

decision_constrains_work_item

Decision → WorkItem

work_item_targets_subject

WorkItem → SubjectRef

decision_affects_subject

Decision → SubjectRef

risk_attaches_to_subject

Risk → SubjectRef

open_question_concerns_subject

OpenQuestion → SubjectRef

Named queries

work_queue · → WorkItem

Active work items dispatched for implementation -- the queue an implementer or agentic loop pulls from. Curate by setting a work item's status to active.

work_item_context · WorkItem → AnyEntity

From a work item, inspect dependencies, blockers, reviews, composition, lineage, decisions, owner, subjects. all_adjacent expands against the final composed config, so on a composed instance this query also traverses overlay seam edges (e.g. project-domain's roadmap, release, milestone, and area relationships).

actor_work_queue · Actor → WorkItem

Work items owned by an actor with latest reviews, dependency counts, blockers, subjects.

review_queue · → ReviewRequest

Review requests awaiting a reviewer -- requested or in review. Reviews sent back for rework live in changes_requested_reviews.

changes_requested_reviews · → ReviewRequest

Review requests sent back with changes requested -- the implementer's rework queue, distinct from the reviewer-facing review_queue.

recent_state_notes · → StateNote

Recent operation-state notes, corrections, rationale/implementation/review notes.

state_note_context · StateNote → AnyEntity

Full context for a state note (targets, author, supersession).

state_notes_for_work_item · WorkItem → StateNote

State notes attached to a work item, newest first.

state_notes_for_review_request · ReviewRequest → StateNote

The review thread: verdict and finding notes attached to a review request, newest first. This is the read that replaces scrolling a notes blob.

approved_reviews_for_work_item · WorkItem → ReviewRequest

Approved review requests for a work item. Used by the closed-transition guard.

blocked_work_items · → WorkItem

Work items marked blocked, with risk/open-question blocker context.

work_item_rollup_context · WorkItem → WorkItem

Child/descendant work items under a parent.

work_item_lineage_context · WorkItem → WorkItem

Work item lineage/replacement context, excluding sequencing deps.

subject_operation_context · SubjectRef → AnyEntity

Work, decisions, risks, open questions attached to a subject ref.

active_risks · → Risk

Active operational risks.

open_questions_needing_review · → OpenQuestion

Planned/active open questions needing review.

proposed_decisions · → Decision

Proposed decisions awaiting acceptance/rejection/deferral.

Guards

review_verdict_requires_rationale_note · ReviewRequest.status -> [changes_requested, approved, withdrawn]

A ReviewRequest verdict must co-write a new StateNote(kind=review_note) linked via state_note_about_review_request in the same write. Status can't advance without recording why.

review_request_approval_requires_authorized_actor · ReviewRequest.status -> approved

ReviewRequest approvals require the authenticated reviewer actor (not a writer credential or spoofed body actor).

work_item_closed_requires_approved_review · WorkItem.status -> closed

Work items cannot be closed until an approved ReviewRequest reviews them.

← all kits Quickstart →