Skip to content

Keitark/pcba-design-skills / .agents/skills/manage-pcba-program

manage-pcba-program

Verified

Coordinate an evidence-gated electronic product and PCBA workflow from an idea, circuit description, schematic, netlist, PCB, BOM, or fabrication package through a reviewed order. Use for end-to-end requests, multi-stage hardware projects, workflow recovery, gate tracking, change invalidation, or deciding which specialist skill is required next.

FileKindSize
LICENSEother1.0 KB
SKILL.mdskill md3.6 KB
agents/openai.yamlconfig257 B
references/recorded-workflow.mdmarkdown3.9 KB
references/stage-gates.mdmarkdown3.0 KB
scripts/program_state.pyscript10.2 KB
scripts/workflow_record.pyscript13.4 KB

references/recorded-workflow.md

View on GitHub
# Recorded workflow mode

Use this optional mode when the user wants an auditable process recording,
timelapse, case study, tutorial, or promotional demo. It does not weaken any
technical or approval gate.

## Start the recording

From the project root, initialize before the first design action:

```bash
python <skill-dir>/scripts/workflow_record.py init \
  --project <project-id> --stop-before final-submit
```

This creates `.pcba-workflow/events.jsonl`, a session manifest, and separate
directories for public frames, private evidence, and design snapshots. The
event stream is sequence-checked and hash-chained. Every referenced artifact is
SHA-256 checked again during validation and close.

The recorder copies every `--input` and `--output` into a sequence-scoped,
content-addressed file under `.pcba-workflow/snapshots/`. The event retains the
original relative path as provenance, but validates the immutable checkpoint.
This lets working files such as `program-state.json`, product briefs, and native
EDA sources continue to evolve without rewriting history. Never edit or delete
the generated checkpoint copies.

## Record useful checkpoints

Add an event after a saved, inspectable state—not after every mouse movement:

```bash
python <skill-dir>/scripts/workflow_record.py add \
  --stage schematic_visual --action humanize-and-verify \
  --tool schematic-humanizer --gate-status PASS \
  --caption-en "Visible buses replace floating net labels" \
  --caption-ja "浮いたネットラベルを見えるバス配線に整理" \
  --input .pcba-workflow/schematic-before-connectivity.json \
  --output .pcba-workflow/schematic-after-connectivity.json \
  --frame .pcba-workflow/frames/004-schematic-humanized.png
```

Record at least these transitions when applicable:

1. Product brief and architecture block diagram.
2. Sourcing lock and design-critical part decisions.
3. Raw netlist-style schematic render plus connectivity baseline.
4. Humanized all-sheet render, dense-area crops, visual audit, and exact
   connectivity comparison.
5. Initial placement, reviewed placement, routing candidates, rejected
   experiments, final routing, signal layers, DRC, and top/bottom 3D.
6. Gerber, drill, BOM, CPL, render, and release-manifest checkpoints.
7. JLCPCB initial quote, component matching, diagnostic CPL preview, authentic
   correction loops, final placement preview, coupon comparison, compact
   stencil decision, and the page immediately before final submit.

Do not invent a placement, DRC, sourcing, or browser error for the video.
Capture real failures when they occur and record the verified correction.

## Public and private evidence

- `--frame` means promotion-safe media. Crop or redact account name, email,
  address, phone, browser URL/query, quote/order/batch identifiers, cookies,
  tokens, payment data, and unrelated tabs before recording it.
- `--private-evidence` preserves uncropped engineering/order proof but excludes
  it from the promotion frame list.
- Keep editable/native sources and machine reports as `--input` or `--output`.
- It is safe to pass the current working path; the recorder creates the
  immutable checkpoint copy automatically.
- Visually inspect every public raster at full resolution. The recorder can
  detect common sensitive text in captions and filenames, but it cannot prove
  that pixels are private-data-free.

## Finish safely

For a demo that ends near ordering, record the reviewed pre-submit page with
`stage=order_stop` and `gate_status=USER_REVIEW`. Do not click the final submit
or payment action. `stop_before=final-submit` is a recording boundary, not an
authorization to cross it.

Validate throughout and close only after the media index is complete:

```bash
python <skill-dir>/scripts/workflow_record.py validate
python <skill-dir>/scripts/workflow_record.py close
```

A closed session fails validation if an event, frame, snapshot, or referenced
artifact later changes or disappears.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall