Skip to content

Add Hardware Repair Companion coworker: appliance & machinery repair with live diagnostics - #593

Open
Hdhaidong wants to merge 3 commits into
andrewyng:mainfrom
Hdhaidong:feat/hardware-repair-companion-coworker
Open

Add Hardware Repair Companion coworker: appliance & machinery repair with live diagnostics#593
Hdhaidong wants to merge 3 commits into
andrewyng:mainfrom
Hdhaidong:feat/hardware-repair-companion-coworker

Conversation

@Hdhaidong

Copy link
Copy Markdown

Summary

Adds Hardware Repair Companion, a new built-in coworker for repairing home appliances and agricultural machinery — live diagnostics, manuals, parts, and maintenance tracking in one persona.

  • Live diagnostics (hardware-link): reads fault codes and telemetry from MHS-connected equipment following the Model Hardware Standard pattern — safety labels first, telemetry as evidence, writes gated behind explicit approval. OBD-II/CAN and BLE service ports come next; when a machine has no digital interface, the manual fallback is named as the normal case, not a failure
  • Symptom diagnosis: structured troubleshooting with safety gates — licensed-professional work gets recommended, not walked through
  • Manual lookup: service manuals, wiring diagrams, exploded parts views from public sources — cited, paywalled gaps named rather than worked around
  • Parts lookup: OEM / aftermarket / used tiers with verified cross-references and model-variant compatibility checks
  • Maintenance log: equipment registry, per-device service history, and due-briefs that flag repair-versus-replace math

Design notes

  • Follows the existing persona bundle shape (manifest.md + skills/), like cloud-posture and security
  • Uses only catalog capabilities (files, search, shell, todo) plus the browser connector — no API keys required
  • Safety-first system prompt: power-off verification, licensed-professional gates for gas / refrigerant / mains work, never bypassing interlocks or guards
  • Hardware writes (through MHS, adapters, or any interface) only with explicit approval, each preceded by what it commands and what could go wrong
  • Recommended model: Claude first, per the creator's intent
  • Validated locally with the repo's own parse_manifest / PersonaRegistry loaders — loads, surfaces in the picker, and skill folders match the declared skills: list

Files

coworker/personas/builtin/hardware-repair-companion/
├── manifest.md
└── skills/
    ├── manual-lookup/SKILL.md
    ├── symptom-diagnosis/SKILL.md
    ├── parts-lookup/SKILL.md
    ├── hardware-link/SKILL.md
    └── maintenance-log/SKILL.md

Created by Hdhaidong — custom business-agent creator. Happy to iterate on the prompt, skills, or tool grants based on maintainer feedback.

A repair companion for home appliances and agricultural machinery. Walks structured symptom diagnosis with safety gates, reads live fault codes and telemetry from MHS-connected equipment when available, finds service manuals and part numbers from public sources, and keeps a per-device maintenance log. No API keys required - works from the web.

- manifest with safety-first system prompt (licensed-professional gates, hardware writes gated behind explicit approval)
- 5 skills: manual-lookup, symptom-diagnosis, parts-lookup, hardware-link, maintenance-log
- hardware-link follows the Model Hardware Standard (MHS) pattern: read safety labels first, read telemetry as evidence, writes with approval
- validated with the repo's own manifest parser and PersonaRegistry

Created by Hdhaidong, custom business-agent creator.
Adds the domain-profiles skill: household, garden, outdoor, agriculture, laboratory, medical, private clinic, and dental - each with its own safety gates, documentation sources, and escalation posture. The working loop now classifies the domain first, and the maintenance registry carries a domain field with domain-appropriate usage counters (hours, cycles, seasons).

Medical, clinic, and dental patient-contact equipment is triage-and-handoff by design: the persona documents and routes to certified service instead of walking users through regulated device repair.
Adds the domain-profiles skill: household, garden, outdoor, agriculture, laboratory, medical, private clinic, dental, and fire safety & protection - each with its own safety gates, documentation sources, and escalation posture. The working loop now classifies the domain first, and the maintenance registry carries a domain field with domain-appropriate usage counters (hours, cycles, seasons, inspection dates).

Medical, clinic, and dental patient-contact equipment is triage-and-handoff by design: the persona documents and routes to certified service instead of walking users through regulated device repair. Fire safety and protection is the strictest hand-off domain: compliance tracking and immediate professional routing - extinguishers and suppression systems never get DIY-repaired.
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.

1 participant