rat-init-project

What problem does it solve?

New RTL projects often lack a consistent directory layout, coding rules, build scripts, and EDA configuration, which causes automation agents and toolchains to fail or behave inconsistently. This skill prepares a project workspace with the expected 6-Phase pipeline structure, enforces non-destructive idempotent setup, and prevents missing-file and rule-deployment errors that block downstream design and verification work.

Core Features & Use Cases

• Directory scaffolding: Creates standard folders (rtl, sim, syn, lint, docs, reviews, .rat/state, etc.) only when missing.
• Rule and guide deployment: Installs .claude/rules and per-directory CLAUDE.md guides without overwriting global or user-modified files.
• Template & script installation: Idempotently copies Makefile, filelist template, cocotb Makefile, EDA runner scripts and a tool-runner library.
• Project config and CLAUDE injection: Generates rat_config.json by detecting available EDA tools and injects or updates a RAT-managed section in CLAUDE.md.
• Safety and reporting: Non-destructive policy, quick EDA tool status checks, and a final project initialization report summarizing created artifacts and missing tools.
• Use case: Initialize an empty repository for FPGA or ASIC development so agents can run Phase 1–6 workflows without manual setup.

Quick Start

Run the rat-init-project skill to initialize the current directory with the standard RTL project layout, deploy rules and guides, install templates and scripts, and generate the project configuration.