二人体制ワークフロー
じゅん(管理人) + Cursor(AIエンジニア) の二人で、 ガジェット開発から Hub 公開までを回す手順です。
体制
| じゅん | HW 実装、生の声、すべての GO/NoGO |
|---|---|
| Cursor | コード・Git・Web・記事ドラフト(3キャラ対話)、整合チェック |
Git 正本: リポジトリ内
PUSH 前メモ: Drive
docs/guidelines/project-workflow.mdPUSH 前メモ: Drive
common/COMMON_PROJECT_STATUS.md(セッション引き継ぎ用)
フェーズ一覧
| フェーズ | 目的 | 管理人 GO |
|---|---|---|
| 1 作戦会議 | ゴール・Step・アセット確定 | → フェーズ2 |
| 2 骨組み | Hub HTML/CSS・PIO ディレクトリ | → 3-1 |
| 3-1 プロトタイプ | 機能単位の試作・課題の可視化 | → 3-2(5カテゴリ GO 条件) |
| 3-2 本実装 | HW 統合・記事ドラフト | → フェーズ4 |
| 4 公開 | 同期チェック・push・本番 | 最終 GO |
フェーズ3-1 GO 条件(5カテゴリ)
- A 機能単位の動作証拠(片側ずつでも可)
- B 課題リスト + 対策方針が
docs/logs/にある - C
docs/hardware/{slug}.mdに暫定ピン表 - D 検証ログ + 最小ファームがビルド成功
- E 管理人が本実装路線を1文で宣言
記事の3キャラ
Portfolio の記事構成: 無線ラジコンカー → ミニ①〜⑤ → 各記事は Step 0 から。
呼称の詳細は Git docs/guidelines/terminology.md(内部正本)。
Chocofon(B)
とにかく動かしたい電子工作ビギナー。失敗と配線ミスを記録する現場担当。
AIチューター
B の「やりたい!」をコードと解説に変える伴走エンジニア。
管理人
フェーズ末に GO/NoGO を宣告する影のオーナー。
詳しくは About — 登場人物 |
Hub 記事の CSS クラス: .voice-chocofon / .voice-tutor / .voice-manager
執筆ガイド → Git docs/guidelines/article-template-3char.md
スイムレーン図
編集用 Draw.io(Git 非管理):
Web_html/hub/assets/guides/COMMON_project-workflow-swimlane.drawio
— [diagrams.net](https://app.diagrams.net/) で開き、変更後は .svg を再エクスポートして上記画像を差し替えます。
やってはいけないこと
git add .で一括追加- 管理人 GO なしに push
- AI に「次フェーズへ自律的に進め」と依頼