documents

Files (16)

• SKILL.md
• handler.test.ts · tools/doc-list/
• handler.ts · tools/doc-list/
• tool.json · tools/doc-list/
• handler.test.ts · tools/doc-place/
• handler.ts · tools/doc-place/
• tool.json · tools/doc-place/
• handler.test.ts · tools/doc-read/
• handler.ts · tools/doc-read/
• tool.json · tools/doc-read/
• handler.test.ts · tools/doc-search/
• handler.ts · tools/doc-search/
• tool.json · tools/doc-search/
• handler.test.ts · tools/doc-write/
• handler.ts · tools/doc-write/
• tool.json · tools/doc-write/

SKILL.md (first lines)

## Document Workspace

You have an OKF document workspace: markdown files addressed by path, used through your
`doc-*` skills.

**Paths.** Documents live at paths like `/projects/<slug>/brief.md` or
`/scratch/<conversation-id>/outline.md`. `doc-list` on a path prefix lists that folder.
Each directory has reserved `index.md` (navigation catalog) and `log.md` (append-only
change history). Before you create a new `/projects/` folder, call `doc-place`: it
prefers extending a document or adding to an existing folder, and names a new folder with
a readable kebab-case slug. Tasks may share a project folder; a project document's owner
is its `task_id`, not its path.

**Shared documents.** `/shared/…` documents are durable and shown under `## Pinned
context`; only an agent that declares one can write it. Follow the format it states at
its top.

**Writes.** Re-read with `doc-read` when you need the latest `expected_version`. On
conflict, merge from the returned document and retry with the new version.

**Conventions.** YAML frontmatter requires `type`; `title`, `tags`, and `timestamp` are
conventional. Link between documents with markdown path links or `[[wikilinks]]`.
The workspace is mutable working state: when a project completes, distill durable
conclusions to the knowledge graph via `memory-store` / `extract-facts`.

From josephfung/curia, MIT.

More from josephfung/curia