knowledge-gate
knowledge-gate
Query the Knowledge Vault (.knowledge/vault.db) before planning code changes. The vault contains team-verified Facts and Anti-Patterns that constrain how code should be written.
A UserPromptSubmit hook fires on each user prompt. When the vault has active entries, it reminds you to query before planning. Follow the reminder when the task involves code modifications; ignore it for non-code tasks.
You MUST NOT directly read files in the .knowledge/ directory. All vault access goes through the knowledge-gate CLI.
CLI Path
Resolve the CLI path once at session start in this order:
- Use the hook-provided exact path when the UserPromptSubmit context supplies one.
- Otherwise use
<skill-directory>/scripts/knowledge-gate, where<skill-directory>is the directory containing thisSKILL.md.
This skill-local path works when the skill is copied or symlinked into .agents/skills, .codex/skills, .claude/skills, or a plugin skill directory. Do not assume an agent-specific environment variable or plugin-root layout.
All commands below use <knowledge-gate> as a placeholder for the resolved executable path. Substitute the concrete path directly in the command; do NOT create or execute a shell variable such as $GATE.