{"owner":"The-OpenROAD-Project","repo":"OpenROAD","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md"],"skills":{"AGENTS.md":"# OpenROAD - AI agent context\n\nThis file provides project-specific guidance for AI agent sessions working on the OpenROAD codebase.\n\n## Quick Reference\n\nDetailed guides are in `docs/agents/` subdirectory:\n\n- **Build Pitfalls**: See `docs/agents/build.md`\n- **Testing Guide**: See `docs/agents/testing.md`\n- **Git & CI**: See `docs/agents/ci.md`\n- **Coding Patterns**: See `docs/agents/coding.md`\n\n## Critical Rules\n\n1. **Ask before modifying `src/sta/` files** -- OpenSTA is managed upstream (`Sdc.cc`, `Power.cc`, `Sdc.tcl`, etc.). Prefer fixes in OpenROAD code (e.g., src/dbSta/, src/rsz/) when possible. \n2. Run `clang-format -i <files>` for C++ files before commit. **NEVER** for `src/sta/*` and `*.i` files.\n3. **Always use `git commit -s`** for DCO compliance.  Do not review DCO compliance; CI handles it.\n4. When amending submodule commits, parent repo submodule reference must also be updated via `git submodule update --init --recursive`. It is needed after any merge/pull.\n5. **Trace bugs upstream** -- when a bug appears in output (e.g., Verilog), find the data creation point (e.g., `buffer_ports`, `remove_buffers`), not the serialization point (e.g., `VerilogWriter`).\n\n## AI Agent Skills\n\nSkills are located in `.agents/skills/` (with `.claude/skills` symlink for Claude Code).\n\n| Skill | Purpose | Invocation |\n|-------|---------|------------|\n| `triage-issue` | Reproduce bug and minimize test case with whittle.py | `/triage-issue <issue#>` |\n| `fix-bug` | Trace root cause, implement fix, create tests, prepare commit | `/fix-bug <issue#-or-error-code>` |\n| `add-test` | Add integration/unit tests with dual CMake+Bazel registration | `/add-test <module> [description]` |\n| `review-pr` | Draft local PR review notes (correctness > QoR > testing); human posts | `/review-pr <pr#-or-url>` |\n"},"files":{"AGENTS.md":"# OpenROAD - AI agent context\n\nThis file provides project-specific guidance for AI agent sessions working on the OpenROAD codebase.\n\n## Quick Reference\n\nDetailed guides are in `docs/agents/` subdirectory:\n\n- **Build Pitfalls**: See `docs/agents/build.md`\n- **Testing Guide**: See `docs/agents/testing.md`\n- **Git & CI**: See `docs/agents/ci.md`\n- **Coding Patterns**: See `docs/agents/coding.md`\n\n## Critical Rules\n\n1. **Ask before modifying `src/sta/` files** -- OpenSTA is managed upstream (`Sdc.cc`, `Power.cc`, `Sdc.tcl`, etc.). Prefer fixes in OpenROAD code (e.g., src/dbSta/, src/rsz/) when possible. \n2. Run `clang-format -i <files>` for C++ files before commit. **NEVER** for `src/sta/*` and `*.i` files.\n3. **Always use `git commit -s`** for DCO compliance.  Do not review DCO compliance; CI handles it.\n4. When amending submodule commits, parent repo submodule reference must also be updated via `git submodule update --init --recursive`. It is needed after any merge/pull.\n5. **Trace bugs upstream** -- when a bug appears in output (e.g., Verilog), find the data creation point (e.g., `buffer_ports`, `remove_buffers`), not the serialization point (e.g., `VerilogWriter`).\n\n## AI Agent Skills\n\nSkills are located in `.agents/skills/` (with `.claude/skills` symlink for Claude Code).\n\n| Skill | Purpose | Invocation |\n|-------|---------|------------|\n| `triage-issue` | Reproduce bug and minimize test case with whittle.py | `/triage-issue <issue#>` |\n| `fix-bug` | Trace root cause, implement fix, create tests, prepare commit | `/fix-bug <issue#-or-error-code>` |\n| `add-test` | Add integration/unit tests with dual CMake+Bazel registration | `/add-test <module> [description]` |\n| `review-pr` | Draft local PR review notes (correctness > QoR > testing); human posts | `/review-pr <pr#-or-url>` |\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# OpenROAD - AI agent context\n\nThis file provides project-specific guidance for AI agent sessions working on the OpenROAD codebase.\n\n## Quick Reference\n\nDetailed guides are in `docs/agents/` subdirectory:\n\n- **Build Pitfalls**: See `docs/agents/build.md`\n- **Testing Guide**: See `docs/agents/testing.md`\n- **Git & CI**: See `docs/agents/ci.md`\n- **Coding Patterns**: See `docs/agents/coding.md`\n\n## Critical Rules\n\n1. **Ask before modifying `src/sta/` files** -- OpenSTA is managed upstream (`Sdc.cc`, `Power.cc`, `Sdc.tcl`, etc.). Prefer fixes in OpenROAD code (e.g., src/dbSta/, src/rsz/) when possible. \n2. Run `clang-format -i <files>` for C++ files before commit. **NEVER** for `src/sta/*` and `*.i` files.\n3. **Always use `git commit -s`** for DCO compliance.  Do not review DCO compliance; CI handles it.\n4. When amending submodule commits, parent repo submodule reference must also be updated via `git submodule update --init --recursive`. It is needed after any merge/pull.\n5. **Trace bugs upstream** -- when a bug appears in output (e.g., Verilog), find the data creation point (e.g., `buffer_ports`, `remove_buffers`), not the serialization point (e.g., `VerilogWriter`).\n\n## AI Agent Skills\n\nSkills are located in `.agents/skills/` (with `.claude/skills` symlink for Claude Code).\n\n| Skill | Purpose | Invocation |\n|-------|---------|------------|\n| `triage-issue` | Reproduce bug and minimize test case with whittle.py | `/triage-issue <issue#>` |\n| `fix-bug` | Trace root cause, implement fix, create tests, prepare commit | `/fix-bug <issue#-or-error-code>` |\n| `add-test` | Add integration/unit tests with dual CMake+Bazel registration | `/add-test <module> [description]` |\n| `review-pr` | Draft local PR review notes (correctness > QoR > testing); human posts | `/review-pr <pr#-or-url>` |\n","category":"root","tokens":453}]}