Skip to content

Add /ask to wiki-operator (grounded Q&A over the vault)#26

Merged
Hefrock merged 1 commit into
mainfrom
claude/festive-cori-wd84yr
Jul 14, 2026
Merged

Add /ask to wiki-operator (grounded Q&A over the vault)#26
Hefrock merged 1 commit into
mainfrom
claude/festive-cori-wd84yr

Conversation

@Hefrock

@Hefrock Hefrock commented Jul 14, 2026

Copy link
Copy Markdown
Owner

Implements /ask — the last identified gap in the wiki lifecycle (Retrieve). No new MCP capability needed; this closes a behavioral gap, not a plumbing one.

Why this one, after rename_note and ingestion got retracted

wiki-operator's own SKILL.md description has listed "what do I know about Y" as a trigger phrase since it was written — with no command behind it. That's a documented promise with no algorithm, which is a real, evidenced gap (unlike the other two, which turned out to already be covered by existing primitives + judgment).

What /ask does

  • search_notes + read_note, scoped to Knowledge/ and Sources/ first (the vetted material); Journal/Daily/ only as a flagged last resort, explicitly marked as unprocessed
  • optional one-hop list_links expansion to pull in tightly connected notes
  • every claim in the answer carries an inline [[citation]]; draft/low-confidence sources are labeled as such, never presented with false authority
  • never blends vault content with general knowledge silently — an unanswerable question is stated plainly; the user is asked before any general-knowledge fallback, which is always clearly labeled as outside the vault

The new artifact — Maps/_ask_log.md

Unanswered queries are appended here (template: assets/ask-log.md). This makes wiki-governor's Phase 4 gap-queue input real for the first time — previously it referenced "failed /ask queries" vaguely, since /ask didn't exist. Governor's Phase 4 now cites the file explicitly.

Single-writer discipline, documented in knowledge-os/architecture.md: /ask appends only, wiki-governor reads only — the same one-owner-per-artifact pattern already used for MCP writes (backup-before-overwrite, atomic rename).

Also fixed while in these files

  • README's wiki-system prose still only listed 3 wiki skills — wiki-governor was missing (an oversight from the prior PR). Corrected.

Files

  • skills/wiki-operator/SKILL.md/ask command, updated description/trigger list, vault-structure diagram, output discipline
  • skills/wiki-operator/assets/ask-log.md — new template
  • skills/wiki-governor/SKILL.md — Phase 4 now cites _ask_log.md explicitly
  • knowledge-os/architecture.md — new "Governance artifacts" section documenting the single-writer pattern
  • README.md — command list + wiki-system prose fix

Docs-only change (no runnable code), so nothing new for CI to execute.

🤖 Generated with Claude Code


Generated by Claude Code

Closes the retrieval gap: wiki-operator's own SKILL.md description has
promised "what do I know about Y" as a trigger phrase since it was written,
with no command behind it. /ask fulfills that promise.

- search_notes + read_note (Knowledge/, Sources/ first; Journal/ only as a
  flagged last resort) + optional one-hop list_links expansion
- every claim carries an inline [[citation]]; draft/low-confidence sources
  are labeled as such, never presented with false authority
- never blends vault content with general knowledge silently — an
  unanswerable question is stated plainly, logged, and only answered from
  general knowledge if the user opts in
- unanswered queries append to the new Maps/_ask_log.md (assets/ask-log.md
  template), which wiki-governor's Phase 4 now reads explicitly instead of
  the previously vague "failed /ask queries" reference

knowledge-os/architecture.md: documents the single-writer discipline
between _ask_log.md (operator writes, governor reads) and _gaps.md
(governor writes) — the same one-owner-per-artifact pattern already used
for MCP writes (backup-before-overwrite, atomic rename).

README: /ask added to wiki-operator's command list; wiki system prose
corrected to include wiki-governor (missed in the prior PR).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013H1oBwjtpzDLGreGTTjoP7
@Hefrock
Hefrock merged commit 8300e31 into main Jul 14, 2026
4 checks passed
@Hefrock
Hefrock deleted the claude/festive-cori-wd84yr branch July 14, 2026 17:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants