project-structure
Materialized view of observed project reality for user project. Discovers and documents project root, modules, worktrees, branches, system/module boundaries, SCUDs, component libraries, circuit sources, and evaluation logs. Trigger when navigating the project filesystem, locating artifacts, or understanding current project structure.
- License 许可
- GPL-2.0
- 最近更新
- 2026-08-23
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- project-structure
- description
- Materialized view of observed project reality for user project. Discovers and documents project root, modules, worktrees, branches, system/module boundaries, SCUDs, component libraries, circuit sources, and evaluation logs. Trigger when navigating the project filesystem, locating artifacts, or understanding current project structure.
02 资源文件 2
- 参考文档SKILL.template.md2.2 KB
- 脚本tools/generate_project_structure.py13.5 KB
03 SKILL.md 正文
Project Structure
This Engineering Capability Package (ECP) is a materialized view of observed project reality generated directly from the project filesystem and Git metadata. It exposes what actually exists in the project without making semantic assumptions or modifying project files.
<!-- GENERATED:BEGIN PROJECT_STRUCTURE -->
1. Project Overview
- Project ID / Name:
bms-project_e0505ca9 - Project Container Root:
/home/vivekv/Documents/three-wise-monkeys/crazy_orca/Use-case/bms/module-integration-dry-run/bms-project-v0.3/bms-project_e0505ca9 - Root Assembly Worktree:
bms-project_e0505ca9_root - VHL State Database:
.vhl/state.db - Discovered Modules Count: 6
- Component Library Count: 43 components in
imports/
2. Git Worktrees & Workspace Mapping
In VHL, each module operates inside its own isolated Git worktree and branch, sharing the underlying repository object database:
| Module / Context | Worktree Path | Git Branch | Role |
|---|---|---|---|
| Top-Level Assembly | bms-project_e0505ca9_root |
master |
System assembly & root worktree |
bms-monitor-module |
../../bms-project_e0505ca9/bms-project_e0505ca9_bms-monitor-module |
bms-monitor-module_branch |
Module workspace |
communication-bridge |
../../bms-project_e0505ca9/bms-project_e0505ca9_communication-bridge |
communication-bridge_branch |
Module workspace |
current-sensing |
../../bms-project_e0505ca9/bms-project_e0505ca9_current-sensing |
current-sensing_branch |
Module workspace |
high-voltage-power-supply |
../../bms-project_e0505ca9/bms-project_e0505ca9_high-voltage-power-supply |
high-voltage-power-supply_branch |
Module workspace |
low-voltage-power-supply |
../../bms-project_e0505ca9/bms-project_e0505ca9_low-voltage-power-supply |
low-voltage-power-supply_branch |
Module workspace |
microcontroller-module |
../../bms-project_e0505ca9/bms-project_e0505ca9_microcontroller-module |
microcontroller-module_branch |
Module workspace |
3. Discovered Modules & Artifacts
3.1 bms-monitor-module
- Module Root Path:
bms-project_e0505ca9_root/bms-monitor-module - Worktree Path:
../../bms-project_e0505ca9/bms-project_e0505ca9_bms-monitor-module - Git Branch:
bms-monitor-module_branch - SCUD Artifacts:
Workspace/bms-monitor-module.scud,bms-monitor-module.scud - Circuit Source (.tsx):
Workspace/bms-monitor-module.tsx,bms-monitor-module.tsx - Boundary Specs:
Workspace/resources/bms-monitor-module-boundary.md,Workspace/system-boundary.md - Workspace Resources:
BQ79616-eval-board.md,bms-monitor-module-boundary.md,bq79616-datasheet.md - Evaluation Logs:
Workspace/evaluation_results/eval.logpresent
3.2 communication-bridge
- Module Root Path:
bms-project_e0505ca9_root/communication-bridge - Worktree Path:
../../bms-project_e0505ca9/bms-project_e0505ca9_communication-bridge - Git Branch:
communication-bridge_branch - SCUD Artifacts:
Workspace/communication-bridge.scud,communication-bridge.scud - Circuit Source (.tsx):
Workspace/communication-bridge.tsx,communication-bridge.tsx - Boundary Specs:
Workspace/resources/communication-bridge-boundary.md,Workspace/system-boundary.md - Workspace Resources:
BQ79600-eval-board.md,bq79600-q1-datasheet.md,communication-bridge-boundary.md - Evaluation Logs:
Workspace/evaluation_results/eval.logpresent
3.3 current-sensing
- Module Root Path:
bms-project_e0505ca9_root/current-sensing - Worktree Path:
../../bms-project_e0505ca9/bms-project_e0505ca9_current-sensing - Git Branch:
current-sensing_branch - SCUD Artifacts:
Workspace/current-sensing.scud,current-sensing.scud - Circuit Source (.tsx):
Workspace/current-sensing.tsx,current-sensing.tsx - Boundary Specs:
Workspace/resources/current-sensing-boundary.md,Workspace/system-boundary.md - Workspace Resources:
amc1301-datasheet.md,amc130x-eval-board.md,current-sensing-boundary.md - Evaluation Logs:
Workspace/evaluation_results/eval.logpresent
3.4 high-voltage-power-supply
- Module Root Path:
bms-project_e0505ca9_root/high-voltage-power-supply - Worktree Path:
../../bms-project_e0505ca9/bms-project_e0505ca9_high-voltage-power-supply - Git Branch:
high-voltage-power-supply_branch - SCUD Artifacts:
Workspace/high-voltage-power-supply.scud,high-voltage-power-supply.scud - Circuit Source (.tsx):
Workspace/high-voltage-power-supply.tsx - Boundary Specs:
Workspace/resources/high-voltage-power-supply-boundary.md,Workspace/system-boundary.md - Workspace Resources:
high-voltage-power-supply-boundary.md,ucc28881-datasheet.md,ucc28881-eval-board.md - Evaluation Logs:
Workspace/evaluation_results/eval.logpresent
3.5 low-voltage-power-supply
- Module Root Path:
bms-project_e0505ca9_root/low-voltage-power-supply - Worktree Path:
../../bms-project_e0505ca9/bms-project_e0505ca9_low-voltage-power-supply - Git Branch:
low-voltage-power-supply_branch - SCUD Artifacts:
Workspace/low-voltage-power-supply.scud,low-voltage-power-supply.scud - Circuit Source (.tsx):
Workspace/low-voltage-power-supply.tsx - Boundary Specs:
Workspace/resources/low-voltage-power-supply-boundary.md,Workspace/system-boundary.md - Workspace Resources:
low-voltage-power-supply-boundary.md,ucc28750-datasheet.md,ucc28750-eval-board.md - Evaluation Logs:
Workspace/evaluation_results/eval.logpresent
3.6 microcontroller-module
- Module Root Path:
bms-project_e0505ca9_root/microcontroller-module - Worktree Path:
../../bms-project_e0505ca9/bms-project_e0505ca9_microcontroller-module - Git Branch:
microcontroller-module_branch - SCUD Artifacts:
Workspace/microcontroller-module.scud,microcontroller-module.scud - Circuit Source (.tsx):
Workspace/microcontroller-module.tsx,microcontroller-module.tsx - Boundary Specs:
Workspace/resources/stm32-microcontroller-module-boundary.md,Workspace/system-boundary.md - Workspace Resources:
STM32F411CEU6_reference_manual.md,STM32F411_pin_functions_map.csv,stm32-microcontroller-module-boundary.md,stm32f411ce_datasheet.md - Evaluation Logs:
Workspace/evaluation_results/eval.logpresent
4. System Assembly & Global Project Artifacts
- System Boundary Contract:
bms-project_e0505ca9_root/system-boundary.md - Top-Level Assembly Entry Circuit:
bms-project_e0505ca9_root/index.circuit.tsx - Sub-Assembly Circuits:
control_circuit.tsx,power_circuit.tsx - Boundary Alignment & Reconciliation Artifacts:
bms-monitor-module-boundary-alignment-changes.mdboundary_alignment_document.mdboundary_reconciliation_changes.mdsystem-boundary.md
- Component Imports Library (
imports/): 43 components available- Sample components:
ACT45B_101_2P_TL003.tsx,AMC1301DWVR.tsx,ATL431LIBQDBZR.tsx,BQ79600PWRQ1.tsx,BQ79616PAPRQ1.tsx,BSMD0603_010_33V.tsx,EGD2WM100G16OT.tsx,F0603FA0500V063TM.tsx,FODM217AR2.tsx,HMU1228NLT_CND.tsx, ... (+33 more)
- Sample components:
- Project Configurations:
.gitignore,.npmrc,package-lock.json,package.json,tscircuit.config.json,tsconfig.json
<!-- GENERATED:END PROJECT_STRUCTURE -->
Architectural Concept Links
The observed project reality maps directly to foundational VHL architectural concepts:
- Modules & Assemblies: Discovered module directories and top-level
.tsxassembly files follow VHL Modules and Assemblies Concept. - Interface Boundaries: System boundary and module boundary documents follow VHL Interface Boundary Concept.
- Git Worktrees: The worktree workspaces and branch mappings follow VHL Git Worktree Workspace Isolation Concept.
- SCUDs: Discovered
.scudartifacts follow VHL Shared Circuit Understanding Document Concept.
PEC Maintenance & Feedback Loop
This PEC is a materialized view of project state, not a static hand-authored document.
Project Reality ──> Generator ──> Project ECP (SKILL.md) ──> Agent Understanding ──> Agent Modifies Project ──> Regenerate
Whenever project reality changes (e.g. new modules created, worktrees modified, boundaries updated), re-run the generator tool:
python3 .agents/Project_Structure/tools/generate_project_structure.py --project-dir .
04 同仓库更多 Skills
cypress-tuning
Systematically diagnoses, tunes, and executes Cypress GPU-accelerated PCB placement optimization runs. Trigger when running DREAMPlace/Cypress component placement, diagnosing placement divergence or clumping, or tuning wirelength, density, rotation, and net crossing parameters.
circuitjson-bookshelf-converter
Converts Circuit JSON PCB and schematic designs into Bookshelf physical design format (.nodes, .nets, .pl, .scl, .aux) with courtyard keep-out boundary modeling, and back-annotates Cypress placement optimization results back into Circuit JSON. Trigger this skill whenever converting circuit.json files to Bookshelf format or back-annotating .pl / .gp.pl placement outputs into Circuit JSON.
circuit-json-analysis
Analyzes Circuit JSON files for structural component relationships, domain mappings (source, schematic, pcb, cad), and geometric layout DRC violations (courtyard overlaps, solder paste misalignments, pad clearances). Trigger this skill whenever analyzing a circuit.json file, inspecting PCB placement, or performing design rule checks on Circuit JSON data.
vhl-concepts
Architectural foundation for Virtual Hardware Laboratory (VHL). Explains the four fundamental VHL concepts (Module vs Assembly, Interface Boundary, Git Worktree Workspace Isolation, and Shared Circuit Understanding Document), why VHL uses them, their core invariants, and when an agent must reason about them. Trigger this skill whenever reasoning about VHL architecture, defining boundaries, identifying module/assembly scope, or referencing SCUD artifacts.
SCUD
暂无简介
Module_Synthesis
暂无简介