@orderful/droid 0.45.0 → 0.45.1

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "droid",
       "description": "Core droid meta-skill for update awareness, tool discovery, and usage help. Checks for updates, helps users find tools, and answers 'how do I...' questions about droid workflows.",
-      "version": "0.7.0",
+      "version": "0.7.1",
       "source": {
         "source": "github",
         "repo": "orderful/droid",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "AI-powered development tools for Claude Code",
   "author": {
     "name": "Orderful",
@@ -22,6 +22,7 @@
     "./src/tools/comments/skills/comments/SKILL.md",
     "./src/tools/droid/skills/droid/SKILL.md",
     "./src/tools/droid/skills/droid-bootstrap/SKILL.md",
+    "./src/tools/edi-schema/skills/edi-schema/SKILL.md",
     "./src/tools/meeting/skills/meeting/SKILL.md",
     "./src/tools/plan/skills/plan/SKILL.md",
     "./src/tools/project/skills/project/SKILL.md",
@@ -38,6 +39,7 @@
     "./src/tools/codex/commands/codex.md",
     "./src/tools/comments/commands/comments.md",
     "./src/tools/droid/commands/setup.md",
+    "./src/tools/edi-schema/commands/edi-schema.md",
     "./src/tools/meeting/commands/meeting.md",
     "./src/tools/plan/commands/plan.md",
     "./src/tools/project/commands/project.md",
@@ -52,6 +54,7 @@
     "./src/tools/code-review/agents/error-handling-reviewer.md",
     "./src/tools/code-review/agents/test-coverage-analyzer.md",
     "./src/tools/code-review/agents/type-reviewer.md",
-    "./src/tools/codex/agents/codex-document-processor.md"
+    "./src/tools/codex/agents/codex-document-processor.md",
+    "./src/tools/edi-schema/agents/edi-schema-agent.md"
   ]
 }

package/.github/workflows/claude-issue-agent.yml

@@ -148,7 +148,6 @@ jobs:
         id: implement
         uses: anthropics/claude-code-action@v1
         with:
-          github_token: ${{ github.token }}
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
           track_progress: true
 

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @orderful/droid
 
