Skip to content

Improve --json catalog for LLM consumption#23

Merged
gmoon merged 1 commit intomainfrom
improve-json-catalog-for-llms
Mar 24, 2026
Merged

Improve --json catalog for LLM consumption#23
gmoon merged 1 commit intomainfrom
improve-json-catalog-for-llms

Conversation

@gmoon
Copy link
Contributor

@gmoon gmoon commented Mar 24, 2026

Summary

  • Add concepts block with node types, edge semantics, versioning model, and ID conventions so LLMs understand the domain model before using commands
  • Add workflows section with 4 task-oriented patterns (capture_decision, check_health, respond_to_drift, record_gap)
  • Improve all command descriptions with "when to use" guidance
  • Add output_schema_hint per command so LLMs know response shapes without speculative execution
  • Convert examples from bare strings to {command, explanation} objects
  • Add related_commands for navigation between commands
  • 6 new tests validating concepts, workflows, structured examples, schema hints, related commands; edge type test validates against canonical EDGE_TYPES constant

Closes #22

Test plan

  • make pre-commit passes (fmt, clippy, tests)
  • cargo run -- --json | jq .concepts returns node types and edge semantics
  • cargo run -- --json | jq .workflows returns 4 workflows
  • cargo run -- --json | jq '.commands[0].examples[0].command' returns structured example
  • All 9 catalog tests pass including 6 new ones

🤖 Generated with Claude Code

Add concepts block (node types, edge semantics, versioning, ID conventions),
workflows section (capture_decision, check_health, respond_to_drift, record_gap),
structured examples with explanations, output_schema_hint per command,
related_commands, and richer "when to use" descriptions.

Closes #22

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@gmoon gmoon merged commit 9f2092a into main Mar 24, 2026
5 checks 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.

Improve --json help output for LLM consumption

1 participant