@automaton-labs/aib 0.0.7 → 0.0.8

package/dist/help/dsl/docs/rules.md

@@ -0,0 +1,26 @@
+# AIB Rules
+
+Set the command timeout to 5 minutes for AIB requests.
+
+Use `aib rg -- <args>` instead of `rg <args>`.
+Do not use AIB aliases in `aib rg` arguments.
+
+Use aliases from `aib config aliases` as the normal path form for AIB requests.
+Exception: `aib rg` takes real shell paths.
+If AIB maps a full path to an alias in output, use the alias in the next request.
+
+Use matching recipes when their trigger appears during work.
+Do not treat `aib help recipes` as documentation only.
+
+Use `aib qr` for compact text reads: ts, js, cmd, sh, json, log, txt, etc.
+Use AIB path aliases when available.
+Batch paths and combine windows for the same file instead of repeating the path.
+Use `s=A:B,C:D,E` for inclusive slices.
+Use `r=A:B,C:D,E` for start+line-count ranges; a single start like `E` uses default 80 lines.
+Avoid `all` for files whose size/content is unknown; it can dump unnecessary context.
+
+Example:
+aib qr @svc/users.ts s=3:42,66:84,92 @scripts/a.txt h=80 @scripts/b.py r=300:50,500 .prettierrc all
+
+When AIB output shows `// aib-signal`, adjust the next request or workflow.
+Do not repeat the same inefficient pattern unchanged.