SuperAPI AI Directory

soc-build

Coding & development

View repository

Updated 10-16 06:14

About this skill

SoC Build

Use the registered soc-build MCP server. Do not import its FastMCP object directly and do not replace EDA tool calls with shell commands.

Runtime setup

Plugin manifests already register the MCP servers. If the launcher reports missing Python modules, run:

<plugin-root>/scripts/setup_mcp_env.sh

This installs the shared runtime under ${XDG_CACHE_HOME:-$HOME/.cache}/silicon-crew/venv, outside the plugin package. Do not package .venv.

Canonical project layout

Every chip module and IP uses the same structure:

<module>/
├── docs/
├── de/rtl/          # RTL + filelist.f/filelist.mk
├── de/lint/         # lint configuration or reviewed collateral
├── de/cdc/          # CDC configuration or reviewed collateral
├── de/formal/       # formal configuration or reviewed collateral
├── de/run/          # transient lint/build output
├── de/syn/          # SDC, synthesis and STA output
├── dv/tb/           # testbench source
├── dv/verif/        # reusable verification source
├── dv/tests/        # regression test lists
├── dv/sim/          # simulation logs/images/waves
├── dv/cov/          # coverage databases/reports
└── Makefile

Pipeline artifacts remain restricted to docs/, de/rtl/, de/run/, de/syn/, dv/tb/, and dv/sim/; the additional directories are reserved for their specialized flow configuration and collateral.

Create structure with soc_init, soc_add_chip, or soc_add_ip. Do not create legacy root rtl/, sim/, syn/, or constraints/ directories.

Tools

Tool Purpose
soc_init initialize a SoC project
soc_add_chip add a chip module
soc_add_ip add a digital/third-party IP
soc_flist generate a Verilog/SystemVerilog filelist
soc_lint project-filelist lint; accepts rtl_top
soc_comp compile; accepts top_module
soc_sim compile then simulate; accepts simulator/test/seed/top
soc_regress test/seed matrix regression
soc_coverage single or regression coverage
soc_syn project-filelist Yosys synthesis; accepts rtl_top

All names, simulators, tests, seeds, and job counts are validated. A nonzero process exit or timeout is an MCP tool error.

Stage use

  • RTL agents call soc_lint; no direct Verilator/Icarus fallback.
  • Verification agents call soc_sim or soc_regress; no direct Make/simulator fallback.
  • Synthesis agents call soc_syn; Yosys output is not STA evidence.
  • Commercial simulator/license work must remain in the registered MCP process.

For Verilog code review, read references/verilog_coding_style.md and report mandatory, recommended, and advisory findings with file/line evidence.