Skip to content

Add mechanical-engineer persona, enclosure-design-review protocol, and review-enclosure template#110

Merged
Alan-Jowett merged 2 commits intomicrosoft:mainfrom
Alan-Jowett:add-mechanical-engineer
Mar 29, 2026
Merged

Add mechanical-engineer persona, enclosure-design-review protocol, and review-enclosure template#110
Alan-Jowett merged 2 commits intomicrosoft:mainfrom
Alan-Jowett:add-mechanical-engineer

Conversation

@Alan-Jowett
Copy link
Copy Markdown
Member

Summary

Closes #109 — adds mechanical engineering capability for electronics enclosure design review. PromptKit's fourth engineering domain (software → electrical → RF → mechanical).

New Components

Type Name Path Description
Persona mechanical-engineer personas/mechanical-engineer.md Enclosures, 3D printing DFM, materials, thermal, IP ratings
Protocol enclosure-design-review protocols/analysis/enclosure-design-review.md 7-phase enclosure review
Template review-enclosure templates/review-enclosure.md Audit enclosure against PCB specs + requirements

Protocol Phases

  1. PCB fit and clearance verification (dimensions, standoffs, component heights, connector access)
  2. Environmental protection assessment (IP rating, sealing, UV resistance, condensation)
  3. Thermal management review (heat sources, thermal path, ventilation vs sealed)
  4. Antenna and RF compatibility (material transparency, keepout zone, orientation)
  5. Sensor access and integration (ventilation, cable pass-throughs, conflicting requirements)
  6. Manufacturing feasibility (3D printing DFM: wall thickness, overhangs, tolerances, material spec)
  7. Mounting and deployment (mounting features, serviceability, labeling)

Cross-Domain Design

The protocol explicitly addresses cross-domain concerns:

  • ME × EE: thermal dissipation from PCB components through enclosure
  • ME × RF: material RF transparency, antenna keepout preservation
  • ME × application: sensor access vs environmental sealing tradeoff

Checklist

  • All files have SPDX license headers
  • YAML frontmatter is valid and complete
  • Component names match file names (kebab-case)
  • manifest.yaml updated
  • Protocols have numbered, ordered phases
  • Templates have a quality checklist section
  • python tests/validate-manifest.py passes

…d review-enclosure template

Closes microsoft#109 — adds mechanical engineering capability for electronics
enclosure design review.

- Persona: mechanical-engineer — enclosure design, 3D printing DFM,
  material selection (PLA/PETG/ASA/ABS), thermal management,
  environmental protection (IP ratings), mounting and fastening,
  sensor integration, and RF considerations in enclosure design.

- Protocol: enclosure-design-review (analysis) — 7-phase methodology
  covering PCB fit and clearance, environmental protection (IP rating,
  UV, condensation), thermal management, antenna/RF compatibility,
  sensor access, manufacturing feasibility (FDM-specific), and
  mounting/deployment.

- Template: review-enclosure — audits enclosure design against PCB
  specs, requirements, and manufacturing constraints. Cross-domain
  verification (ME × EE × RF).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings March 29, 2026 17:25
@Alan-Jowett Alan-Jowett requested review from Copilot and removed request for Copilot March 29, 2026 20:00
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new mechanical engineering capability to PromptKit for reviewing electronics enclosure designs, extending the library’s engineering-domain coverage to include enclosure fit/DFM/thermal/environmental/RF integration.

Changes:

  • Added a mechanical-engineer persona focused on enclosure design for electronics, materials, DFM, and cross-domain integration.
  • Added an enclosure-design-review analysis protocol with 7 structured phases for enclosure audits.
  • Added a review-enclosure template that composes the new persona + protocol and outputs an investigation-report; updated manifest.yaml to register all new components.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
personas/mechanical-engineer.md Introduces the mechanical engineer persona with domain focus and behavioral constraints aligned to existing persona structure.
protocols/analysis/enclosure-design-review.md Adds a 7-phase analysis protocol for enclosure reviews (fit, environmental, thermal, RF, sensors, manufacturing, mounting).
templates/review-enclosure.md Adds a new template that applies the protocol and produces an investigation report tailored to enclosure audits.
manifest.yaml Registers the new persona, protocol, and template so the bootstrap/assembly flow can discover them.

- Add Phase 5 (Sensor Access) explicit checklist item — was the only
  phase without a dedicated verification line
- Add output spot-check to self-verification (re-read at least 3
  findings) per self-verification protocol convention

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@Alan-Jowett Alan-Jowett merged commit 1137347 into microsoft:main Mar 29, 2026
2 checks passed
@Alan-Jowett Alan-Jowett deleted the add-mechanical-engineer branch March 29, 2026 20:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add mechanical engineer persona and enclosure design review protocol

2 participants