[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-nvidia-hsb-ip-def":3,"mdc--xu8wsd-key":34,"related-repo-nvidia-hsb-ip-def":1490,"related-org-nvidia-hsb-ip-def":1596},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":29,"sourceUrl":32,"mdContent":33},"hsb-ip-def","generate and validate HSB macro definitions","Generate, validate, compare, or explain HSB HOLOLINK_def.svh macros. Do not use for FPGA_top.sv wrappers or packetizer-only derivation. Generation runs bundled Python scripts locally through shell commands and writes validated .svh output files after user-confirmed paths.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},"nvidia","NVIDIA","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fnvidia.png",[12,16,17,20],{"name":13,"slug":14,"type":15},"Hardware","hardware","tag",{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"Python","python",{"name":21,"slug":22,"type":15},"Engineering","engineering",2473,"https:\u002F\u002Fgithub.com\u002FNVIDIA\u002Fskills","2026-08-05T05:58:12.824439","Apache-2.0",281,[],{"repoUrl":24,"stars":23,"forks":27,"topics":30,"description":31},[],"AI agent skills published by NVIDIA","https:\u002F\u002Fgithub.com\u002FNVIDIA\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Fhsb-ip-def","---\nname: hsb-ip-def\nauthor: \"Holoscan Team \u003Choloscan-team@nvidia.com>\"\ndescription: Generate, validate, compare, or explain HSB HOLOLINK_def.svh macros. Do not use for FPGA_top.sv wrappers or packetizer-only derivation. Generation runs bundled Python scripts locally through shell commands and writes validated .svh output files after user-confirmed paths.\nversion: \"0.1.0\"\ntags:\n  - holoscan\n  - hsb\n  - fpga\n  - systemverilog\n  - configuration\npermissions: [file_read, file_write, shell]\nlicense: Apache-2.0\ncompatibility: Targets HSB IP rev 16'h2604; backward-compatible with 16'h2603 (the public release rev). Prefer live HSB IP source when available; warn on unknown revisions. Requires Python 3.9+ with PyYAML for the generator.\nmetadata:\n  author: \"Holoscan Team \u003Choloscan-team@nvidia.com>\"\n  team: holoscan\n  domain: fpga\n  vendor: nvidia\n  tags:\n    - holoscan\n    - hsb\n    - fpga\n    - systemverilog\n    - configuration\n  languages:\n    - systemverilog\n    - python\n  artifact: HOLOLINK_def.svh\n  hsb_ip_version: \"16'h2604\"\n  min_compat_rev: \"16'h2603\"\n---\n\n# HSB IP Def Skill\n\n## Purpose\n\nUse this skill through four workflows:\n\n- **Generate** a `HOLOLINK_def.svh` from confirmed board requirements.\n- **Validate** an existing def file with the bundled validator.\n- **Explain \u002F Reason** about HSB IP macros, legality, and macro-driven ports.\n- **Compare** two def files semantically.\n\n## Scope\n\nThis skill owns the contents of `HOLOLINK_def.svh`: `\\`define` directives, `localparam` arrays, the `HOLOLINK_pkg` wrapper, and boot-time `init_reg[]` sequence. The surrounding top-level wrapper is owned by `hsb-ip-create-top`; packetizer-only profile derivation can be delegated to `hsb-ip-packetizer`.\n\nThe file must use the standard guard plus `package HOLOLINK_pkg` wrapper. Load `references\u002Fmacro-reference.md` for the full wrapper requirement and per-macro semantics.\n\n## Prerequisites\n\n- Python 3.9+ is required for the bundled scripts; PyYAML is required when reading YAML profiles.\n- The user must confirm file writes and shell commands unless they already asked for that exact operation.\n- A concrete def file path, pasted content, or confirmed generation profile is required before script-backed validation or generation.\n- Live HSB IP source is optional but preferred when validating against a specific checked-out IP revision.\n\n## Instructions\n\n- Run bundled script preflight from `references\u002Fscript-usage.md` before Generate, Validate, Compare, or script-backed legality checks.\n- Never silently default a macro during Generate. Show the proposed value or inferred requirement and get user confirmation.\n- Ask one requirements question per turn during chat-driven Generate.\n- Use sensor-agnostic language unless the user says the design is camera-specific.\n- Avoid unsupported \"typical\", \"common\", \"most designs\", or corpus-frequency claims. Anchor choices to IP behavior, documented constraints, or user requirements.\n- Always surface HD-W3xx footgun warnings, even when the user asks only about errors.\n- Do not generate `FPGA_top.sv`; offer handoff to `hsb-ip-create-top` after a generated def file is validated.\n- Treat unfamiliar macros as project-specific unless they are documented in this skill's references or live HSB IP source.\n\n## Security Considerations\n\nThis skill can read and write local files and run shell commands through its bundled scripts. Before running a command or writing a file, state the command or path and get user confirmation unless the user already explicitly requested that exact operation. For pasted `HOLOLINK_def.svh` content, write only to a safely generated file in an isolated temporary directory and remove it after validation unless the user asks to keep it.\n\n## Version, Compatibility, And Live Source\n\nThis skill targets HSB IP rev `16'h2604` and is backward-compatible with `16'h2603`. Live HSB IP source supersedes bundled references.\n\nWhen source-sensitive behavior matters:\n\n1. Locate `\u003Chsb-ip-root>\u002Ftop\u002FHOLOLINK_top.sv`. Known roots include `hw\u002Fnvcpu_dgx_fpga\u002Fvrtl\u002Fhololink\u002F` and public-release `fpga\u002Fnv_hsb_ip\u002F`.\n2. Read `HOLOLINK_REV` and `HOLOLINK_BACKWARD_COMPAT_REV`.\n3. Trust live source for consumed macros, port gates, and RTL behavior when it differs from bundled references.\n4. Pass `--ip-source \u003Croot>` to `scripts\u002Fvalidate_def.py` when validating against a known source root.\n\nPublic-doc baseline:\n\n- `https:\u002F\u002Fgithub.com\u002Fnvidia-holoscan\u002Fholoscan-sensor-bridge\u002Fblob\u002Frelease-2.6.0-EA\u002Fdocs\u002Fuser_guide\u002Fip_integration.md`\n- `https:\u002F\u002Fgithub.com\u002Fnvidia-holoscan\u002Fholoscan-sensor-bridge\u002Fblob\u002Frelease-2.6.0-EA\u002Fdocs\u002Fuser_guide\u002Fport_description.md`\n\n## Workflow Decision\n\n1. **Generate** when the user asks to create, scaffold, draft, design, or produce a `HOLOLINK_def.svh`.\n2. **Validate** when the user asks to lint, check, validate, or review a `HOLOLINK_def.svh`.\n3. **Explain \u002F Reason** when the user asks what a macro does, whether a combination is legal, why validation fails, or how a macro affects `HOLOLINK_top`.\n4. **Compare** when the user asks to diff two def files or understand what changed between configurations.\n\n## Generate\n\nLoad `references\u002Fgenerate-workflow.md` and `references\u002Fscript-usage.md`.\n\nFollow the detailed Generate workflow in the reference: run preflight, classify supplied requirements, ask one requirements question per turn, build a flat YAML profile, run `scripts\u002Fgenerate_def.py`, show provenance for generated fields, and offer handoff to `hsb-ip-create-top`.\n\nWhen packetizer fields are needed, invoke `hsb-ip-packetizer` with the known RX count, RX widths, and the user's data-manipulation description. Consume only that skill's `packetizer_profile_overlay` YAML keys, merge them into the in-progress profile, and continue full-file generation and validation here.\n\n## Validate\n\nLoad `references\u002Fscript-usage.md`. Load `references\u002Fvalidation-rules.md` only when explaining specific rule IDs or validation behavior.\n\nSteps:\n\n1. Run bundled script preflight once per session.\n2. Locate the file. If the user pastes content, tell them the generated temporary path before writing, ask for confirmation, use an isolated safe temp path, and clean it up after validation unless they ask to keep it. Otherwise use the provided path.\n3. Run `\u003CPY> scripts\u002Fvalidate_def.py \u003Cpath> --json` and do not reimplement validation in context.\n4. Group findings by severity: errors, warnings, then info. For each error, cite rule ID, line number, and macro when available.\n5. Always surface footgun warnings, especially HD-W3xx silent-fallback warnings.\n6. If clean, confirm the inferred archetype and IP version, then suggest the likely next check or handoff.\n\n## Explain \u002F Reason\n\nLoad only the reference needed for the question:\n\n| Question type | Reference |\n|---|---|\n| Macro semantics or legal values | `references\u002Fmacro-reference.md` |\n| Validation rule behavior | `references\u002Fvalidation-rules.md` |\n| Macro-driven port effects | `references\u002Ftop-port-map.md` |\n| `init_reg[]` and `N_INIT_REG` | `references\u002Finit-reg-cookbook.md` |\n| Advanced macros | `references\u002Fadvanced-macros.md` |\n| Example legal configurations | `references\u002Farchetypes.md` |\n\nFor grounded legality questions, run preflight and prefer validating a concrete file or minimal synthetic file with `scripts\u002Fvalidate_def.py` over hand reasoning. Cite RTL line ranges from references when explaining why a rule exists.\n\n## Compare\n\nLoad `references\u002Fscript-usage.md`, run preflight, then use `\u003CPY> scripts\u002Fcompare_defs.py \u003Ca.svh> \u003Cb.svh> [--json|--text]`. Summarize semantic differences, not whitespace or comment-only changes.\n\n## Limitations\n\n- Do not generate `FPGA_top.sv`; use `hsb-ip-create-top` after the defs file validates.\n- Do not derive packetizer-only field sets here when the packetizer behavior is underspecified; delegate that slice to `hsb-ip-packetizer`.\n- Do not treat bundled archetypes or corpus metadata as norms. They are examples and maintenance metadata, not defaults.\n- Do not silently accept unknown macros as validated HSB IP behavior unless live source or references document them.\n\n## Troubleshooting\n\n- Script preflight fails: report the missing Python or PyYAML requirement and stop before generation or validation.\n- Validation reports errors: group by severity, cite rule ID and line, and fix the defs file before offering top-level handoff.\n- Validation reports HD-W3xx warnings: surface them even when there are no errors because they describe silent RTL fallback risks.\n- Unknown macro appears: treat it as project-specific unless live HSB IP source or bundled references document it.\n\n## Available Scripts\n\nUse `\u003CPY>` selected during preflight from `references\u002Fscript-usage.md` for every command.\n\n| Script | Purpose | Arguments |\n|---|---|---|\n| `scripts\u002Fgenerate_def.py` | Generate `HOLOLINK_def.svh` from an archetype and\u002For YAML\u002FJSON profile; validates before writing | `--profile \u003Cpath>`, `--archetype \u003Cslug>`, `-o \u003Coutput>`, optional `--allow-random-uuid` compatibility flag |\n| `scripts\u002Fvalidate_def.py` | Validate a `HOLOLINK_def.svh` and emit JSON or text findings | `\u003Cpath\u002Fto\u002FHOLOLINK_def.svh>`, optional `--json` or `--text`, optional `--ip-source \u003Croot>` |\n| `scripts\u002Fcompare_defs.py` | Compare two def files semantically, ignoring whitespace\u002Fcomment-only changes | `\u003Ca.svh> \u003Cb.svh>`, optional `--json` or `--text` |\n| `scripts\u002Fbuild_corpus_metadata.py` | Maintenance helper to rebuild anonymized corpus metadata; do not run during normal user workflows | `\u003Cpath1> [\u003Cpath2> ...]` |\n\n## Bundled Resources\n\n| Resource | Use |\n|---|---|\n| `references\u002Fgenerate-workflow.md` | Detailed Generate workflow, requirement order, question style, and per-topic prompt guidance |\n| `references\u002Fscript-usage.md` | Preflight, command forms, and `run_script()` examples for bundled scripts |\n| `references\u002Fmacro-reference.md` | Wrapper requirement, macro semantics, legal constraints, and RTL citations |\n| `references\u002Fvalidation-rules.md` | Rule catalog for validator findings |\n| `references\u002Farchetypes.md` | Illustrative legal configurations; never treat as templates or frequency guidance |\n| `references\u002Finit-reg-cookbook.md` | Boot-time APB write sequence patterns and address conventions |\n| `references\u002Ftop-port-map.md` | Macro-to-`HOLOLINK_top` port effects |\n| `references\u002Fadvanced-macros.md` | `SYNC_CLK_HIF_APB`, `SYNC_CLK_HIF_PTP`, `PERI_RAM_DEPTH`, and `DISABLE_COE` |\n| `assets\u002Fmetadata\u002Fcorpus.json`, `assets\u002Fmetadata\u002Fcorpus-stats.json` | Maintenance metadata only; do not cite corpus counts as user guidance |\n| `scripts\u002Fgenerate_def.py` | Generate a def file from a profile |\n| `scripts\u002Fvalidate_def.py` | Validate a def file and emit JSON\u002Ftext findings |\n| `scripts\u002Fcompare_defs.py` | Compare two def files semantically |\n\n## Examples\n\n- `Use hsb-ip-def to generate a HOLOLINK_def.svh for a new HSB board.` Treat as Generate, run script preflight, classify supplied requirements, ask one requirement question per turn, and run `scripts\u002Fgenerate_def.py` only after the profile is confirmed.\n- `Use hsb-ip-def to validate my existing HOLOLINK_def.svh and tell me whether any warnings are important.` Treat as Validate, ask for or locate the file, run `scripts\u002Fvalidate_def.py \u003Cpath> --json`, group findings by errors, warnings, and info, and always surface HD-W3xx footgun warnings.\n- `Use hsb-ip-def to explain whether HOST_WIDTH=512 and PTP_CLK_FREQ=90_000_000 is legal.` Treat as Explain \u002F Reason, prefer a concrete validator-backed check over hand reasoning, and load only the macro or validation reference needed to explain the result.\n",{"data":35,"body":55},{"name":4,"author":36,"description":6,"version":37,"tags":38,"permissions":44,"license":26,"compatibility":48,"metadata":49},"Holoscan Team \u003Choloscan-team@nvidia.com>","0.1.0",[39,40,41,42,43],"holoscan","hsb","fpga","systemverilog","configuration",[45,46,47],"file_read","file_write","shell","Targets HSB IP rev 16'h2604; backward-compatible with 16'h2603 (the public release rev). Prefer live HSB IP source when available; warn on unknown revisions. Requires Python 3.9+ with PyYAML for the generator.",{"author":36,"team":39,"domain":41,"vendor":8,"tags":50,"languages":51,"artifact":52,"hsb_ip_version":53,"min_compat_rev":54},[39,40,41,42,43],[42,19],"HOLOLINK_def.svh","16'h2604","16'h2603",{"type":56,"children":57},"root",[58,67,74,80,134,140,204,225,231,254,260,326,332,344,350,369,374,453,458,479,485,543,548,566,585,606,611,630,635,676,681,686,825,837,842,861,867,909,915,938,944,964,1164,1170,1433,1439],{"type":59,"tag":60,"props":61,"children":63},"element","h1",{"id":62},"hsb-ip-def-skill",[64],{"type":65,"value":66},"text","HSB IP Def Skill",{"type":59,"tag":68,"props":69,"children":71},"h2",{"id":70},"purpose",[72],{"type":65,"value":73},"Purpose",{"type":59,"tag":75,"props":76,"children":77},"p",{},[78],{"type":65,"value":79},"Use this skill through four workflows:",{"type":59,"tag":81,"props":82,"children":83},"ul",{},[84,104,114,124],{"type":59,"tag":85,"props":86,"children":87},"li",{},[88,94,96,102],{"type":59,"tag":89,"props":90,"children":91},"strong",{},[92],{"type":65,"value":93},"Generate",{"type":65,"value":95}," a ",{"type":59,"tag":97,"props":98,"children":100},"code",{"className":99},[],[101],{"type":65,"value":52},{"type":65,"value":103}," from confirmed board requirements.",{"type":59,"tag":85,"props":105,"children":106},{},[107,112],{"type":59,"tag":89,"props":108,"children":109},{},[110],{"type":65,"value":111},"Validate",{"type":65,"value":113}," an existing def file with the bundled validator.",{"type":59,"tag":85,"props":115,"children":116},{},[117,122],{"type":59,"tag":89,"props":118,"children":119},{},[120],{"type":65,"value":121},"Explain \u002F Reason",{"type":65,"value":123}," about HSB IP macros, legality, and macro-driven ports.",{"type":59,"tag":85,"props":125,"children":126},{},[127,132],{"type":59,"tag":89,"props":128,"children":129},{},[130],{"type":65,"value":131},"Compare",{"type":65,"value":133}," two def files semantically.",{"type":59,"tag":68,"props":135,"children":137},{"id":136},"scope",[138],{"type":65,"value":139},"Scope",{"type":59,"tag":75,"props":141,"children":142},{},[143,145,150,152,158,160,166,168,174,176,182,184,188,194,196,202],{"type":65,"value":144},"This skill owns the contents of ",{"type":59,"tag":97,"props":146,"children":148},{"className":147},[],[149],{"type":65,"value":52},{"type":65,"value":151},": ",{"type":59,"tag":97,"props":153,"children":155},{"className":154},[],[156],{"type":65,"value":157},"\\",{"type":65,"value":159},"define",{"type":59,"tag":97,"props":161,"children":163},{"className":162},[],[164],{"type":65,"value":165},"directives,",{"type":65,"value":167},"localparam",{"type":59,"tag":97,"props":169,"children":171},{"className":170},[],[172],{"type":65,"value":173},"arrays, the",{"type":65,"value":175},"HOLOLINK_pkg",{"type":59,"tag":97,"props":177,"children":179},{"className":178},[],[180],{"type":65,"value":181},"wrapper, and boot-time",{"type":65,"value":183},"init_reg",{"type":59,"tag":185,"props":186,"children":187},"span",{},[],{"type":59,"tag":97,"props":189,"children":191},{"className":190},[],[192],{"type":65,"value":193},"sequence. The surrounding top-level wrapper is owned by",{"type":65,"value":195},"hsb-ip-create-top",{"type":59,"tag":97,"props":197,"children":199},{"className":198},[],[200],{"type":65,"value":201},"; packetizer-only profile derivation can be delegated to ",{"type":65,"value":203},"hsb-ip-packetizer`.",{"type":59,"tag":75,"props":205,"children":206},{},[207,209,215,217,223],{"type":65,"value":208},"The file must use the standard guard plus ",{"type":59,"tag":97,"props":210,"children":212},{"className":211},[],[213],{"type":65,"value":214},"package HOLOLINK_pkg",{"type":65,"value":216}," wrapper. Load ",{"type":59,"tag":97,"props":218,"children":220},{"className":219},[],[221],{"type":65,"value":222},"references\u002Fmacro-reference.md",{"type":65,"value":224}," for the full wrapper requirement and per-macro semantics.",{"type":59,"tag":68,"props":226,"children":228},{"id":227},"prerequisites",[229],{"type":65,"value":230},"Prerequisites",{"type":59,"tag":81,"props":232,"children":233},{},[234,239,244,249],{"type":59,"tag":85,"props":235,"children":236},{},[237],{"type":65,"value":238},"Python 3.9+ is required for the bundled scripts; PyYAML is required when reading YAML profiles.",{"type":59,"tag":85,"props":240,"children":241},{},[242],{"type":65,"value":243},"The user must confirm file writes and shell commands unless they already asked for that exact operation.",{"type":59,"tag":85,"props":245,"children":246},{},[247],{"type":65,"value":248},"A concrete def file path, pasted content, or confirmed generation profile is required before script-backed validation or generation.",{"type":59,"tag":85,"props":250,"children":251},{},[252],{"type":65,"value":253},"Live HSB IP source is optional but preferred when validating against a specific checked-out IP revision.",{"type":59,"tag":68,"props":255,"children":257},{"id":256},"instructions",[258],{"type":65,"value":259},"Instructions",{"type":59,"tag":81,"props":261,"children":262},{},[263,276,281,286,291,296,301,321],{"type":59,"tag":85,"props":264,"children":265},{},[266,268,274],{"type":65,"value":267},"Run bundled script preflight from ",{"type":59,"tag":97,"props":269,"children":271},{"className":270},[],[272],{"type":65,"value":273},"references\u002Fscript-usage.md",{"type":65,"value":275}," before Generate, Validate, Compare, or script-backed legality checks.",{"type":59,"tag":85,"props":277,"children":278},{},[279],{"type":65,"value":280},"Never silently default a macro during Generate. Show the proposed value or inferred requirement and get user confirmation.",{"type":59,"tag":85,"props":282,"children":283},{},[284],{"type":65,"value":285},"Ask one requirements question per turn during chat-driven Generate.",{"type":59,"tag":85,"props":287,"children":288},{},[289],{"type":65,"value":290},"Use sensor-agnostic language unless the user says the design is camera-specific.",{"type":59,"tag":85,"props":292,"children":293},{},[294],{"type":65,"value":295},"Avoid unsupported \"typical\", \"common\", \"most designs\", or corpus-frequency claims. Anchor choices to IP behavior, documented constraints, or user requirements.",{"type":59,"tag":85,"props":297,"children":298},{},[299],{"type":65,"value":300},"Always surface HD-W3xx footgun warnings, even when the user asks only about errors.",{"type":59,"tag":85,"props":302,"children":303},{},[304,306,312,314,319],{"type":65,"value":305},"Do not generate ",{"type":59,"tag":97,"props":307,"children":309},{"className":308},[],[310],{"type":65,"value":311},"FPGA_top.sv",{"type":65,"value":313},"; offer handoff to ",{"type":59,"tag":97,"props":315,"children":317},{"className":316},[],[318],{"type":65,"value":195},{"type":65,"value":320}," after a generated def file is validated.",{"type":59,"tag":85,"props":322,"children":323},{},[324],{"type":65,"value":325},"Treat unfamiliar macros as project-specific unless they are documented in this skill's references or live HSB IP source.",{"type":59,"tag":68,"props":327,"children":329},{"id":328},"security-considerations",[330],{"type":65,"value":331},"Security Considerations",{"type":59,"tag":75,"props":333,"children":334},{},[335,337,342],{"type":65,"value":336},"This skill can read and write local files and run shell commands through its bundled scripts. Before running a command or writing a file, state the command or path and get user confirmation unless the user already explicitly requested that exact operation. For pasted ",{"type":59,"tag":97,"props":338,"children":340},{"className":339},[],[341],{"type":65,"value":52},{"type":65,"value":343}," content, write only to a safely generated file in an isolated temporary directory and remove it after validation unless the user asks to keep it.",{"type":59,"tag":68,"props":345,"children":347},{"id":346},"version-compatibility-and-live-source",[348],{"type":65,"value":349},"Version, Compatibility, And Live Source",{"type":59,"tag":75,"props":351,"children":352},{},[353,355,360,362,367],{"type":65,"value":354},"This skill targets HSB IP rev ",{"type":59,"tag":97,"props":356,"children":358},{"className":357},[],[359],{"type":65,"value":53},{"type":65,"value":361}," and is backward-compatible with ",{"type":59,"tag":97,"props":363,"children":365},{"className":364},[],[366],{"type":65,"value":54},{"type":65,"value":368},". Live HSB IP source supersedes bundled references.",{"type":59,"tag":75,"props":370,"children":371},{},[372],{"type":65,"value":373},"When source-sensitive behavior matters:",{"type":59,"tag":375,"props":376,"children":377},"ol",{},[378,407,427,432],{"type":59,"tag":85,"props":379,"children":380},{},[381,383,389,391,397,399,405],{"type":65,"value":382},"Locate ",{"type":59,"tag":97,"props":384,"children":386},{"className":385},[],[387],{"type":65,"value":388},"\u003Chsb-ip-root>\u002Ftop\u002FHOLOLINK_top.sv",{"type":65,"value":390},". Known roots include ",{"type":59,"tag":97,"props":392,"children":394},{"className":393},[],[395],{"type":65,"value":396},"hw\u002Fnvcpu_dgx_fpga\u002Fvrtl\u002Fhololink\u002F",{"type":65,"value":398}," and public-release ",{"type":59,"tag":97,"props":400,"children":402},{"className":401},[],[403],{"type":65,"value":404},"fpga\u002Fnv_hsb_ip\u002F",{"type":65,"value":406},".",{"type":59,"tag":85,"props":408,"children":409},{},[410,412,418,420,426],{"type":65,"value":411},"Read ",{"type":59,"tag":97,"props":413,"children":415},{"className":414},[],[416],{"type":65,"value":417},"HOLOLINK_REV",{"type":65,"value":419}," and ",{"type":59,"tag":97,"props":421,"children":423},{"className":422},[],[424],{"type":65,"value":425},"HOLOLINK_BACKWARD_COMPAT_REV",{"type":65,"value":406},{"type":59,"tag":85,"props":428,"children":429},{},[430],{"type":65,"value":431},"Trust live source for consumed macros, port gates, and RTL behavior when it differs from bundled references.",{"type":59,"tag":85,"props":433,"children":434},{},[435,437,443,445,451],{"type":65,"value":436},"Pass ",{"type":59,"tag":97,"props":438,"children":440},{"className":439},[],[441],{"type":65,"value":442},"--ip-source \u003Croot>",{"type":65,"value":444}," to ",{"type":59,"tag":97,"props":446,"children":448},{"className":447},[],[449],{"type":65,"value":450},"scripts\u002Fvalidate_def.py",{"type":65,"value":452}," when validating against a known source root.",{"type":59,"tag":75,"props":454,"children":455},{},[456],{"type":65,"value":457},"Public-doc baseline:",{"type":59,"tag":81,"props":459,"children":460},{},[461,470],{"type":59,"tag":85,"props":462,"children":463},{},[464],{"type":59,"tag":97,"props":465,"children":467},{"className":466},[],[468],{"type":65,"value":469},"https:\u002F\u002Fgithub.com\u002Fnvidia-holoscan\u002Fholoscan-sensor-bridge\u002Fblob\u002Frelease-2.6.0-EA\u002Fdocs\u002Fuser_guide\u002Fip_integration.md",{"type":59,"tag":85,"props":471,"children":472},{},[473],{"type":59,"tag":97,"props":474,"children":476},{"className":475},[],[477],{"type":65,"value":478},"https:\u002F\u002Fgithub.com\u002Fnvidia-holoscan\u002Fholoscan-sensor-bridge\u002Fblob\u002Frelease-2.6.0-EA\u002Fdocs\u002Fuser_guide\u002Fport_description.md",{"type":59,"tag":68,"props":480,"children":482},{"id":481},"workflow-decision",[483],{"type":65,"value":484},"Workflow Decision",{"type":59,"tag":375,"props":486,"children":487},{},[488,503,518,534],{"type":59,"tag":85,"props":489,"children":490},{},[491,495,497,502],{"type":59,"tag":89,"props":492,"children":493},{},[494],{"type":65,"value":93},{"type":65,"value":496}," when the user asks to create, scaffold, draft, design, or produce a ",{"type":59,"tag":97,"props":498,"children":500},{"className":499},[],[501],{"type":65,"value":52},{"type":65,"value":406},{"type":59,"tag":85,"props":504,"children":505},{},[506,510,512,517],{"type":59,"tag":89,"props":507,"children":508},{},[509],{"type":65,"value":111},{"type":65,"value":511}," when the user asks to lint, check, validate, or review a ",{"type":59,"tag":97,"props":513,"children":515},{"className":514},[],[516],{"type":65,"value":52},{"type":65,"value":406},{"type":59,"tag":85,"props":519,"children":520},{},[521,525,527,533],{"type":59,"tag":89,"props":522,"children":523},{},[524],{"type":65,"value":121},{"type":65,"value":526}," when the user asks what a macro does, whether a combination is legal, why validation fails, or how a macro affects ",{"type":59,"tag":97,"props":528,"children":530},{"className":529},[],[531],{"type":65,"value":532},"HOLOLINK_top",{"type":65,"value":406},{"type":59,"tag":85,"props":535,"children":536},{},[537,541],{"type":59,"tag":89,"props":538,"children":539},{},[540],{"type":65,"value":131},{"type":65,"value":542}," when the user asks to diff two def files or understand what changed between configurations.",{"type":59,"tag":68,"props":544,"children":546},{"id":545},"generate",[547],{"type":65,"value":93},{"type":59,"tag":75,"props":549,"children":550},{},[551,553,559,560,565],{"type":65,"value":552},"Load ",{"type":59,"tag":97,"props":554,"children":556},{"className":555},[],[557],{"type":65,"value":558},"references\u002Fgenerate-workflow.md",{"type":65,"value":419},{"type":59,"tag":97,"props":561,"children":563},{"className":562},[],[564],{"type":65,"value":273},{"type":65,"value":406},{"type":59,"tag":75,"props":567,"children":568},{},[569,571,577,579,584],{"type":65,"value":570},"Follow the detailed Generate workflow in the reference: run preflight, classify supplied requirements, ask one requirements question per turn, build a flat YAML profile, run ",{"type":59,"tag":97,"props":572,"children":574},{"className":573},[],[575],{"type":65,"value":576},"scripts\u002Fgenerate_def.py",{"type":65,"value":578},", show provenance for generated fields, and offer handoff to ",{"type":59,"tag":97,"props":580,"children":582},{"className":581},[],[583],{"type":65,"value":195},{"type":65,"value":406},{"type":59,"tag":75,"props":586,"children":587},{},[588,590,596,598,604],{"type":65,"value":589},"When packetizer fields are needed, invoke ",{"type":59,"tag":97,"props":591,"children":593},{"className":592},[],[594],{"type":65,"value":595},"hsb-ip-packetizer",{"type":65,"value":597}," with the known RX count, RX widths, and the user's data-manipulation description. Consume only that skill's ",{"type":59,"tag":97,"props":599,"children":601},{"className":600},[],[602],{"type":65,"value":603},"packetizer_profile_overlay",{"type":65,"value":605}," YAML keys, merge them into the in-progress profile, and continue full-file generation and validation here.",{"type":59,"tag":68,"props":607,"children":609},{"id":608},"validate",[610],{"type":65,"value":111},{"type":59,"tag":75,"props":612,"children":613},{},[614,615,620,622,628],{"type":65,"value":552},{"type":59,"tag":97,"props":616,"children":618},{"className":617},[],[619],{"type":65,"value":273},{"type":65,"value":621},". Load ",{"type":59,"tag":97,"props":623,"children":625},{"className":624},[],[626],{"type":65,"value":627},"references\u002Fvalidation-rules.md",{"type":65,"value":629}," only when explaining specific rule IDs or validation behavior.",{"type":59,"tag":75,"props":631,"children":632},{},[633],{"type":65,"value":634},"Steps:",{"type":59,"tag":375,"props":636,"children":637},{},[638,643,648,661,666,671],{"type":59,"tag":85,"props":639,"children":640},{},[641],{"type":65,"value":642},"Run bundled script preflight once per session.",{"type":59,"tag":85,"props":644,"children":645},{},[646],{"type":65,"value":647},"Locate the file. If the user pastes content, tell them the generated temporary path before writing, ask for confirmation, use an isolated safe temp path, and clean it up after validation unless they ask to keep it. Otherwise use the provided path.",{"type":59,"tag":85,"props":649,"children":650},{},[651,653,659],{"type":65,"value":652},"Run ",{"type":59,"tag":97,"props":654,"children":656},{"className":655},[],[657],{"type":65,"value":658},"\u003CPY> scripts\u002Fvalidate_def.py \u003Cpath> --json",{"type":65,"value":660}," and do not reimplement validation in context.",{"type":59,"tag":85,"props":662,"children":663},{},[664],{"type":65,"value":665},"Group findings by severity: errors, warnings, then info. For each error, cite rule ID, line number, and macro when available.",{"type":59,"tag":85,"props":667,"children":668},{},[669],{"type":65,"value":670},"Always surface footgun warnings, especially HD-W3xx silent-fallback warnings.",{"type":59,"tag":85,"props":672,"children":673},{},[674],{"type":65,"value":675},"If clean, confirm the inferred archetype and IP version, then suggest the likely next check or handoff.",{"type":59,"tag":68,"props":677,"children":679},{"id":678},"explain-reason",[680],{"type":65,"value":121},{"type":59,"tag":75,"props":682,"children":683},{},[684],{"type":65,"value":685},"Load only the reference needed for the question:",{"type":59,"tag":687,"props":688,"children":689},"table",{},[690,709],{"type":59,"tag":691,"props":692,"children":693},"thead",{},[694],{"type":59,"tag":695,"props":696,"children":697},"tr",{},[698,704],{"type":59,"tag":699,"props":700,"children":701},"th",{},[702],{"type":65,"value":703},"Question type",{"type":59,"tag":699,"props":705,"children":706},{},[707],{"type":65,"value":708},"Reference",{"type":59,"tag":710,"props":711,"children":712},"tbody",{},[713,730,746,763,791,808],{"type":59,"tag":695,"props":714,"children":715},{},[716,722],{"type":59,"tag":717,"props":718,"children":719},"td",{},[720],{"type":65,"value":721},"Macro semantics or legal values",{"type":59,"tag":717,"props":723,"children":724},{},[725],{"type":59,"tag":97,"props":726,"children":728},{"className":727},[],[729],{"type":65,"value":222},{"type":59,"tag":695,"props":731,"children":732},{},[733,738],{"type":59,"tag":717,"props":734,"children":735},{},[736],{"type":65,"value":737},"Validation rule behavior",{"type":59,"tag":717,"props":739,"children":740},{},[741],{"type":59,"tag":97,"props":742,"children":744},{"className":743},[],[745],{"type":65,"value":627},{"type":59,"tag":695,"props":747,"children":748},{},[749,754],{"type":59,"tag":717,"props":750,"children":751},{},[752],{"type":65,"value":753},"Macro-driven port effects",{"type":59,"tag":717,"props":755,"children":756},{},[757],{"type":59,"tag":97,"props":758,"children":760},{"className":759},[],[761],{"type":65,"value":762},"references\u002Ftop-port-map.md",{"type":59,"tag":695,"props":764,"children":765},{},[766,782],{"type":59,"tag":717,"props":767,"children":768},{},[769,775,776],{"type":59,"tag":97,"props":770,"children":772},{"className":771},[],[773],{"type":65,"value":774},"init_reg[]",{"type":65,"value":419},{"type":59,"tag":97,"props":777,"children":779},{"className":778},[],[780],{"type":65,"value":781},"N_INIT_REG",{"type":59,"tag":717,"props":783,"children":784},{},[785],{"type":59,"tag":97,"props":786,"children":788},{"className":787},[],[789],{"type":65,"value":790},"references\u002Finit-reg-cookbook.md",{"type":59,"tag":695,"props":792,"children":793},{},[794,799],{"type":59,"tag":717,"props":795,"children":796},{},[797],{"type":65,"value":798},"Advanced macros",{"type":59,"tag":717,"props":800,"children":801},{},[802],{"type":59,"tag":97,"props":803,"children":805},{"className":804},[],[806],{"type":65,"value":807},"references\u002Fadvanced-macros.md",{"type":59,"tag":695,"props":809,"children":810},{},[811,816],{"type":59,"tag":717,"props":812,"children":813},{},[814],{"type":65,"value":815},"Example legal configurations",{"type":59,"tag":717,"props":817,"children":818},{},[819],{"type":59,"tag":97,"props":820,"children":822},{"className":821},[],[823],{"type":65,"value":824},"references\u002Farchetypes.md",{"type":59,"tag":75,"props":826,"children":827},{},[828,830,835],{"type":65,"value":829},"For grounded legality questions, run preflight and prefer validating a concrete file or minimal synthetic file with ",{"type":59,"tag":97,"props":831,"children":833},{"className":832},[],[834],{"type":65,"value":450},{"type":65,"value":836}," over hand reasoning. Cite RTL line ranges from references when explaining why a rule exists.",{"type":59,"tag":68,"props":838,"children":840},{"id":839},"compare",[841],{"type":65,"value":131},{"type":59,"tag":75,"props":843,"children":844},{},[845,846,851,853,859],{"type":65,"value":552},{"type":59,"tag":97,"props":847,"children":849},{"className":848},[],[850],{"type":65,"value":273},{"type":65,"value":852},", run preflight, then use ",{"type":59,"tag":97,"props":854,"children":856},{"className":855},[],[857],{"type":65,"value":858},"\u003CPY> scripts\u002Fcompare_defs.py \u003Ca.svh> \u003Cb.svh> [--json|--text]",{"type":65,"value":860},". Summarize semantic differences, not whitespace or comment-only changes.",{"type":59,"tag":68,"props":862,"children":864},{"id":863},"limitations",[865],{"type":65,"value":866},"Limitations",{"type":59,"tag":81,"props":868,"children":869},{},[870,888,899,904],{"type":59,"tag":85,"props":871,"children":872},{},[873,874,879,881,886],{"type":65,"value":305},{"type":59,"tag":97,"props":875,"children":877},{"className":876},[],[878],{"type":65,"value":311},{"type":65,"value":880},"; use ",{"type":59,"tag":97,"props":882,"children":884},{"className":883},[],[885],{"type":65,"value":195},{"type":65,"value":887}," after the defs file validates.",{"type":59,"tag":85,"props":889,"children":890},{},[891,893,898],{"type":65,"value":892},"Do not derive packetizer-only field sets here when the packetizer behavior is underspecified; delegate that slice to ",{"type":59,"tag":97,"props":894,"children":896},{"className":895},[],[897],{"type":65,"value":595},{"type":65,"value":406},{"type":59,"tag":85,"props":900,"children":901},{},[902],{"type":65,"value":903},"Do not treat bundled archetypes or corpus metadata as norms. They are examples and maintenance metadata, not defaults.",{"type":59,"tag":85,"props":905,"children":906},{},[907],{"type":65,"value":908},"Do not silently accept unknown macros as validated HSB IP behavior unless live source or references document them.",{"type":59,"tag":68,"props":910,"children":912},{"id":911},"troubleshooting",[913],{"type":65,"value":914},"Troubleshooting",{"type":59,"tag":81,"props":916,"children":917},{},[918,923,928,933],{"type":59,"tag":85,"props":919,"children":920},{},[921],{"type":65,"value":922},"Script preflight fails: report the missing Python or PyYAML requirement and stop before generation or validation.",{"type":59,"tag":85,"props":924,"children":925},{},[926],{"type":65,"value":927},"Validation reports errors: group by severity, cite rule ID and line, and fix the defs file before offering top-level handoff.",{"type":59,"tag":85,"props":929,"children":930},{},[931],{"type":65,"value":932},"Validation reports HD-W3xx warnings: surface them even when there are no errors because they describe silent RTL fallback risks.",{"type":59,"tag":85,"props":934,"children":935},{},[936],{"type":65,"value":937},"Unknown macro appears: treat it as project-specific unless live HSB IP source or bundled references document it.",{"type":59,"tag":68,"props":939,"children":941},{"id":940},"available-scripts",[942],{"type":65,"value":943},"Available Scripts",{"type":59,"tag":75,"props":945,"children":946},{},[947,949,955,957,962],{"type":65,"value":948},"Use ",{"type":59,"tag":97,"props":950,"children":952},{"className":951},[],[953],{"type":65,"value":954},"\u003CPY>",{"type":65,"value":956}," selected during preflight from ",{"type":59,"tag":97,"props":958,"children":960},{"className":959},[],[961],{"type":65,"value":273},{"type":65,"value":963}," for every command.",{"type":59,"tag":687,"props":965,"children":966},{},[967,987],{"type":59,"tag":691,"props":968,"children":969},{},[970],{"type":59,"tag":695,"props":971,"children":972},{},[973,978,982],{"type":59,"tag":699,"props":974,"children":975},{},[976],{"type":65,"value":977},"Script",{"type":59,"tag":699,"props":979,"children":980},{},[981],{"type":65,"value":73},{"type":59,"tag":699,"props":983,"children":984},{},[985],{"type":65,"value":986},"Arguments",{"type":59,"tag":710,"props":988,"children":989},{},[990,1047,1100,1138],{"type":59,"tag":695,"props":991,"children":992},{},[993,1001,1013],{"type":59,"tag":717,"props":994,"children":995},{},[996],{"type":59,"tag":97,"props":997,"children":999},{"className":998},[],[1000],{"type":65,"value":576},{"type":59,"tag":717,"props":1002,"children":1003},{},[1004,1006,1011],{"type":65,"value":1005},"Generate ",{"type":59,"tag":97,"props":1007,"children":1009},{"className":1008},[],[1010],{"type":65,"value":52},{"type":65,"value":1012}," from an archetype and\u002For YAML\u002FJSON profile; validates before writing",{"type":59,"tag":717,"props":1014,"children":1015},{},[1016,1022,1024,1030,1031,1037,1039,1045],{"type":59,"tag":97,"props":1017,"children":1019},{"className":1018},[],[1020],{"type":65,"value":1021},"--profile \u003Cpath>",{"type":65,"value":1023},", ",{"type":59,"tag":97,"props":1025,"children":1027},{"className":1026},[],[1028],{"type":65,"value":1029},"--archetype \u003Cslug>",{"type":65,"value":1023},{"type":59,"tag":97,"props":1032,"children":1034},{"className":1033},[],[1035],{"type":65,"value":1036},"-o \u003Coutput>",{"type":65,"value":1038},", optional ",{"type":59,"tag":97,"props":1040,"children":1042},{"className":1041},[],[1043],{"type":65,"value":1044},"--allow-random-uuid",{"type":65,"value":1046}," compatibility flag",{"type":59,"tag":695,"props":1048,"children":1049},{},[1050,1058,1070],{"type":59,"tag":717,"props":1051,"children":1052},{},[1053],{"type":59,"tag":97,"props":1054,"children":1056},{"className":1055},[],[1057],{"type":65,"value":450},{"type":59,"tag":717,"props":1059,"children":1060},{},[1061,1063,1068],{"type":65,"value":1062},"Validate a ",{"type":59,"tag":97,"props":1064,"children":1066},{"className":1065},[],[1067],{"type":65,"value":52},{"type":65,"value":1069}," and emit JSON or text findings",{"type":59,"tag":717,"props":1071,"children":1072},{},[1073,1079,1080,1086,1088,1094,1095],{"type":59,"tag":97,"props":1074,"children":1076},{"className":1075},[],[1077],{"type":65,"value":1078},"\u003Cpath\u002Fto\u002FHOLOLINK_def.svh>",{"type":65,"value":1038},{"type":59,"tag":97,"props":1081,"children":1083},{"className":1082},[],[1084],{"type":65,"value":1085},"--json",{"type":65,"value":1087}," or ",{"type":59,"tag":97,"props":1089,"children":1091},{"className":1090},[],[1092],{"type":65,"value":1093},"--text",{"type":65,"value":1038},{"type":59,"tag":97,"props":1096,"children":1098},{"className":1097},[],[1099],{"type":65,"value":442},{"type":59,"tag":695,"props":1101,"children":1102},{},[1103,1112,1117],{"type":59,"tag":717,"props":1104,"children":1105},{},[1106],{"type":59,"tag":97,"props":1107,"children":1109},{"className":1108},[],[1110],{"type":65,"value":1111},"scripts\u002Fcompare_defs.py",{"type":59,"tag":717,"props":1113,"children":1114},{},[1115],{"type":65,"value":1116},"Compare two def files semantically, ignoring whitespace\u002Fcomment-only changes",{"type":59,"tag":717,"props":1118,"children":1119},{},[1120,1126,1127,1132,1133],{"type":59,"tag":97,"props":1121,"children":1123},{"className":1122},[],[1124],{"type":65,"value":1125},"\u003Ca.svh> \u003Cb.svh>",{"type":65,"value":1038},{"type":59,"tag":97,"props":1128,"children":1130},{"className":1129},[],[1131],{"type":65,"value":1085},{"type":65,"value":1087},{"type":59,"tag":97,"props":1134,"children":1136},{"className":1135},[],[1137],{"type":65,"value":1093},{"type":59,"tag":695,"props":1139,"children":1140},{},[1141,1150,1155],{"type":59,"tag":717,"props":1142,"children":1143},{},[1144],{"type":59,"tag":97,"props":1145,"children":1147},{"className":1146},[],[1148],{"type":65,"value":1149},"scripts\u002Fbuild_corpus_metadata.py",{"type":59,"tag":717,"props":1151,"children":1152},{},[1153],{"type":65,"value":1154},"Maintenance helper to rebuild anonymized corpus metadata; do not run during normal user workflows",{"type":59,"tag":717,"props":1156,"children":1157},{},[1158],{"type":59,"tag":97,"props":1159,"children":1161},{"className":1160},[],[1162],{"type":65,"value":1163},"\u003Cpath1> [\u003Cpath2> ...]",{"type":59,"tag":68,"props":1165,"children":1167},{"id":1166},"bundled-resources",[1168],{"type":65,"value":1169},"Bundled Resources",{"type":59,"tag":687,"props":1171,"children":1172},{},[1173,1189],{"type":59,"tag":691,"props":1174,"children":1175},{},[1176],{"type":59,"tag":695,"props":1177,"children":1178},{},[1179,1184],{"type":59,"tag":699,"props":1180,"children":1181},{},[1182],{"type":65,"value":1183},"Resource",{"type":59,"tag":699,"props":1185,"children":1186},{},[1187],{"type":65,"value":1188},"Use",{"type":59,"tag":710,"props":1190,"children":1191},{},[1192,1208,1232,1248,1264,1280,1296,1319,1361,1385,1401,1417],{"type":59,"tag":695,"props":1193,"children":1194},{},[1195,1203],{"type":59,"tag":717,"props":1196,"children":1197},{},[1198],{"type":59,"tag":97,"props":1199,"children":1201},{"className":1200},[],[1202],{"type":65,"value":558},{"type":59,"tag":717,"props":1204,"children":1205},{},[1206],{"type":65,"value":1207},"Detailed Generate workflow, requirement order, question style, and per-topic prompt guidance",{"type":59,"tag":695,"props":1209,"children":1210},{},[1211,1219],{"type":59,"tag":717,"props":1212,"children":1213},{},[1214],{"type":59,"tag":97,"props":1215,"children":1217},{"className":1216},[],[1218],{"type":65,"value":273},{"type":59,"tag":717,"props":1220,"children":1221},{},[1222,1224,1230],{"type":65,"value":1223},"Preflight, command forms, and ",{"type":59,"tag":97,"props":1225,"children":1227},{"className":1226},[],[1228],{"type":65,"value":1229},"run_script()",{"type":65,"value":1231}," examples for bundled scripts",{"type":59,"tag":695,"props":1233,"children":1234},{},[1235,1243],{"type":59,"tag":717,"props":1236,"children":1237},{},[1238],{"type":59,"tag":97,"props":1239,"children":1241},{"className":1240},[],[1242],{"type":65,"value":222},{"type":59,"tag":717,"props":1244,"children":1245},{},[1246],{"type":65,"value":1247},"Wrapper requirement, macro semantics, legal constraints, and RTL citations",{"type":59,"tag":695,"props":1249,"children":1250},{},[1251,1259],{"type":59,"tag":717,"props":1252,"children":1253},{},[1254],{"type":59,"tag":97,"props":1255,"children":1257},{"className":1256},[],[1258],{"type":65,"value":627},{"type":59,"tag":717,"props":1260,"children":1261},{},[1262],{"type":65,"value":1263},"Rule catalog for validator findings",{"type":59,"tag":695,"props":1265,"children":1266},{},[1267,1275],{"type":59,"tag":717,"props":1268,"children":1269},{},[1270],{"type":59,"tag":97,"props":1271,"children":1273},{"className":1272},[],[1274],{"type":65,"value":824},{"type":59,"tag":717,"props":1276,"children":1277},{},[1278],{"type":65,"value":1279},"Illustrative legal configurations; never treat as templates or frequency guidance",{"type":59,"tag":695,"props":1281,"children":1282},{},[1283,1291],{"type":59,"tag":717,"props":1284,"children":1285},{},[1286],{"type":59,"tag":97,"props":1287,"children":1289},{"className":1288},[],[1290],{"type":65,"value":790},{"type":59,"tag":717,"props":1292,"children":1293},{},[1294],{"type":65,"value":1295},"Boot-time APB write sequence patterns and address conventions",{"type":59,"tag":695,"props":1297,"children":1298},{},[1299,1307],{"type":59,"tag":717,"props":1300,"children":1301},{},[1302],{"type":59,"tag":97,"props":1303,"children":1305},{"className":1304},[],[1306],{"type":65,"value":762},{"type":59,"tag":717,"props":1308,"children":1309},{},[1310,1312,1317],{"type":65,"value":1311},"Macro-to-",{"type":59,"tag":97,"props":1313,"children":1315},{"className":1314},[],[1316],{"type":65,"value":532},{"type":65,"value":1318}," port effects",{"type":59,"tag":695,"props":1320,"children":1321},{},[1322,1330],{"type":59,"tag":717,"props":1323,"children":1324},{},[1325],{"type":59,"tag":97,"props":1326,"children":1328},{"className":1327},[],[1329],{"type":65,"value":807},{"type":59,"tag":717,"props":1331,"children":1332},{},[1333,1339,1340,1346,1347,1353,1355],{"type":59,"tag":97,"props":1334,"children":1336},{"className":1335},[],[1337],{"type":65,"value":1338},"SYNC_CLK_HIF_APB",{"type":65,"value":1023},{"type":59,"tag":97,"props":1341,"children":1343},{"className":1342},[],[1344],{"type":65,"value":1345},"SYNC_CLK_HIF_PTP",{"type":65,"value":1023},{"type":59,"tag":97,"props":1348,"children":1350},{"className":1349},[],[1351],{"type":65,"value":1352},"PERI_RAM_DEPTH",{"type":65,"value":1354},", and ",{"type":59,"tag":97,"props":1356,"children":1358},{"className":1357},[],[1359],{"type":65,"value":1360},"DISABLE_COE",{"type":59,"tag":695,"props":1362,"children":1363},{},[1364,1380],{"type":59,"tag":717,"props":1365,"children":1366},{},[1367,1373,1374],{"type":59,"tag":97,"props":1368,"children":1370},{"className":1369},[],[1371],{"type":65,"value":1372},"assets\u002Fmetadata\u002Fcorpus.json",{"type":65,"value":1023},{"type":59,"tag":97,"props":1375,"children":1377},{"className":1376},[],[1378],{"type":65,"value":1379},"assets\u002Fmetadata\u002Fcorpus-stats.json",{"type":59,"tag":717,"props":1381,"children":1382},{},[1383],{"type":65,"value":1384},"Maintenance metadata only; do not cite corpus counts as user guidance",{"type":59,"tag":695,"props":1386,"children":1387},{},[1388,1396],{"type":59,"tag":717,"props":1389,"children":1390},{},[1391],{"type":59,"tag":97,"props":1392,"children":1394},{"className":1393},[],[1395],{"type":65,"value":576},{"type":59,"tag":717,"props":1397,"children":1398},{},[1399],{"type":65,"value":1400},"Generate a def file from a profile",{"type":59,"tag":695,"props":1402,"children":1403},{},[1404,1412],{"type":59,"tag":717,"props":1405,"children":1406},{},[1407],{"type":59,"tag":97,"props":1408,"children":1410},{"className":1409},[],[1411],{"type":65,"value":450},{"type":59,"tag":717,"props":1413,"children":1414},{},[1415],{"type":65,"value":1416},"Validate a def file and emit JSON\u002Ftext findings",{"type":59,"tag":695,"props":1418,"children":1419},{},[1420,1428],{"type":59,"tag":717,"props":1421,"children":1422},{},[1423],{"type":59,"tag":97,"props":1424,"children":1426},{"className":1425},[],[1427],{"type":65,"value":1111},{"type":59,"tag":717,"props":1429,"children":1430},{},[1431],{"type":65,"value":1432},"Compare two def files semantically",{"type":59,"tag":68,"props":1434,"children":1436},{"id":1435},"examples",[1437],{"type":65,"value":1438},"Examples",{"type":59,"tag":81,"props":1440,"children":1441},{},[1442,1460,1479],{"type":59,"tag":85,"props":1443,"children":1444},{},[1445,1451,1453,1458],{"type":59,"tag":97,"props":1446,"children":1448},{"className":1447},[],[1449],{"type":65,"value":1450},"Use hsb-ip-def to generate a HOLOLINK_def.svh for a new HSB board.",{"type":65,"value":1452}," Treat as Generate, run script preflight, classify supplied requirements, ask one requirement question per turn, and run ",{"type":59,"tag":97,"props":1454,"children":1456},{"className":1455},[],[1457],{"type":65,"value":576},{"type":65,"value":1459}," only after the profile is confirmed.",{"type":59,"tag":85,"props":1461,"children":1462},{},[1463,1469,1471,1477],{"type":59,"tag":97,"props":1464,"children":1466},{"className":1465},[],[1467],{"type":65,"value":1468},"Use hsb-ip-def to validate my existing HOLOLINK_def.svh and tell me whether any warnings are important.",{"type":65,"value":1470}," Treat as Validate, ask for or locate the file, run ",{"type":59,"tag":97,"props":1472,"children":1474},{"className":1473},[],[1475],{"type":65,"value":1476},"scripts\u002Fvalidate_def.py \u003Cpath> --json",{"type":65,"value":1478},", group findings by errors, warnings, and info, and always surface HD-W3xx footgun warnings.",{"type":59,"tag":85,"props":1480,"children":1481},{},[1482,1488],{"type":59,"tag":97,"props":1483,"children":1485},{"className":1484},[],[1486],{"type":65,"value":1487},"Use hsb-ip-def to explain whether HOST_WIDTH=512 and PTP_CLK_FREQ=90_000_000 is legal.",{"type":65,"value":1489}," Treat as Explain \u002F Reason, prefer a concrete validator-backed check over hand reasoning, and load only the macro or validation reference needed to explain the result.",{"items":1491,"total":1595},[1492,1509,1523,1537,1549,1566,1581],{"slug":1493,"name":1493,"fn":1494,"description":1495,"org":1496,"tags":1497,"stars":23,"repoUrl":24,"updatedAt":1508},"accelerated-computing-cudf","accelerate data processing with cuDF","Official NVIDIA-authored guidance for NVIDIA cuDF GPU DataFrames, pandas acceleration, dask-cuDF, ETL, joins, groupby, CSV\u002FParquet I\u002FO, nullable semantics, and multi-GPU DataFrame workloads.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1498,1501,1504,1505],{"name":1499,"slug":1500,"type":15},"Data Analysis","data-analysis",{"name":1502,"slug":1503,"type":15},"Data Engineering","data-engineering",{"name":9,"slug":8,"type":15},{"name":1506,"slug":1507,"type":15},"Performance","performance","2026-07-14T05:28:43.176466",{"slug":1510,"name":1510,"fn":1511,"description":1512,"org":1513,"tags":1514,"stars":23,"repoUrl":24,"updatedAt":1522},"aiq-deploy","deploy and manage NVIDIA AI-Q infrastructure","Use when asked to install, deploy, run, validate, troubleshoot, or stop NVIDIA AI-Q Blueprint infrastructure.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1515,1518,1521],{"name":1516,"slug":1517,"type":15},"Deployment","deployment",{"name":1519,"slug":1520,"type":15},"Infrastructure","infrastructure",{"name":9,"slug":8,"type":15},"2026-07-14T05:29:06.667109",{"slug":1524,"name":1524,"fn":1525,"description":1526,"org":1527,"tags":1528,"stars":23,"repoUrl":24,"updatedAt":1536},"aiq-research","conduct deep research with AI-Q","Use when asked to run deep research or AI-Q research through a reachable NVIDIA AI-Q Blueprint backend.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1529,1532,1533],{"name":1530,"slug":1531,"type":15},"Agents","agents",{"name":9,"slug":8,"type":15},{"name":1534,"slug":1535,"type":15},"Research","research","2026-07-14T05:28:06.816956",{"slug":1538,"name":1538,"fn":1539,"description":1540,"org":1541,"tags":1542,"stars":23,"repoUrl":24,"updatedAt":1548},"amc-run-sample-calibration","run AMC sample dataset calibration","Run end-to-end calibration on the shipped sample dataset (sdg_08_2_sample_data_010926.zip) against a running AMC microservice. Use when user says 'test sample dataset', 'run sample calibration', 'verify AMC install', or 'launch and test'.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1543,1544,1545],{"name":1499,"slug":1500,"type":15},{"name":9,"slug":8,"type":15},{"name":1546,"slug":1547,"type":15},"Testing","testing","2026-07-17T05:29:03.913266",{"slug":1550,"name":1550,"fn":1551,"description":1552,"org":1553,"tags":1554,"stars":23,"repoUrl":24,"updatedAt":1565},"amc-run-video-calibration","calibrate video datasets with AutoMagicCalib","Calibrate a new dataset from pre-recorded video files via the AutoMagicCalib REST API. Use when user has local MP4s and says 'calibrate my videos', 'run AMC on these videos', or similar. For RTSP\u002Flive streams, use amc-run-rtsp-calibration instead.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1555,1558,1561,1562],{"name":1556,"slug":1557,"type":15},"Automation","automation",{"name":1559,"slug":1560,"type":15},"Imaging","imaging",{"name":9,"slug":8,"type":15},{"name":1563,"slug":1564,"type":15},"Video","video","2026-07-17T05:28:53.905004",{"slug":1567,"name":1567,"fn":1568,"description":1569,"org":1570,"tags":1571,"stars":23,"repoUrl":24,"updatedAt":1580},"amc-setup-calibration-stack","deploy AutoMagicCalib microservice with Docker","Launch AutoMagicCalib microservice and web UI from NGC release images via Docker Compose. Use when user says 'deploy auto calibration', 'launch auto calibration', 'launch AMC', 'start MS+UI', or 'set up auto-magic-calib'. Requires NGC API key.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1572,1573,1576,1577],{"name":1516,"slug":1517,"type":15},{"name":1574,"slug":1575,"type":15},"Docker","docker",{"name":9,"slug":8,"type":15},{"name":1578,"slug":1579,"type":15},"Operations","operations","2026-07-17T05:28:56.913999",{"slug":1582,"name":1582,"fn":1583,"description":1584,"org":1585,"tags":1586,"stars":23,"repoUrl":24,"updatedAt":1594},"cudaq-guide","develop quantum applications with CUDA-Q","CUDA-Q onboarding guide for installation, test programs, GPU simulation, QPU hardware, and quantum applications.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1587,1588,1591],{"name":9,"slug":8,"type":15},{"name":1589,"slug":1590,"type":15},"Quantum Computing","quantum-computing",{"name":1592,"slug":1593,"type":15},"Simulation","simulation","2026-07-14T05:26:58.898253",310,{"items":1597,"total":1746},[1598,1616,1630,1641,1653,1667,1680,1694,1705,1714,1728,1737],{"slug":1599,"name":1599,"fn":1600,"description":1601,"org":1602,"tags":1603,"stars":1613,"repoUrl":1614,"updatedAt":1615},"nemoclaw-user-guide","retrieve NemoClaw documentation and configuration","Guides human users' AI agents to the NemoClaw docs MCP server and canonical Fern documentation in Markdown form. Use when users ask how to install, configure, operate, troubleshoot, secure, or learn NemoClaw with an AI coding assistant. Trigger keywords - nemoclaw docs, use nemoclaw with ai agent, nemoclaw mcp docs, nemoclaw install help, nemoclaw quickstart, nemoclaw markdown docs, llms.txt, agent skills.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1604,1607,1610],{"name":1605,"slug":1606,"type":15},"Documentation","documentation",{"name":1608,"slug":1609,"type":15},"MCP","mcp",{"name":1611,"slug":1612,"type":15},"Search","search",21777,"https:\u002F\u002Fgithub.com\u002FNVIDIA\u002FNemoClaw","2026-07-20T06:00:01.461044",{"slug":1617,"name":1617,"fn":1618,"description":1619,"org":1620,"tags":1621,"stars":1627,"repoUrl":1628,"updatedAt":1629},"mcore-build-and-dependency","manage Megatron-LM development environments","Container-based dev environment setup and dependency management for Megatron-LM. Covers acquiring and launching the CI container, uv package management, and updating uv.lock.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1622,1625,1626],{"name":1623,"slug":1624,"type":15},"Containers","containers",{"name":1516,"slug":1517,"type":15},{"name":18,"slug":19,"type":15},17049,"https:\u002F\u002Fgithub.com\u002FNVIDIA\u002FMegatron-LM","2026-07-27T06:06:11.249662",{"slug":1631,"name":1631,"fn":1632,"description":1633,"org":1634,"tags":1635,"stars":1627,"repoUrl":1628,"updatedAt":1640},"mcore-bump-base-image","update NVIDIA PyTorch base images","Bump the NVIDIA PyTorch base image (`nvcr.io\u002Fnvidia\u002Fpytorch:YY.MM-py3`) used by Megatron-LM CI. Covers the two pin sites (GitHub CI in `docker\u002F.ngc_version.dev` and GitLab CI in `.gitlab\u002Fstages\u002F01.build.yml`), the post-bump CI loop (re-run functional tests, refresh golden values, mark broken tests), and the gotchas that bit PRs",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1636,1639],{"name":1637,"slug":1638,"type":15},"CI\u002FCD","ci-cd",{"name":1516,"slug":1517,"type":15},"2026-07-14T05:25:59.97109",{"slug":1642,"name":1642,"fn":1643,"description":1644,"org":1645,"tags":1646,"stars":1627,"repoUrl":1628,"updatedAt":1652},"mcore-cicd","manage CI\u002FCD pipelines for Megatron-LM","CI\u002FCD reference for Megatron-LM. Covers CI pipeline structure, PR scope labels, triggering internal GitLab CI (which force-pushes the current branch to a pull-request\u002FBRANCH ref — always dry-run and verify the destination first; never run against shared or protected branches), and CI failure investigation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1647,1648,1649],{"name":1637,"slug":1638,"type":15},{"name":1516,"slug":1517,"type":15},{"name":1650,"slug":1651,"type":15},"GitHub","github","2026-07-27T06:06:12.278222",{"slug":1654,"name":1654,"fn":1655,"description":1656,"org":1657,"tags":1658,"stars":1627,"repoUrl":1628,"updatedAt":1666},"mcore-create-issue","investigate CI failures and create issues","Investigate a failing GitHub Actions run or job and create a GitHub issue for the failure.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1659,1662,1663],{"name":1660,"slug":1661,"type":15},"Debugging","debugging",{"name":1650,"slug":1651,"type":15},{"name":1664,"slug":1665,"type":15},"Triage","triage","2026-07-14T05:25:57.442089",{"slug":1668,"name":1668,"fn":1669,"description":1670,"org":1671,"tags":1672,"stars":1627,"repoUrl":1628,"updatedAt":1679},"mcore-linting-and-formatting","lint and format Megatron-LM code","Linting and formatting for Megatron-LM. Covers running autoformat.sh, tools (ruff, black, isort, pylint, mypy), and code style rules.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1673,1676],{"name":1674,"slug":1675,"type":15},"Best Practices","best-practices",{"name":1677,"slug":1678,"type":15},"Code Analysis","code-analysis","2026-07-14T05:25:56.18433",{"slug":1681,"name":1681,"fn":1682,"description":1683,"org":1684,"tags":1685,"stars":1627,"repoUrl":1628,"updatedAt":1693},"mcore-migrate-gpt-to-hybrid","migrate Megatron-LM models to HybridModel","Migration guide for moving Megatron Core GPTModel checkpoints, model providers, training commands, and layer mappings to HybridModel.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1686,1689,1692],{"name":1687,"slug":1688,"type":15},"Machine Learning","machine-learning",{"name":1690,"slug":1691,"type":15},"Migration","migration",{"name":9,"slug":8,"type":15},"2026-07-17T06:07:11.777011",{"slug":1695,"name":1695,"fn":1696,"description":1697,"org":1698,"tags":1699,"stars":1627,"repoUrl":1628,"updatedAt":1704},"mcore-onboard-gb200-1node-tests","onboard functional tests for GB200","Onboard 1-node GitHub MR functional tests for GB200 from existing mr-scoped 2-node tests.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1700,1703],{"name":1701,"slug":1702,"type":15},"QA","qa",{"name":1546,"slug":1547,"type":15},"2026-07-14T05:25:53.673039",{"slug":1706,"name":1706,"fn":1707,"description":1708,"org":1709,"tags":1710,"stars":1627,"repoUrl":1628,"updatedAt":1713},"mcore-run-on-slurm","launch distributed training jobs on SLURM","How to launch distributed Megatron-LM training jobs on a SLURM cluster. Covers a minimal sbatch skeleton, environment-variable setup for torch.distributed.run, CUDA_DEVICE_MAX_CONNECTIONS rules across hardware and parallelism modes, container conventions, monitoring, and per-rank failure diagnosis.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1711,1712],{"name":1516,"slug":1517,"type":15},{"name":1519,"slug":1520,"type":15},"2026-07-14T05:25:49.362534",{"slug":1715,"name":1715,"fn":1716,"description":1717,"org":1718,"tags":1719,"stars":1627,"repoUrl":1628,"updatedAt":1727},"mcore-split-pr","split pull requests to reduce review load","Split a PR into multiple PRs to reduce the number of required CODEOWNERS reviewer groups.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1720,1723,1724],{"name":1721,"slug":1722,"type":15},"Code Review","code-review",{"name":1650,"slug":1651,"type":15},{"name":1725,"slug":1726,"type":15},"Pull Requests","pull-requests","2026-07-14T05:26:01.226578",{"slug":1729,"name":1729,"fn":1730,"description":1731,"org":1732,"tags":1733,"stars":1627,"repoUrl":1628,"updatedAt":1736},"mcore-testing","run and manage Megatron-LM tests","Test system for Megatron-LM. Covers test layout, recipe YAML structure, adding and running unit and functional tests, golden values, marker filters, and CI parity.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1734,1735],{"name":1701,"slug":1702,"type":15},{"name":1546,"slug":1547,"type":15},"2026-07-14T05:25:54.928983",{"slug":1738,"name":1738,"fn":1739,"description":1740,"org":1741,"tags":1742,"stars":1627,"repoUrl":1628,"updatedAt":1745},"nightly-sync","manage nightly main-to-dev sync workflows","Domain knowledge for the nightly main-to-dev sync workflow. Covers merge strategy, CI architecture, failure investigation, and known issues.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1743,1744],{"name":1556,"slug":1557,"type":15},{"name":1637,"slug":1638,"type":15},"2026-07-30T05:29:03.275638",525]