project-engineering

プロジェクトエンジニアリング

HeyEddi の Vue アプリ向けの基本的なコードエンジニアリングです。Flutter フロントエンドには、代わりに @flutter-engineering を使用してください。適用するスタックを検出し、適切なツールを追加します。一律の方式ではありません。

サブエージェント（デフォルト）

スキャフォールド／監査／テストスクリプトは Task shell に、リポジトリの調査は explore に委任します。メインチャットで監査 JSON からスタックを選択します。reference/subagents.md を参照してください。

スタック

スタック	適用する場面	追加されるツール
Vue	フロントエンドの作業では常に	Vite、Vitest、npm スクリプト、ルーター
FastAPI	REST API バックエンド	backend/、pytest、openapi.json、uvicorn
Firebase	Firestore／Auth クライアント	firebase.json、ルール、エミュレーター、環境変数テンプレート

@heyeddi-setup で設定の希望を宣言します（git／環境＋エージェント）。.heyeddi/stack.json の技術キーは、プロジェクトの進行に応じてスキャフォールド／このスキルによって入力されます。

{
  "frontend": "vue",
  "backends": ["fastapi"],
  "api_port": 8090,
  "web_port": 8085,
  "git": {
    "preset": "main_staging_dev",
    "default_branch": "dev",
    "pr_base": "dev",
    "environments": { "production": "main", "staging": "staging", "dev": "dev" },
    "worktrees": false,
    "custom_workflow": null
  },
  "agent": { "commit": "ask", "push": "ask" },
  "setup": { "version": 1, "updated": "2026-09-06" }
}

{ "frontend": "vue", "backends": ["fastapi"], "api_port": 8090 }

Flutter プロジェクトの場合は、"frontend": "flutter"、"web_port": 8085 を設定してください。@flutter-engineering を参照してください。

または "backends": ["firebase"]、あるいは ["fastapi", "firebase"] を設定します。
audit_scaffold は openapi.json、firestore.rules、.heyeddi/product.md（または従来の PRODUCT.md）からも推測します。

.heyeddi/ ワークスペース

すべての HeyEddi アプリに .heyeddi/ フォルダーが必要です（scaffold_stack／scaffold_heyeddi によって作成されます）。

パス	目的
README.md	HeyEddi の概要（エージェントと人間のためのワークスペース）、無料のスキル、heyeddi.com/humans
stack.json	スタック＋設定（@heyeddi-setup）
product.md	プロダクト概要
design.md	DESIGN.md 形式：トークン、根拠、意思決定ログ
designs/<feature>/	引き継ぎ用 PNG、概要、ワイヤーフレーム
docs/	スキルが生成するレポート（リリース、PR の追跡、乖離監査）

スキルが作成したドキュメントはすべて .heyeddi/docs/（または上記のパス）に保存してください。チームが後から参照できます。ルートにある PRODUCT.md／DESIGN.md／designs/ も、従来のフォールバックとして引き続きサポートされます。

ワークフロー

1. 設定ゲート（常時有効の必須項目）： git／CI／コミットに関する前提を置く前に、@heyeddi-setup の verify_setup --check を実行します。不完全な場合は、合格するまでセットアップを実行します。
2. audit_scaffold：レイヤーごとの JSON（vue／fastapi／firebase）。
3. scaffold_stack --stack auto：不足分を補います（scaffold_vue 単独より推奨）。
4. 必要に応じて ensure_npm ＋ ensure_python。
5. dev_server_info：ローカルサーバーをすべて表示します（Vue :5173、API :8090、Firebase エミュレーター :4000）。
6. 計画ゲート（常時有効）： 機能コードを書く前に @engineering-excellence の check_engineering_plan --check を実行し、再利用カタログを確認します。
7. 機能を実装します（デザインスキル、コンポーザブルなど）。
8. write_test_stub ＋ run_tests ＋ run_backend_tests。
9. 変更ゲート（常時有効）： audit_engineering --check を実行します（エラーは失敗扱い、警告は参考情報）。
10. verify-build ＋ pre-merge-gate。

ローカル開発サーバー

スタック	コマンド	URL
Vue	npm run dev	http://localhost:5173
FastAPI	cd backend && poetry run uvicorn app.main:app --reload --port 8090	http://localhost:8090/docs
Firebase	firebase emulators:start	http://localhost:4000 (UI)

プロジェクト固有の手順は dev_server_info を実行して確認してください。各サーバーには専用のターミナルが必要です。

参考資料

• reference/dev-server.md：Vue
• reference/fastapi-backend.md：FastAPI
• reference/firebase-backend.md：Firebase エミュレーター

関連スキル

• backend-type-bridger：OpenAPI／Firestore → TypeScript 型
• composable-patterns：FastAPI JWT と Firebase クライアントのコンポーザブル
• verify-build：本番環境向けフロントエンドビルド

タスクの完了時：次のスキルを提案する

このスキルに対するユーザーのリクエストが完了したとき（ツール呼び出しやサブエージェントのフェーズごとではありません）、次に実行する内容を提案します。

1. 次を実行します。

   python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill project-engineering --project-root .
   

   特定のルートを作業した場合は、--route /path を追加します。

2. スクリプトの ### Next step ブロックを最終返信に含めます。ユーザーは Prompt の行をコピーして、チャットに貼り付けます（例：@heyeddi-design craft /settings）。

直前に完了したサブコマンドが分かっている場合は、--mode shape（または craft、audit など）を渡します。

@heyeddi → reference/next-skill-handoff.md を参照してください。