Build a compact context bundle around a card from direct relations, active conventions, open incidents and active project context. Prefer this over reading records one by one before working on a card.

Move a closed card to the canonical archive directory. Only done and discarded cards can be archived; the ID and the file survive, so project_card_reopen undoes this.

Claim a card for an actor, move it to doing and optionally declare the filesystem scope that will be changed. Claim before editing anything the card covers; another actor's claim is refused unless forced.

Create one canonical Work card with a concurrency-safe stable ID. Search first: this mints a new record rather than finding an existing one.

List cards filtered by status, area, type, priority, parent or claim. Use before starting work; use project_search for full-text.

Append one timestamped line under a heading. Cheaper than rewriting the body and safe when two agents write at once.

Patch allowed card metadata using optimistic concurrency. Use expectedRevision whenever the card was read earlier. Declared axes go in changes.axes as { name: value }; an empty value clears one.

Release your claim on a card and move it out of doing. Call when work stops, finished or not.

Move an archived card back out of the archive directory and into a live status. The ID never changes, so every existing reference to it keeps resolving.

Move a card to another protocol status. Moving to doing claims the card for the actor; review means the implementation is finished but unverified, and done requires evidence it ran, not a commit.

Replace the Markdown body of a card under the protocol's lock and revision check. Use project_card_note to append instead.

Create an atomic unreleased changelog fragment and relate it to cards, decisions or other records. One fragment per user-visible change, written when the change lands rather than when the release is cut.

List unreleased change fragments and cut releases, filtered by type, area or visibility.

Patch an unreleased changelog fragment using optimistic concurrency. Only works before a release consumes the fragment; afterwards the text belongs to that release.

Render selected unreleased fragments without mutating the repository. Use to read a release before project_changelog_release makes it permanent.

Consume selected unreleased fragments and create a canonical release record. This moves fragment files into the release directory, so preview first: the fragments stop being separately editable.

Create a managed Markdown document with a stable DOC ID. Without an explicit folder the workspace docs.layout decides where it is written.

List indexed and managed documents, filtered by kind, status or freshness.

Move a managed document to another folder below the managed docs root. The DOC ID never changes; use an empty folder for the root.

Patch a managed document using optimistic concurrency. Indexed repository docs are intentionally read-only through this tool — edit those files directly.

Validate Work, Docs, History, Memory, agent instructions, CI templates and cross-record references. Run before declaring work finished.

Read one canonical project record by stable ID, including body, revision, outgoing references, backlinks and health signals. The revision it returns is what a later write passes as expectedRevision.

Create a typed learning, decision, incident, convention or temporary context record. For knowledge that should change future behaviour — not for narrating what happened this session.

Mark a learning as graduated and link it to the convention, decision or documentation that now carries the durable rule. Create the target record first — graduating points at something that must already exist.

List learnings, decisions, incidents, conventions and context, filtered by collection or lifecycle status.

Patch a durable memory record using optimistic concurrency. To retire one in favour of another use project_memory_supersede, which updates both sides.

Supersede one memory record with another and update both sides atomically. Create the replacement first; neither record is deleted, so the superseded one stays readable and its ID keeps resolving.

Rank actionable cards: unblocked, unclaimed or claimed by you, highest priority first. Answers "what should I do now".

Search cards, documentation, changelog entries, releases and durable memory. Uses deterministic lexical ranking and an injected semantic provider when available.

Return the effective Workfile workspace, schema, enabled modules and mutation mode. Read this first when a vocabulary is project-declared: it reports the areas, axes, document kinds, changelog types and memory collections this project accepts.