Docs Create¶
Create a new unit in the knowledge store. Writes to the appropriate JSON file, updates parent children lists, and validates DAG integrity.
MCP name: docs_create
Category: context
Mutates state (retry policy: manual)
Parameters¶
| Name | Type | Required | Description |
|---|---|---|---|
aliases |
str |
No | Comma-separated search aliases |
capabilities |
str |
No | (directions) Comma-separated MCP capability paths |
capability_name |
str |
No | (capability kind) MCP dispatch name, e.g. 'task_read'. |
category |
str |
No | (capability kind) Registry category, e.g. 'tasks'. |
command |
str |
No | (directions/workflow) Slash command name |
consent_required |
bool |
No | (capability kind) Whether the capability is consent-gated. |
content_full |
str |
No | Full content text (newlines preserved) |
content_summary |
str |
No | Short summary |
description |
str |
Yes | One-line summary |
dev_notes |
str |
No | Development-facing notes surfaced only in dev mode (set via dev_mode_toggle). Use for architectural constraints, non-obvious dependencies, and hard-won lessons future dev agents could clobber. |
entry_points |
str |
No | (system kind) Comma-separated dotted module paths that implement this system, for navigation. |
kind |
str |
Yes | Unit type: directions, capability, workflow, system, service, integration, reference, concept |
mutates_state |
bool |
No | (capability kind) Whether the capability modifies state. |
name |
str |
Yes | Human-readable name |
op |
str |
No | (capability kind) op. |
parameters |
str |
No | (capability kind) Parameter schema as a JSON string: {name: {type, description, required}}. |
parents |
str |
No | Comma-separated parent paths |
path |
str |
Yes | Unique path ID (e.g. 'tasks/my-directions') |
requires |
str |
No | Comma-separated tool/component IDs the unit needs (e.g. 'obsidian,hindsight'). |
retry_policy |
str |
No | (capability kind) 'manual' |
schema_version |
str |
No | (capability kind) Declaration format version, e.g. 'wb-capability/v1'. |
tags |
str |
No | Comma-separated search tags |
trigger |
str |
No | (directions) When to use this unit |
workflow |
str |
No | (directions) Linked workflow path |