ontology-sync

Featured

After a code change, sync the project's ontology vault — read what's already there, identify new capabilities / elements / domains introduced by the change, and write them back via the MCP server (or fall back to the CLI). Use this at the end of any task that introduces a new feature, refactors a module, or renames a unit. Skip when the change is purely a typo, style nudge, or test fixture tweak.

Code & Development 139 stars 21 forks Updated today MIT

Install

View on GitHub

Quality Score: 87/100

Stars 20%
71
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# /ontology-sync — keep the vault in step with the code The vault under `docs/ontology/` (this repo's dogfood) — or the user's own vault when one is selected — is the **shared mental model** between the developer and the AI agent. When code grows or shifts, the vault has to follow, otherwise the graph drifts and stops being a useful map. This skill runs after a unit of code work (new feature, refactor, rename, notable cleanup) and produces the corresponding ontology updates so the human sees the change appear in their workbench. ## When to run **Run when**: - a new user-visible capability landed (login flow, checkout flow, …) - a new concrete element landed (jwt-token, indexeddb-adapter, sigma-canvas, …) - a domain was reshaped (auth → split into auth + session, …) - a slug-level rename happened in code that should mirror in the graph **Skip when**: - the change is a typo, comment tweak, or single-line style nudge - the change is purely test fixture / lint config / docs prose - a revert leaves the existing graph accurate; otherwise inspect its semantic delta ## Workflow The MCP server `ontology-atlas` (the compiled `ontology-atlas-mcp` binary inside the installed app, or `mcp/src/index.js` from a source checkout) is the primary path. Fall back to the source checkout CLI with `node <atlas-checkout>/cli/src/index.mjs add|import|validate ...` if MCP is unavailable in the current session. There is no npm-installed `ontology-atlas` command to assume. ### 1. Read what's alr...

Details

Author
wlsdks
Repository
wlsdks/ontology-atlas
Created
5 months ago
Last Updated
today
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

ontology-bootstrap

Build a trustworthy first ontology from an empty or near-empty ontology-atlas vault using only Atlas MCP evidence. Use when the user asks to analyze a codebase, bootstrap/fill its ontology, extract product meaning from a repository, or when a requested ontology task finds only starter nodes. Separate observed implementation facts from proposed meanings, define and cite every domain/capability, answer competency questions, obtain independent source-hidden qualification and user approval, then write only the exact released plan with batch tools. Route mature vaults with 20+ curated nodes to ontology-sync instead; this is a workflow threshold, never a vault or project node limit.

139 Updated today
wlsdks
AI & Automation Listed

sync-docs

Sync plans, docs, and instruction files after behavior, commands, contracts, or workflows change. Also covers harness-internal consistency after skill, hook, rule, or script changes. Invoked after /test and before /cross-review as the doc-maintainer agent; inline execution is only a dispatch-failure fallback.

6 Updated yesterday
yoshpy-dev
AI & Automation Solid

vault-sync

Use when you need to validate the Meta-Vault's Markdown frontmatter and wiki-link integrity before closing a session or after vault edits. Runs as a hard gate at session-end Phase 1 — blocks close if any `.md` file fails the Zod frontmatter schema or has dangling `[[wiki-links]]`. Supports three modes: `hard` (blocks on errors), `warn` (reports without blocking), `off` (skip). Reads `vault-sync.*` from Session Config; respects per-vault exclude globs from `CLAUDE.md`. Triggers: "vault validation failed at session close", "fix vault frontmatter errors", "check vault wiki-links", "why is session-end blocked by vault-sync". <example>Context: session-end Phase 1 quality gate, vault-sync.enabled=true, vault-sync.mode="hard". user: "/close" assistant: "vault-sync found 2 frontmatter errors in vault/40-learnings/ml-notes.md — missing required `id` field. Fixing before close."</example>

52 Updated 4 days ago
Kanevry