FallenSigh
8fdf944555
- sync_rtl/common/: skid_buffer, pipeline_reg, defines (valid/ready) - sync_rtl/mod_add/: modular adder example with Verilator C++ TB - test_framework/: Python-driven Verilator compile/sim/compare pipeline - test_framework/modules/mod_add/: 50-vector test plan, full鏈路 PASS - .trellis/spec/: RTL and test_framework conventions documented
40 lines
1.3 KiB
Markdown
40 lines
1.3 KiB
Markdown
# Frontend Development Guidelines
|
|
|
|
> Best practices for frontend development in this project.
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
This directory contains guidelines for frontend development. Fill in each file with your project's specific conventions.
|
|
|
|
---
|
|
|
|
## Guidelines Index
|
|
|
|
| Guide | Description | Status |
|
|
|-------|-------------|--------|
|
|
| [Directory Structure](./directory-structure.md) | Module organization and file layout | To fill |
|
|
| [Component Guidelines](./component-guidelines.md) | Component patterns, props, composition | To fill |
|
|
| [Hook Guidelines](./hook-guidelines.md) | Custom hooks, data fetching patterns | To fill |
|
|
| [State Management](./state-management.md) | Local state, global state, server state | To fill |
|
|
| [Quality Guidelines](./quality-guidelines.md) | Code standards, forbidden patterns | To fill |
|
|
| [Type Safety](./type-safety.md) | Type patterns, validation | To fill |
|
|
|
|
---
|
|
|
|
## How to Fill These Guidelines
|
|
|
|
For each guideline file:
|
|
|
|
1. Document your project's **actual conventions** (not ideals)
|
|
2. Include **code examples** from your codebase
|
|
3. List **forbidden patterns** and why
|
|
4. Add **common mistakes** your team has made
|
|
|
|
The goal is to help AI assistants and new team members understand how YOUR project works.
|
|
|
|
---
|
|
|
|
**Language**: All documentation should be written in **English**.
|