AGENT SKILL

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

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.log present

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.log present

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.log present

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.log present

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.log present

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.log present

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.md
    • boundary_alignment_document.md
    • boundary_reconciliation_changes.md
    • system-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)
  • 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:

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

vivekvjnk
vivekvjnk/three-wise-monkeys

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.

★ 0
vivekvjnk
vivekvjnk/three-wise-monkeys

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.

Skill与智能体开发
★ 0
vivekvjnk
vivekvjnk/three-wise-monkeys

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.

Skill与智能体开发
★ 0
vivekvjnk
vivekvjnk/three-wise-monkeys

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.

文档处理Skill与智能体开发
★ 0
vivekvjnk
vivekvjnk/three-wise-monkeys

SCUD

暂无简介

★ 0
vivekvjnk
vivekvjnk/three-wise-monkeys

Module_Synthesis

暂无简介

★ 0