Use when adding collaborative markdown, notes, or descriptions to a feature with collab surfaces. Covers parent entities, service entry points, authorization, content storage, and lifecycle.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Use collab surfaces for collaborative markdown within a feature. Each surface
has its own Loro session in sync-service and can exist without a Document row.
The surface is a child resource of an app entity: product names, owners, sharing,
and discovery belong to the parent.
OwnedSurfaceService through the feature's domain port. The owning domain
authorizes callers and chooses the surface id before calling
ensure_owned_surface, owned_surface_markdown, or retire_surface.CollabSurfaceService with an access receipt for the parent. Surface reads,
connection tokens, and deletion derive their permissions from that parent.Check surface_ownership and the parent's access resolution when adding a new
parent type. Parents marked ParentDomain use their domain's creation and
retirement paths; the public API still provides connection tokens. Keep the
trusted OwnedSurfaceService behind domain authorization, with adapters supplied
by the composition root.
collab_surfaces records
the id, parent, initialization state, timestamps, and soft deletion.pending to
ready. The id also names the sync session and must never be recycled.Read the domain ports and parent policy before wiring a consumer. The initiative adapter shows how a feature reuses the service through its own domain port.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Wrap a new backend endpoint in the TypeScript SDK (packages/sdk), or record it as skipped. Use when `just coverage` fails, or after adding an endpoint to a Rust service.
The English summary is being prepared. Showing the original description.
Add or change an in-app feature tour (a view's guided flyover) in the web app. Use when adding a tour to a view, adding or editing tour steps, pointing a step at a new control, or when a step's target needs something opened first.
The English summary is being prepared. Showing the original description.
Post-change checks before handing off. Works out which checks apply from the files changed (directory AGENTS.md Checks sections and matching .agents/rules), runs or verifies each, and reports pass/fail/skipped. Use before saying work is done, before pushing, or when asked to audit or verify a change.
The English summary is being prepared. Showing the original description.
Enforce hexagonal architecture in the Rust backend. Use before modifying crates/ or Rust services, especially inbound axum/tool/listener adapters, domain services/ports, outbound adapters, authorization, permissions, database access, or external clients.
The English summary is being prepared. Showing the original description.
Build a new AI tool end-to-end — Rust implementation, toolset wiring, infra, schema generation, and frontend UI.
The English summary is being prepared. Showing the original description.
Use when building a feature on reusable database storage or UI, such as CRM, or deciding whether it needs a Macro database entity. Covers shared storage, a host-independent database UI and API contract, ownership, authorization, and the _entities naming convention.
The English summary is being prepared. Showing the original description.