concept_write
Create or update a validated concept from required YAML frontmatter and Markdown body. Optional content hash prevents stale overwrites; returns hash and link/orphan/index findings to fix.
Instructions
Creates or updates a concept from frontmatter (YAML map, type required) and a markdown body. if_match (content hash) gives optimistic concurrency: stale_write if changed. Returns content_hash and structural findings too (links, orphan, index): fix them.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>",
"frontmatter": "<frontmatter>",
"body": "<body>"
},
"name": "concept_write"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| body | Yes | ||
| reason | No | Why (commit trailer) | |
| if_match | No | Optional content hash | |
| frontmatter | Yes | Map; type required |