arcanea-architect

Arcanea Architect Skill

目的

このスキルは、マルチプラットフォーム統合を備えた64エージェントの創造的知性システムであるArcaneaエコシステムの設計と実装を支援します。

使用する場面

• エージェントアーキテクチャを設計するとき
• オーケストレーションシステムを実装するとき
• マルチプラットフォーム統合を作成するとき
• 創造的なAIツールを構築するとき
• 体系的なワークフローを確立するとき

基本原則

1. 優れた設計

• すべてのコンポーネントに明確な目的を持たせます
• アーキテクチャは巧妙さではなく、洗練さを重視します
• ユーザーエクスペリエンスを最優先します
• コード品質を大切にします（テスト済み、文書化済み、保守可能）

2. 細部への配慮

• 重要な処理経路で近道をしません
• すべての前提を検証します
• 判断の根拠を文書化します
• すべてをテストします

3. 体系的な実装

• まず基盤を構築し、その後に機能を追加します
• 分離よりも統合を重視します
• 段階的に機能を強化します
• 可能な限り後方互換性を保ちます

アーキテクチャパターン

エージェントレジストリパターン

// Centralized agent definitions
interface Agent {
  id: string;           // Unique identifier
  name: string;         // Display name
  court: string;        // Elemental court
  frequency: string;    // Operating frequency
  specialty: string;    // What they do best
  skills: string[];     // Available skills
  prompts: Template[];  // Invocation templates
}

コンデクターパターン

// Multi-agent orchestration
class Conductor {
  async orchestrate(task: Task): Promise<Result> {
    // 1. Analyze task complexity
    // 2. Select optimal agent team
    // 3. Determine execution strategy
    // 4. Execute with monitoring
    // 5. Learn from results
  }
}

スキルパターン

// Capability definitions
interface Skill {
  id: string;
  gate: number;         // Which gate (1-10)
  frequency: string;    // Associated frequency
  invocation: string;   // How to trigger
  process: Step[];      // Step-by-step procedure
  agents: string[];     // Which agents can use
}

実装チェックリスト

フェーズ1：基盤

• エージェントレジストリ（64エージェントを定義）
• コアコンデクター（オーケストレーションエンジン）
• スキルシステム（50以上のスキル）
• AIルーター（opencode + Claude BYOK）
• ドキュメントアーキテクチャ

フェーズ2：統合

• .claude/CLAUDE.md（Claude Code）
• .opencode/ skills（opencodeエディター）
• Tauriデスクトップアプリ
• VS Code拡張機能
• Obsidianプラグイン

フェーズ3：仕上げ

• UI/UXの洗練
• パフォーマンスの最適化
• エラー処理
• ユーザーオンボーディング
• テストと検証

設計上の決定

なぜ64エージェントなのか？

決定： 易経の構造（8×8 = 64）を採用します 根拠：

• 完全な象徴体系
• 神聖幾何学（8 = 宇宙の秩序）
• 扱いやすく、かつ包括的
• それぞれがサブエージェントを生成可能

なぜ10のゲートなのか？

決定： ソルフェジオ周波数スケール（174-1111Hz）を採用します 根拠：

• 歴史的な共鳴
• 比喩的な価値
• 組織上の明確さ
• 覚えやすい分類

なぜハイブリッドAIなのか？

決定： opencodeをプライマリーとし、Claude BYOKを組み合わせます 根拠：

• ローカルファースト（プライバシー、速度）
• コスト効率（ほとんどのタスクに無料枠を利用）
• ベンダーロックインなし
• ユーザーが制御可能

なぜTauriデスクトップなのか？

決定： ElectronではなくTauriを採用します 根拠：

• バンドルサイズが小さい（600KB対100MB）
• Rustのパフォーマンス
• OSとのネイティブ統合
• より優れたセキュリティ

品質基準

コード品質

• TypeScriptの厳格モード
• 包括的なエラー処理
• コアロジックのユニットテスト
• ワークフローの統合テスト
• すべての公開APIのドキュメント

ユーザーエクスペリエンス

• 500ms未満の応答時間
• 明確なエラーメッセージ
• 段階的な情報開示
• オフライン機能
• プラットフォーム間で一貫したUI

パフォーマンス

• AI応答のLRUキャッシュ
• エージェントの遅延読み込み
• UI更新のデバウンス
• 描画の最適化
• メモリ管理

リソース

ドキュメント

• AGENT_ARCHITECTURE_v4.md - エージェントが64である理由
• IMPLEMENTATION_ARCHITECTURE.md - 全体の構成
• BYOK_SAAS_ARCHITECTURE.md - AI統合
• SKILL_ARCHITECTURE_ANALYSIS.md - スキルシステム

コード

• arcanea-agents/ - エージェントレジストリとコンデクター
• desktop/ - Tauriデスクトップアプリケーション
• .claude/ - Claude Code統合
• .opencode/ - opencodeエディター統合

テンプレート

• 新しいスキルにはSKILL.mdテンプレートを使用します
• 新しいエージェントにはエージェントテンプレートを使用します
• UIにはコンポーネントテンプレートを使用します

避けるべきアンチパターン

❌ しないこと： 明確な目的のないエージェントを作成する ✅ すること： すべてのエージェントが特定の問題を解決するようにします

❌ しないこと： 周波数を音響的な処方として使う ✅ すること： 比喩的なカテゴリーとして使います

❌ しないこと： 基盤より先に機能を構築する ✅ すること： まず基盤を構築し、その後に機能を追加します

❌ しないこと： 特定のAIプロバイダーにユーザーを縛り付ける ✅ すること： 複数のプロバイダーをサポートします（BYOK）

❌ しないこと： シンプルな解決策を過剰に設計する ✅ すること： 洗練されたシンプルさを重視します

成功指標

• 技術面： テスト合格率100％、応答時間500ms未満
• ユーザー： ドキュメントを見ずにタスクを完了できる
• 導入状況： デイリーアクティブユーザー数、継続率
• 満足度： ユーザーフィードバック、機能リクエスト

結論

Arcanea の構築には、以下が必要です。

1. ビジョン - 構築するものを明確に理解すること
2. 規律 - 近道をせず、アーキテクチャに従うこと
3. 技術 - 細部にまで注意を払うこと
4. 反復 - 構築し、テストし、改良し、繰り返すこと

基盤が高さを決めます。しっかりと構築しましょう。

---

このスキルは、Arcanea エコシステムを実装または拡張する際に使用してください。