Skip to content

docs(prompts): map out the help files for Prime Claude - #200

Merged
ddehilster merged 1 commit into
VisualText:mainfrom
ddehilster:docs/prime-claude-help-map
Jul 31, 2026
Merged

ddehilster merged 1 commit into
VisualText:mainfrom
ddehilster:docs/prime-claude-help-map

Conversation

@ddehilster

Copy link
Copy Markdown
Member

Follow-up to #199. That PR pointed the Prime Claude for NLP++ prompt at {{helpDir}} and named two index pages — enough for Claude to know the help exists, not enough for it to actually use the help without hunting first.

This maps the parts that matter:

  • index.md and vscode/home.md — the two indexes
  • NLP_PP_Stuff/ — the language: rule syntax, element modifiers, zones, actions, functions, variables, operators, tokens
  • VisualText_Basics/ — how an analyzer is assembled: project structure, analyzer sequence, knowledge base, parse trees, standard rule format
  • the one-page-per-builtin convention, with examples (pnname.md, makeconcept.md, dictfindword.md, $text.md, _xWILD.md)

Every one of the 24 pages named in the prompt was checked to exist.

It then tells Claude to learn the language from these pages and keep consulting them — read a function's page before calling it, read the rule-syntax pages before writing a rule, and grep the help for any unfamiliar name instead of inferring behavior from the example analyzers.

{{helpDir}} ships in vscode-nlp 3.11.13 and later; the current extension is 3.12.0.

🤖 Generated with Claude Code

The prompt named {{helpDir}} and two index pages, which told Claude the help
exists but not how it is laid out -- so it still had to go hunting before it
could use any of it.

Maps the parts that matter: index.md and vscode/home.md as the two indexes,
NLP_PP_Stuff/ for the language (rule syntax, element modifiers, zones,
actions, variables, operators, tokens), VisualText_Basics/ for how an
analyzer is assembled, and the one-page-per-builtin convention with examples.
Every page named here was checked to exist.

Follows it with a directive to learn the language from these pages and keep
consulting them -- read a function's page before calling it, the rule-syntax
pages before writing a rule, and grep the help for any unfamiliar name rather
than inferring behavior from the example analyzers.

{{helpDir}} ships in vscode-nlp 3.11.13 and later; current extension is 3.12.0.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@ddehilster
ddehilster merged commit 8d8a573 into VisualText:main Jul 31, 2026
1 check passed
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.

1 participant