CHIRIMEN Lite Console

This project was generated with Angular CLI version 20.x. It uses Nx as the monorepo build system.

プロジェクト構成

• apps/console — メインの Web アプリ（CHIRIMEN Lite 接続・ターミナル・エディタ・Wi‑Fi 設定など）
• libs/ — 機能別ライブラリ（connect, console-shell, dialogs, editor, example, file-manager, pin-assign-panel, remote, setup, shared, terminal, web-serial, wifi など）。tsconfig.base.json の paths と CONTRIBUTING.md のスコープ一覧を参照してください。

Editor の利用方法

CHIRIMEN Lite 上のファイルを開いて編集・保存する手順、Save と Draft の違い、対応形式・サイズ上限・トラブルシュートは libs/editor/README.md を参照してください。

📚 リファクタリング履歴

このプロジェクトは段階的なリファクタリングを経て、保守性と拡張性の高いアーキテクチャに進化しています。

• Step 1: Serial サービスの責任分散（memos/step1/）
• Step 2: 不要コードの削除（memos/step2/）
• Step 3: 最終クリーンアップ（memos/step3/）
• Step 4: porting/ と shared/ の統合（memos/step4/） ⭐ NEW

詳細は各ステップの README.md を参照してください。

開発サーバー

pnpm start

または

pnpm nx run console:serve

ブラウザで http://localhost:4200/ を開きます。ソース変更時に自動リロードされます。

ビルド

pnpm build

または

pnpm nx run-many -t build

ビルド成果物は dist/ に出力されます。

Firebase Hosting

本番向けの console アプリは Firebase Hosting（プロジェクト ID: chirimen-lite-console）へデプロイします。

pnpm nx run apps-console:build

ビルド成果物は dist/console/browser に出力され、firebase.json の public として参照されます。

• main への push で Deploy console to Firebase Hosting が自動実行されます
• 手動実行は GitHub Actions の workflow_dispatch から行えます

ユニットテスト

pnpm test

または

pnpm nx run-many -t test

Vitest で全プロジェクトのユニットテストを実行します。

AI エージェント向け設定（Cursor Skills / Rules）

本プロジェクトは Cursor などの AI コーディングエージェントが Angular / Nx Workspace の構造とベストプラクティスを理解できるよう、以下の Skills / Rules を導入しています。

Angular Skills

Angular 公式 Skills を .agents/skills/ 配下に導入しています。

• angular-developer — Angular の一般的な開発知識（コンポーネント / Signals / DI / ルーティング / フォーム / テストなど）
• angular-new-app — Angular 新規アプリ作成のガイダンス

再導入する場合は以下を実行してください。

npx skills add https://github.com/angular/skills

Conventional Commits Skill

本プロジェクト固有の Conventional Commits を AI が生成できるよう、.agents/skills/conventional-commits/ に Skill を導入しています。

• SKILL.md — Conventional Commits の形式・scope 選択・カテゴリ別ガイド
• examples.md — 良い例 / 悪い例
• assertions.md — 検証項目と Valid / Invalid サンプル
• scopes.md — scope 一覧（commitlint.config.js と同期）

詳細は Issue #692 および CONTRIBUTING.md を参照してください。

Nx AI Agent 設定

Nx AI Agents により、Nx Workspace 構造を AI に理解させるための Skills (nx-workspace / nx-generate / nx-run-tasks ほか)、Nx Console (MCP) 連携、ルート AGENTS.md、.cursor/agents/ 配下のサブエージェント定義を導入しています。

再設定する場合は以下を実行してください。

pnpm nx configure-ai-agents

Cursor Rules (.mdc)

.cursor/rules/ 配下に責務別の Rules を配置しています。

.cursor/rules/
├── angular/
│   ├── 00-angular-core.mdc       # Angular ベースライン
│   ├── 10-angular-signals.mdc    # Signals の使い分け
│   ├── 20-angular-components.mdc # Component 設計
│   └── 30-angular-testing.mdc    # テスト方針
├── commit/
│   ├── 00-conventional-commits.mdc        # Conventional Commits 基本
│   ├── 10-pull-request-title.mdc          # PR タイトル統一
│   └── 20-chirimen-lite-console-scope.mdc # 本プロジェクト固有 scope
├── nx/
│   ├── 00-nx-workspace.mdc       # Workspace 全体ルール
│   ├── 10-nx-generators.mdc      # Nx Generator 利用方針
│   └── 20-nx-tasks.mdc           # Nx タスク実行方針
└── workflow/
    └── 90-ai-workflow.mdc        # AI 編集時の共通ルール

各 .mdc は globs で対象ファイルを限定しているため、対象ファイルを Cursor で開くと自動でルールが参照されます。

詳細は Issue #690 / #692 を参照してください。

その他

• コード生成や開発のルールは CONTRIBUTING.md を参照してください。
• Angular CLI の詳細は Angular CLI Overview を参照してください。