+## 0.45.1
+
+### Patch Changes
+
+- [#289](https://github.com/Orderful/droid/pull/289) [`f6e43e5`](https://github.com/Orderful/droid/commit/f6e43e52069e53cb8c4000455e46b04ddd515ea8) Thanks [@claude](https://github.com/apps/claude)! - droid: add alwaysApply: true to droid-bootstrap and droid skills so update awareness and tool discovery load every session
+
+- [#291](https://github.com/Orderful/droid/pull/291) [`b5819c2`](https://github.com/Orderful/droid/commit/b5819c254dabd51bb1e85e423e3163d057d502e3) Thanks [@frytyler](https://github.com/frytyler)! - add new `edi-schema` tool with skill, command, and specialized sub-agent for querying X12/EDIFACT schemas using targeted extraction strategies
+
 ## 0.45.0
 
 ### Minor Changes

package/dist/tools/droid/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Core droid meta-skill for update awareness, tool discovery, and usage help. Checks for updates, helps users find tools, and answers 'how do I...' questions about droid workflows.",
   "author": {
     "name": "Orderful",

package/dist/tools/droid/TOOL.yaml

@@ -1,6 +1,6 @@
 name: droid
 description: "Core droid meta-skill for update awareness, tool discovery, and usage help. Checks for updates, helps users find tools, and answers 'how do I...' questions about droid workflows."
-version: 0.7.0
+version: 0.7.1
 status: beta
 
 # System tool - always stays current regardless of auto-update settings

package/dist/tools/droid/skills/droid/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: droid
 description: "Core droid meta-skill for updates, tool discovery, usage help, and skill overrides. Use when checking for droid updates, discovering available tools, answering 'how do I...' questions about droid workflows, or customizing skill behaviour. User prompts like 'any droid updates?', 'what tools do I have?', 'what tools do you have?', 'remind me what tools you have', 'hey droid what can you do', 'how do I add context?', 'remind me how to use codex', 'what's the best way to start a session?', 'customize brain search', 'create an override for brain'."
+alwaysApply: true
 allowed-tools: [Bash, Read, Write]
 ---
 

package/dist/tools/droid/skills/droid-bootstrap/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: droid-bootstrap
 description: "Lightweight droid bootstrap for update awareness. Checks for droid updates once per session."
+alwaysApply: true
 allowed-tools: [Bash]
 ---
 

package/dist/tools/edi-schema/.claude-plugin/plugin.json

@@ -0,0 +1,25 @@
+{
+  "name": "droid-edi-schema",
+  "version": "0.1.0",
+  "description": "Query EDI schemas without context overhead. Uses a sub-agent to inspect large schema and code-list files, then returns concise results.",
+  "author": {
+    "name": "Orderful",
+    "url": "https://github.com/orderful"
+  },
+  "repository": "https://github.com/orderful/droid",
+  "license": "MIT",
+  "keywords": [
+    "droid",
+    "ai",
+    "edi-schema"
+  ],
+  "skills": [
+    "./skills/edi-schema/SKILL.md"
+  ],
+  "commands": [
+    "./commands/edi-schema.md"
+  ],
+  "agents": [
+    "./agents/edi-schema-agent.md"
+  ]
+}

package/dist/tools/edi-schema/TOOL.yaml

@@ -0,0 +1,29 @@
+name: edi-schema
+description: "Query EDI schemas without context overhead. Uses a sub-agent to inspect large schema and code-list files, then returns concise results."
+version: 0.1.0
+status: beta
+
+includes:
+  skills:
+    - name: edi-schema
+      required: true
+  commands:
+    - name: edi-schema
+      is_alias: false
+  agents:
+    - edi-schema-agent
+
+dependencies: []
+
+prerequisites:
+  - name: jq
+    description: JSON query tool used for targeted schema extraction
+    check: "jq --version"
+    install_hint: "brew install jq"
+
+config_schema:
+  schemas_dir:
+    type: string
+    description: "Optional absolute path to a repository containing libs/schemas/. If empty, auto-detect from current workspace."
+    required: false
+    default: ""

package/dist/tools/edi-schema/agents/edi-schema-agent.md

@@ -0,0 +1,97 @@
+---
+name: edi-schema-agent
+description: "Specialized EDI schema query agent. Uses jq and targeted reads to extract precise schema details with minimal output."
+tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash
+color: blue
+---
+
+You are an EDI schema analysis agent. Your job is to query large schema files and return concise, accurate findings.
+
+## Inputs
+
+You will receive:
+
+1. `schemasRoot`: Absolute repo path containing `libs/schemas/src/lib/data`
+2. `mode`: One of `field-search`, `segments`, `loops`, `codes`, `versions`, `types`
+3. `transactionType`: Full or short transaction type identifier
+4. `schemaFile` (optional): Resolved schema file path for schema-specific modes
+5. `query` (optional): Search text for `field-search`
+6. `elementId` (optional): Element identifier for `codes`
+
+## Rules
+
+- Prioritize correctness over broad output.
+- Never output full JSON blobs.
+- Keep returned content compact and actionable.
+- Prefer jq for extraction. If jq is missing, use `rg` + targeted reads.
+
+## Query Strategies
+
+### `field-search`
+
+Run exact identifier and title-first queries before fuzzy search:
+
+```bash
+jq '.. | objects | select(.elementIdentifier? == $id)' --arg id "{query}" "{schemaFile}"
+jq '.. | objects | select(.title? == $title)' --arg title "{query}" "{schemaFile}"
+jq '.. | objects | select(.title? | test($q; "i"))' --arg q "{query}" "{schemaFile}"
+```
+
+Return top matches including:
+
+- `elementIdentifier` (if present)
+- `title`
+- `schemaType`
+- `X12Requirement` / relevant requirement field
+- a concise path hint when derivable
+
+### `segments`
+
+```bash
+jq '[.. | objects | select(.schemaType? == "segmentInstance") | {title, requirement: .X12Requirement}] | unique' "{schemaFile}"
+```
+
+Return deduplicated segment names and requirement info.
+
+### `loops`
+
+```bash
+jq '[.. | objects | select(.schemaType? | test("loop")) | {title, schemaType}]' "{schemaFile}"
+```
+
+Return loop hierarchy summary. Include parent-child nesting hints if visible.
+
+### `codes`
+
+Find likely code-list file (for example `x12_004010_codeList.json`), then:
+
+```bash
+jq --arg id "{elementId}" '.[$id]' "{codeListFile}"
+```
+
+Return code values and descriptions. If no entry exists, return "not found" and suggest checking identifier/version.
+
+### `versions`
+
+List available schema filenames matching type in x12 + edifact directories, then normalize to type/version list.
+
+### `types`
+
+Read `transactionTypes.json` and return a concise sorted list (or filtered list if query provided).
+
+## Output Format
+
+Respond in markdown with this structure:
+
+1. `Resolved:` line (type/version and file used)
+2. `Results:` compact bullets or table
+3. `Notes:` any ambiguity, fallbacks, or missing data
+
+If no match:
+
+- state that clearly
+- provide 2-5 nearest alternatives when possible

package/dist/tools/edi-schema/commands/edi-schema.md

@@ -0,0 +1,33 @@
+---
+name: edi-schema
+description: "Query EDI schemas (X12/EDIFACT) without context blowup. Find fields, segments, loops, and code-list values."
+argument-hint: "{transactionType|types|versions {transactionType}} [{query|--segments|--loops|--codes {elementId}}]"
+---
+
+# /edi-schema
+
+**User invoked:** `/edi-schema $ARGUMENTS`
+
+**Your task:** Invoke the **edi-schema skill** with these arguments.
+
+## Examples
+
+- `/edi-schema 944_004010 freeFormDescription`
+- `/edi-schema 850 --segments`
+- `/edi-schema 856_004010 --loops`
+- `/edi-schema 850 --codes BEG01`
+- `/edi-schema types`
+- `/edi-schema versions 850`
+
+## Quick Reference
+
+```bash
+/edi-schema {transactionType} {query}     # Search fields/elements
+/edi-schema {transactionType} --segments  # List segment set
+/edi-schema {transactionType} --loops     # Show loop structure
+/edi-schema {transactionType} --codes ID  # Code-list values for element
+/edi-schema types                         # List transaction types
+/edi-schema versions {transactionType}    # List available versions
+```
+
+See the **edi-schema skill** for full behaviour and resolution rules.

package/dist/tools/edi-schema/skills/edi-schema/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: edi-schema
+description: "Query EDI schemas without consuming parent context. Use when finding fields, loops, segments, requirements, or code-list values for X12/EDIFACT transaction types. User prompts like '/edi-schema 944_004010 freeFormDescription' or '/edi-schema 850 --codes BEG01'."
+argument-hint: "{transactionType|types|versions {transactionType}} [{query|--segments|--loops|--codes {elementId}}]"
+allowed-tools: [Read, Glob, Grep, Bash, Task]
+---
+
+# EDI Schema Skill
+
+Query EDI schemas through a sub-agent so large schema JSON files never enter parent context.
+
+## Commands
+
+```bash
+/edi-schema {transactionType} {query}
+/edi-schema {transactionType} --segments
+/edi-schema {transactionType} --loops
+/edi-schema {transactionType} --codes {elementId}
+/edi-schema types
+/edi-schema versions {transactionType}
+```
+
+## Input Rules
+
+- `transactionType` accepts either full form (`850_004010`, `ORDERS_D96A`) or short form (`850`, `ORDERS`).
+- If short form is used, resolve to the most common version and state which version was selected.
+- If multiple plausible versions exist and no safe default is clear, show options and ask user to pick.
+
+## Data Sources
+
+Expected paths in the target schemas repo:
+
+- `libs/schemas/src/lib/data/transactionSchemas/x12/`
+- `libs/schemas/src/lib/data/transactionSchemas/edifact/`
+- `libs/schemas/src/lib/data/codeLists/`
+- `libs/schemas/src/lib/data/transactionTypes.json`
+
+## Procedure
+
+### 1. Resolve schemas root
+
+1. Check `droid config --get tools.edi-schema.schemas_dir`.
+2. If configured and valid, use it.
+3. Otherwise auto-detect from current workspace by finding `libs/schemas/src/lib/data/`.
+4. If not found, ask user for the repo path or suggest setting `tools.edi-schema.schemas_dir`.
+
+### 2. Route command
+
+- `types`:
+  - List transaction types from `transactionTypes.json` (type + description where available).
+- `versions {transactionType}`:
+  - List matching schema versions from x12/edifact schema filenames.
+- `{transactionType} --segments`:
+  - Ask sub-agent for unique segment list and requirement indicators.
+- `{transactionType} --loops`:
+  - Ask sub-agent for loop hierarchy.
+- `{transactionType} --codes {elementId}`:
+  - Ask sub-agent for code-list values for the requested element ID.
+- `{transactionType} {query}`:
+  - Ask sub-agent to search by identifier/title/business term and return best matches.
+
+### 3. Sub-agent handoff
+
+Use `edi-schema-agent` for all schema/content queries. Pass:
+
+- Resolved schemas root
+- Resolved schema file path + transaction type/version
+- Query mode (`field-search`, `segments`, `loops`, `codes`, `versions`, `types`)
+- User input (`query`, `elementId`)
+
+### 4. Response format
+
+Keep responses compact and structured:
+
+- Header with resolved schema (`850_004010`, etc.)
+- Result table or bullets with identifiers and titles
+- Requirement/type constraints where relevant
+- Path hints (loop/segment path) when available
+- Clear next step if no matches
+
+## Behaviour Rules
+
+- Never dump the entire schema JSON.
+- Prefer exact identifier match first (for example `BEG01`) before fuzzy title matching.
+- When no exact match, return top fuzzy matches with confidence notes.
+- If jq is unavailable, fall back to `rg`/targeted reads and state that fallback was used.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orderful/droid",
-  "version": "0.45.0",
+  "version": "0.45.1",
   "description": "AI workflow toolkit for sharing skills, commands, and agents across the team",
   "type": "module",
   "bin": {

package/src/tools/droid/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Core droid meta-skill for update awareness, tool discovery, and usage help. Checks for updates, helps users find tools, and answers 'how do I...' questions about droid workflows.",
   "author": {
     "name": "Orderful",

package/src/tools/droid/TOOL.yaml

@@ -1,6 +1,6 @@
 name: droid
 description: "Core droid meta-skill for update awareness, tool discovery, and usage help. Checks for updates, helps users find tools, and answers 'how do I...' questions about droid workflows."
-version: 0.7.0
+version: 0.7.1
 status: beta
 
 # System tool - always stays current regardless of auto-update settings

package/src/tools/droid/skills/droid/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: droid
 description: "Core droid meta-skill for updates, tool discovery, usage help, and skill overrides. Use when checking for droid updates, discovering available tools, answering 'how do I...' questions about droid workflows, or customizing skill behaviour. User prompts like 'any droid updates?', 'what tools do I have?', 'what tools do you have?', 'remind me what tools you have', 'hey droid what can you do', 'how do I add context?', 'remind me how to use codex', 'what's the best way to start a session?', 'customize brain search', 'create an override for brain'."
+alwaysApply: true
 allowed-tools: [Bash, Read, Write]
 ---
 

package/src/tools/droid/skills/droid-bootstrap/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: droid-bootstrap
 description: "Lightweight droid bootstrap for update awareness. Checks for droid updates once per session."
+alwaysApply: true
 allowed-tools: [Bash]
 ---
 

package/src/tools/edi-schema/.claude-plugin/plugin.json

@@ -0,0 +1,25 @@
+{
+  "name": "droid-edi-schema",
+  "version": "0.1.0",
+  "description": "Query EDI schemas without context overhead. Uses a sub-agent to inspect large schema and code-list files, then returns concise results.",
+  "author": {
+    "name": "Orderful",
+    "url": "https://github.com/orderful"
+  },
+  "repository": "https://github.com/orderful/droid",
+  "license": "MIT",
+  "keywords": [
+    "droid",
+    "ai",
+    "edi-schema"
+  ],
+  "skills": [
+    "./skills/edi-schema/SKILL.md"
+  ],
+  "commands": [
+    "./commands/edi-schema.md"
+  ],
+  "agents": [
+    "./agents/edi-schema-agent.md"
+  ]
+}

package/src/tools/edi-schema/TOOL.yaml

@@ -0,0 +1,29 @@
+name: edi-schema
+description: "Query EDI schemas without context overhead. Uses a sub-agent to inspect large schema and code-list files, then returns concise results."
+version: 0.1.0
+status: beta
+
+includes:
+  skills:
+    - name: edi-schema
+      required: true
+  commands:
+    - name: edi-schema
+      is_alias: false
+  agents:
+    - edi-schema-agent
+
+dependencies: []
+
+prerequisites:
+  - name: jq
+    description: JSON query tool used for targeted schema extraction
+    check: "jq --version"
+    install_hint: "brew install jq"
+
+config_schema:
+  schemas_dir:
+    type: string
+    description: "Optional absolute path to a repository containing libs/schemas/. If empty, auto-detect from current workspace."
+    required: false
+    default: ""

package/src/tools/edi-schema/agents/edi-schema-agent.md

@@ -0,0 +1,97 @@
+---
+name: edi-schema-agent
+description: "Specialized EDI schema query agent. Uses jq and targeted reads to extract precise schema details with minimal output."
+tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash
+color: blue
+---
+
+You are an EDI schema analysis agent. Your job is to query large schema files and return concise, accurate findings.
+
+## Inputs
+
+You will receive:
+
+1. `schemasRoot`: Absolute repo path containing `libs/schemas/src/lib/data`
+2. `mode`: One of `field-search`, `segments`, `loops`, `codes`, `versions`, `types`
+3. `transactionType`: Full or short transaction type identifier
+4. `schemaFile` (optional): Resolved schema file path for schema-specific modes
+5. `query` (optional): Search text for `field-search`
+6. `elementId` (optional): Element identifier for `codes`
+
+## Rules
+
+- Prioritize correctness over broad output.
+- Never output full JSON blobs.
+- Keep returned content compact and actionable.
+- Prefer jq for extraction. If jq is missing, use `rg` + targeted reads.
+
+## Query Strategies
+
+### `field-search`
+
+Run exact identifier and title-first queries before fuzzy search:
+
+```bash
+jq '.. | objects | select(.elementIdentifier? == $id)' --arg id "{query}" "{schemaFile}"
+jq '.. | objects | select(.title? == $title)' --arg title "{query}" "{schemaFile}"
+jq '.. | objects | select(.title? | test($q; "i"))' --arg q "{query}" "{schemaFile}"
+```
+
+Return top matches including:
+
+- `elementIdentifier` (if present)
+- `title`
+- `schemaType`
+- `X12Requirement` / relevant requirement field
+- a concise path hint when derivable
+
+### `segments`
+
+```bash
+jq '[.. | objects | select(.schemaType? == "segmentInstance") | {title, requirement: .X12Requirement}] | unique' "{schemaFile}"
+```
+
+Return deduplicated segment names and requirement info.
+
+### `loops`
+
+```bash
+jq '[.. | objects | select(.schemaType? | test("loop")) | {title, schemaType}]' "{schemaFile}"
+```
+
+Return loop hierarchy summary. Include parent-child nesting hints if visible.
+
+### `codes`
+
+Find likely code-list file (for example `x12_004010_codeList.json`), then:
+
+```bash
+jq --arg id "{elementId}" '.[$id]' "{codeListFile}"
+```
+
+Return code values and descriptions. If no entry exists, return "not found" and suggest checking identifier/version.
+
+### `versions`
+
+List available schema filenames matching type in x12 + edifact directories, then normalize to type/version list.
+
+### `types`
+
+Read `transactionTypes.json` and return a concise sorted list (or filtered list if query provided).
+
+## Output Format
+
+Respond in markdown with this structure:
+
+1. `Resolved:` line (type/version and file used)
+2. `Results:` compact bullets or table
+3. `Notes:` any ambiguity, fallbacks, or missing data
+
+If no match:
+
+- state that clearly
+- provide 2-5 nearest alternatives when possible

package/src/tools/edi-schema/commands/edi-schema.md

@@ -0,0 +1,33 @@
+---
+name: edi-schema
+description: "Query EDI schemas (X12/EDIFACT) without context blowup. Find fields, segments, loops, and code-list values."
+argument-hint: "{transactionType|types|versions {transactionType}} [{query|--segments|--loops|--codes {elementId}}]"
+---
+
+# /edi-schema
+
+**User invoked:** `/edi-schema $ARGUMENTS`
+
+**Your task:** Invoke the **edi-schema skill** with these arguments.
+
+## Examples
+
+- `/edi-schema 944_004010 freeFormDescription`
+- `/edi-schema 850 --segments`
+- `/edi-schema 856_004010 --loops`
+- `/edi-schema 850 --codes BEG01`
+- `/edi-schema types`
+- `/edi-schema versions 850`
+
+## Quick Reference
+
+```bash
+/edi-schema {transactionType} {query}     # Search fields/elements
+/edi-schema {transactionType} --segments  # List segment set
+/edi-schema {transactionType} --loops     # Show loop structure
+/edi-schema {transactionType} --codes ID  # Code-list values for element
+/edi-schema types                         # List transaction types
+/edi-schema versions {transactionType}    # List available versions
+```
+
+See the **edi-schema skill** for full behaviour and resolution rules.

package/src/tools/edi-schema/skills/edi-schema/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: edi-schema
+description: "Query EDI schemas without consuming parent context. Use when finding fields, loops, segments, requirements, or code-list values for X12/EDIFACT transaction types. User prompts like '/edi-schema 944_004010 freeFormDescription' or '/edi-schema 850 --codes BEG01'."
+argument-hint: "{transactionType|types|versions {transactionType}} [{query|--segments|--loops|--codes {elementId}}]"
+allowed-tools: [Read, Glob, Grep, Bash, Task]
+---
+
+# EDI Schema Skill
+
+Query EDI schemas through a sub-agent so large schema JSON files never enter parent context.
+
+## Commands
+
+```bash
+/edi-schema {transactionType} {query}
+/edi-schema {transactionType} --segments
+/edi-schema {transactionType} --loops
+/edi-schema {transactionType} --codes {elementId}
+/edi-schema types
+/edi-schema versions {transactionType}
+```
+
+## Input Rules
+
+- `transactionType` accepts either full form (`850_004010`, `ORDERS_D96A`) or short form (`850`, `ORDERS`).
+- If short form is used, resolve to the most common version and state which version was selected.
+- If multiple plausible versions exist and no safe default is clear, show options and ask user to pick.
+
+## Data Sources
+
+Expected paths in the target schemas repo:
+
+- `libs/schemas/src/lib/data/transactionSchemas/x12/`
+- `libs/schemas/src/lib/data/transactionSchemas/edifact/`
+- `libs/schemas/src/lib/data/codeLists/`
+- `libs/schemas/src/lib/data/transactionTypes.json`
+
+## Procedure
+
+### 1. Resolve schemas root
+
+1. Check `droid config --get tools.edi-schema.schemas_dir`.
+2. If configured and valid, use it.
+3. Otherwise auto-detect from current workspace by finding `libs/schemas/src/lib/data/`.
+4. If not found, ask user for the repo path or suggest setting `tools.edi-schema.schemas_dir`.
+
+### 2. Route command
+
+- `types`:
+  - List transaction types from `transactionTypes.json` (type + description where available).
+- `versions {transactionType}`:
+  - List matching schema versions from x12/edifact schema filenames.
+- `{transactionType} --segments`:
+  - Ask sub-agent for unique segment list and requirement indicators.
+- `{transactionType} --loops`:
+  - Ask sub-agent for loop hierarchy.
+- `{transactionType} --codes {elementId}`:
+  - Ask sub-agent for code-list values for the requested element ID.
+- `{transactionType} {query}`:
+  - Ask sub-agent to search by identifier/title/business term and return best matches.
+
+### 3. Sub-agent handoff
+
+Use `edi-schema-agent` for all schema/content queries. Pass:
+
+- Resolved schemas root
+- Resolved schema file path + transaction type/version
+- Query mode (`field-search`, `segments`, `loops`, `codes`, `versions`, `types`)
+- User input (`query`, `elementId`)
+
+### 4. Response format
+
+Keep responses compact and structured:
+
+- Header with resolved schema (`850_004010`, etc.)
+- Result table or bullets with identifiers and titles
+- Requirement/type constraints where relevant
+- Path hints (loop/segment path) when available
+- Clear next step if no matches
+
+## Behaviour Rules
+
+- Never dump the entire schema JSON.
+- Prefer exact identifier match first (for example `BEG01`) before fuzzy title matching.
+- When no exact match, return top fuzzy matches with confidence notes.
+- If jq is unavailable, fall back to `rg`/targeted reads and state that fallback was used.