KB Edit Skill — Integrity-First Document Operations

When editing any file in an sbdb-managed knowledge base you MUST maintain integrity throughout. Every edit must leave the KB in a clean state.

In v2 each document is a pair: <id>.md (content + frontmatter) and a sibling <id>.yaml integrity sidecar. Both are committed to git. There is no data/ directory and no aggregate index.

Before any edit

1. Check this is an sbdb project:

test -f .sbdb.toml && echo "sbdb project" || echo "not managed by sbdb"

2. Determine if the target file is schema-managed:

sbdb schema list --format json