rtl-agent-team

한국어 문서: README_kr.md

RTL Agent Team

A Claude Code plugin for automated RTL design and verification. 99 specialized AI agents + 97 skills automate the 6-Phase pipeline: Research → Architecture → μArch → RTL → Verify → Design Note.

A Claude Code plugin for automated RTL design and verification.

Automates the 6-Phase design pipeline (Research → Architecture → μArch → RTL → Verify → Design Note) with 99 specialized AI agents + 97 skills + 27 reference documents.

Marketplace

This repository serves as the RTL Agent Marketplace, providing hardware design plugins.

Plugin	Description	Version
rtl-agent-team	99-agent RTL design pipeline (Research → Architecture → μArch → RTL → Verify → Design Note)	0.14.1
systemverilog-lsp	SystemVerilog/Verilog LSP (slang-server based — diagnostics, hover, go-to-definition, etc.)	1.1.4

Additional plugins (domain knowledge packages, MCP servers, specialized skills, etc.) will be added to the Marketplace over time.

Quick Start

The workflow has three distinct stages, each with a different scope and frequency:

Stage	Scope	Frequency	Commands
A. Machine Setup	Per machine (global)	Once per machine	/plugin install + /rtl-agent-team:rat-setup
B. Project Init	Per project directory	Once per project	/rtl-agent-team:rat-init-project
C. Design Work	Inside project	Recurring	/rtl-agent-team:rat-auto-design, phase/sub-skills

Run each stage from its appropriate working directory: Stage A runs anywhere; Stages B and C should run from inside the target project directory (artifacts like docs/phase-*/, rtl/, .rat/state/ are written relative to CWD).

Stage A — Machine Setup (one-time, per machine)

Installs the plugin, audits the EDA toolchain interactively, and optionally deploys global coding conventions.

# A1. Register the Marketplace (one-time)
/plugin marketplace add babyworm/rtl-agent-team

# A2. Install plugins (one-time)
/plugin install rtl-agent-team
/plugin install systemverilog-lsp   # (optional) SV LSP

# A3. EDA toolchain audit (interactive interview — all steps are opt-in)
#     - Q1 Required tools: python3, g++, make, verilator, cocotb, systemc
#            + lint (verible AND/OR slang — at least one)
#            + CDC (svlens OR sg_shell OR vc_cdc OR questa_cdc — at least one)
#            — prompt to install missing ones (local/global/docker/skip)
#     - Q2 Recommended/optional tools — user picks which to install:
#            jq, yosys + sby, slang-server, iverilog, gtkwave
#     - Q2b Commercial tool scan (vcs, xrun, dc_shell, sg_shell, vc_cdc, ...)
#            — scan + collect env_source; not an install
#     - Q2c Liberty file path for synthesis (optional)
#     - Q3 Optional global deployment (yes/no) — deploys:
#            ~/.claude/rules/rtl-coding-conventions.md
#            ~/.claude/rules/rtl-verification-gate.md
#            ~/.claude/CLAUDE.md diagram rule block (if tag missing)
/rtl-agent-team:rat-setup

If systemverilog-lsp is installed but slang-server is missing, the sub-plugin checks on SessionStart and prompts for local (~/.local/bin, recommended), global, or skip.

Stage B — Project Initialization (one-time, per project)

Scaffolds project directory structure, deploys per-project rules and guides, and auto-installs EDA wrapper scripts. Run from inside the project directory. Existing templates and rules are left intact; managed exceptions are the RAT block in project CLAUDE.md, refreshed tool detection in rat_config.json, and regenerated config.mk. Usable tool path overrides are preserved, while stale or unusable paths are refreshed.

# B1. cd into your project directory
cd ~/work/my-rtl-project

# B2. Initialize project structure (run inside project)
#     - Creates docs/, rtl/, sim/, refc/, lint/, syn/, formal/, reviews/
#     - Deploys .claude/rules/ (coding conventions, verification gate)
#     - Deploys subdirectory CLAUDE.md (phase-specific guides)
#     - Auto-installs run_sim.sh, run_lint.sh, run_syn.sh, run_cdc.sh
#     - Existing templates/rules are not overwritten; managed config is refreshed
/rtl-agent-team:rat-init-project

Stage C — Design Work (recurring, inside project)

Execute RTL design and verification pipeline. Run from inside an initialized project — artifacts are created relative to CWD, so an uninitialized directory will not have the expected structure.

# C1. Full automation (6-Phase pipeline)
/rtl-agent-team:rat-auto-design
# Example natural-language usage:
#   /rtl-agent-team:rat-auto-design "Design an H.264 TQ subsystem"
#   /rtl-agent-team:rat-auto-design "implement VDC-M 1.2 encoder using reference C
#     model in ../vdc-m/refc. Target 4K 60fps at 500MHz, margin 40% under TSMC 28nm"