Skip to content

fix(minimal-template): remove phantom memory search / route CLI commands from docs (#48)#52

Open
ruvnet wants to merge 1 commit into
mainfrom
fix/issue-48-minimal-docs
Open

fix(minimal-template): remove phantom memory search / route CLI commands from docs (#48)#52
ruvnet wants to merge 1 commit into
mainfrom
fix/issue-48-minimal-docs

Conversation

@ruvnet

@ruvnet ruvnet commented Jun 25, 2026

Copy link
Copy Markdown
Owner

Fixes #48 (thanks @Tovli for the precise report).

The minimal template's CLAUDE.md.tmpl documented two CLI commands — memory search <query> and route <task> — that bin/cli.js.tmpl never implements; both fall through to the default: Unknown command branch (exit 2). An agent reading the generated CLAUDE.md would confidently invoke commands that always error.

As the issue notes, the published @metaharness/kernel surface doesn't make these turnkey (memory exposes rankWithDecay/distillTrigger re-rankers, not a string→embed→search; routing is a library subsystem). So the honest fix is docs↔code fidelity, not faking the commands:

  • Removed the two phantom command rows; the table now lists exactly what the CLI implements (init, doctor, --version, --help) — matching cli.js's own --help text.
  • Reworded the behavioral-rules line so it no longer implies memory/routing are turnkey — it now says the kernel ships them as library primitives, call them from your own code.

Scope: one file, templates/minimal/CLAUDE.md.tmpl. No code/behavior change. Verified (per the issue) that no template implements a memory/route dispatch and only the minimal docs made the claim.

🤖 Generated with claude-flow

… / `route` CLI commands (#48)

The minimal template's CLAUDE.md.tmpl advertised `memory search` and `route`
commands that bin/cli.js.tmpl never implements (they fall through to the Unknown-
command default, exit 2). The kernel exposes memory-ranking/routing as library
primitives, not turnkey CLI commands. Fixed the docs to list only the commands
the CLI actually implements (init, doctor, --version, --help) and corrected the
behavioral-rules line that reinforced the false promise.

Closes #48

Co-Authored-By: claude-flow <ruv@ruv.net>
ruvnet added a commit that referenced this pull request Jun 25, 2026
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.

bug: minimal template CLAUDE.md documents memory search / route commands that bin/cli.js never implements

1 participant