Japanese Translation:

Copperhead は、KiCad ファイルを使用してプリント回路基板（PCB）の設計、文書化および検証を安全に自動化するために設計されたオープンソース AI エージェントです。厳格な 8 ステージの「ゲート」ワークフローを採用しており、ディスク上のアティファクトが正常に生成されるまで進行させず、これにより ERC/DRC 準拠を確保し、予算やデータシートなどの制約条件に対して検証済みの提案がない場合の変更を拒否することで設計のドリフトを防ぎます。本ツールは KiCad の s-expression ソースに対する「外科的」なエディットを実行し、差分を小さく見やすくするため、そして Git リポジトリの状態が汚れている場合や未検証部品番号を発明する場合は変更を拒否します。Node 20+ 上でローカルで動作し（

npm i -g copperhead

Open Telegraph によるポケットサイズ ESP32-S3 モースキーの実装と検証

Open Telegraph（エンドツーエンドワークフロー）を活用して、ポケットサイズの ESP32-S3 モースキーを構築しました。すべての判断プロセス、チェック項目、および使用ファイルが公開されています。詳細はビルドストーリーやリポジトリをご確認ください。

実装までの 8 つの段階

copperhead

は以下の 8 つの段階を順次実行し、各段階は独立したエージェントとして動作します。次の段階へ進む前に、ディスク上に成果物（アーティファクト）を残すことが義務付けられています。ゲートチェックに失敗すると、その時点で実行が停止されます。

各段階のゲートチェック項目

01 Spec (
```
docs/SPEC.md
```
)
- ゲート: バジェット（予算）セクションに実際の内容が入力されていること。
02 Architecture (
```
docs/SUBSYSTEMS.md
```
)
- ゲート: すべてのサブシステムについて、論理的な根拠が提示されていること。
03 Parts (
```
docs/BOM.md
```
)
- ゲート: データシートに基づいて部品番号が選択されていること。
04 Schematic (
```
design.kicad_sch
```
)
- ゲート: シンボル配置完了、ドキュメントとの合致、および ERC（電気的規則チェック）のクリア。
05 Layout (
```
design.kicad_pcb
```
)
- ゲート: フットプリント決定、および DRC（設計規則チェック）のクリア。
06 Outputs (
```
gerbers / drill / STEP
```
)
- ゲート: ジーバーデータ、ドリルデータ、STEP ファイルが実際にディスク上に存在すること。
07 Firmware (
```
firmware/
```
&
```
pins.h
```
)
- ゲート: ソースコードの存在と、ピン配置ファイルからのピンプラグインの使用。
08 Dev Plan (
```
docs/DEVPLAN.md
```
)
- ゲート: ブリングアップ（起動）手順とテスト計画が記述されていること。

デザインパッケージ

ジーバーデータ、ファームウェア、ドキュメントを各段階ごとにコミットします。

原則: ディスク上に実際の作業成果物が存在しない限り、コミットは実行しません。
銅枠（Copper Border）: KiCad による検証済み（ERC と DRC クリア）。

長編版：段階的な導入ガイド

独自の実行が困難な場合、有料プランの検討をお勧めします。

Copperhead はオープンコアです

CLI（コマンドラインインターフェース）は常にお無料で利用でき、重要な作業の自動化が保証されます。

支払い対象: ホスティング、チーム協業、または監査人の情報提供のみ。

プラン別特徴

プラン	概要	価格・条件
CLI（無料）	Apache-2.0 ライセンスで永久無料。ご自身のマシン上で動作し、ロックインなし。完全なエージェント機能（ `do` , `create` , `init` , `check` , `watch` ）を実行可能。	API キー用意が必要。 KiCad 出力や GitHub リポジトリをそのまま使用。
コミュニティ	最も人気があり、Web ビューア搭載。ホスティングされた実行、プライベートリポジトリ対応。ライブレンダリング、ERC/DRC ステータス表示、エクスポート機能完備。	$49/ユーザー/月オープンハードウェアリポジトリの場合：無料
チーム	ガバナンスと CI を備えたクラウド環境。組織横断のバージョン管理、SSO/SAML、中央集権課金、プーリングマネージドクレジット。	ユーザー $49 + プラットフォーム $199/月
エンタープライズ	カスタム年間セルフホスト価格。設計データの外部漏洩なし（VPC 展開可能）。 Altium サポート、RBAC、セキュリティ監査証跡付き。	カスタム年間ライセンス営業担当へお問い合わせください。

ご質問への回答

Copperhead とはどのようなものですか？ PCB の設計・ドキュメント化・検証を行うオープンソース AI エージェントです。

変更点の説明や製品概要を受け取ります。
KiCad ファイルを直接編集し、関連ドキュメントを更新します。
KiCad チェックを実行してエラーを解消します。

実際にどのような問題を解決するのですか？ 「ドリフト（不一致）」の問題です。

回路図、BOM、予算、文書などで設計情報が分散すると、同期が取れなくなります。
これにより、ブリングアップ時の不整合が発覚し、リスピニング（再設計・再製造）に 5,000〜50,000 ドルと 6〜8 ヶ月の時間がかかります。

インストールする必要がありますか？ はい、以下の要件が必要です：

Node.js 20 以降
```
kicad-cli
```
（パスに含まれること）
モデル API キー

npm i -g copperhead

既存のデザインでも動作しますか？ はい、それが主な使用ケースです。

```
copperhead init
```
で KiCad リポジトリを指定し変更リクエストを開始します。
```
copperhead create
```
で概要からフルパイプラインを実行することも可能です（反復改善に適しています）。

どのような動作を拒否しますか？

汚染された Git ツリーでは動作しません。
検証済みの変更提案が存在する前に設計ファイルを編集しません。
予算や制約を破る変更を拒否し、違反行を示します。
データシートに基づいて正当化できない部品番号は発明（捏造）しません。

回路図全体を書き換えてしまいますか？ いいえ。

キアドの S-式ソースコードに対する手術的な変更のみを行います。
差分は小さくレビュー可能で、未変更部分はバイト単位で同一です。
ファイル再生成による再構築はレビュー不能となるため避けます。

ドキュメントでは説明できない基板を出荷することは決してありません

copperhead

はオープンソースで無料で使用できます。一度インストールし、望む基板の概要を短い

brief.md

に記述して実行してください。

npm i -g copperhead
export ANTHROPIC_API_KEY=<api-key>
copperhead create --brief brief.md

例：概要（Brief）

プロジェクト: ポケットブルートゥーススピーカー

目標: 1 回の充電で 1 日プレー可能な手のひらサイズ。
コア機能: ESP32、Bluetooth オーディオ（A2DP シンク）。
出力: 4 オームドライバー向けクラス D アンプ 3W。
電源: Li-Po セル、USB-C 充電。
制約: スタンバイ電流予算 100 µA。

Show HN：Copperhead – ハードウェアもソフトウェアループレスに高速なシステム