@chrisdudek/yg 2.1.0 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/bin.js CHANGED
@@ -68,6 +68,11 @@ Yggdrasil is persistent semantic memory stored in \`.yggdrasil/\`. It maps the r
68
68
 
69
69
  \`\`\`
70
70
  BEFORE reading, researching, planning, OR modifying ANY mapped file:
71
+ 0. Don't know which file or node to start from? If a semantic search
72
+ tool is available, search for your intent \u2014 the graph contains
73
+ responsibility, flow, and aspect files with rich natural-language
74
+ descriptions that match goal-oriented queries. Use the results
75
+ to identify relevant nodes, then proceed to step 1.
71
76
  1. yg owner --file <path>
72
77
  2. Choose the right graph tool for your task:
73
78
  - Understanding how/why it works \u2192 yg build-context --node <owner>
@@ -142,6 +147,7 @@ What matters is the ACTION you are performing, not what instructed it. If the ac
142
147
  | "I'm brainstorming, not implementing" | Brainstorming about mapped code needs graph context |
143
148
  | "I'm only grepping for references" | Grep finds text; yg impact finds structural dependencies. Use both. |
144
149
  | "I'll use the graph later when I modify" | Graph-first means BEFORE reading, not before modifying |
150
+ | "I'll grep the codebase to find where to start" | If semantic search is available, search by intent first \u2014 graph files are designed to match natural-language goals. Then \`yg owner\` on results. |
145
151
 
146
152
  ### Failure States
147
153