メモリとコンテキスト管理

Droidはセッション間で組み込みのメモリを持ちませんが、markdownファイル、AGENTS.mdの参照、およびフックを使用して強力なメモリシステムを作成できます。このガイドでは、永続化され成長するメモリの構築方法を説明します。

Factory Appでも利用可能: これらのメモリパターンはDroid CLIとFactory Appの両方で同じように機能します。作業ディレクトリがリポジトリルートに設定されていることだけ確認してください。

メモリシステムアーキテクチャ

メモリシステムは3つの層で構成されます：

┌─────────────────────────────────────────────────────┐
│                    AGENTS.md                         │
│         (References and orchestrates memory)         │
└─────────────────────────────────────────────────────┘
                         │
          ┌──────────────┼──────────────┐
          ▼              ▼              ▼
┌─────────────────┐ ┌─────────────┐ ┌─────────────────┐
│ Personal Memory │ │ Project     │ │ Rules &         │
│ ~/.factory/     │ │ Memory      │ │ Conventions     │
│ memories.md     │ │ .factory/   │ │ .factory/rules/ │
│                 │ │ memories.md │ │                 │
│ • Preferences   │ │ • Decisions │ │ • Standards     │
│ • Style         │ │ • History   │ │ • Patterns      │
│ • Tools         │ │ • Context   │ │ • Guidelines    │
└─────────────────┘ └─────────────┘ └─────────────────┘

個人メモリの設定

個人メモリはすべてのプロジェクトで共有されます。

ステップ1：メモリファイルの作成

~/.factory/memories.mdを作成します：

# My Development Memory

## Code Style Preferences

### General
- I prefer functional programming patterns over OOP
- I like early returns to reduce nesting
- I use 2-space indentation (but defer to project config)

### TypeScript
- I prefer `interface` over `type` for object shapes
- I use strict mode always
- I avoid `enum` in favor of `as const` objects

### React
- Functional components only
- I prefer Zustand over Redux for state
- I use React Query for server state

## Tool Preferences
- Package manager: pnpm (prefer) > npm > yarn
- Testing: Vitest > Jest
- Formatting: Prettier with defaults
- Linting: ESLint with strict TypeScript rules

## Communication Style
- I prefer concise explanations over verbose ones
- Show me the code first, explain after if needed
- When debugging, show me your reasoning

## Past Decisions (Personal Projects)
- [2024-01] Switched from Create React App to Vite
- [2024-02] Adopted Tailwind CSS as default styling
- [2024-03] Using Supabase for personal projects

ステップ2：AGENTS.mdで参照

~/.factory/AGENTS.mdまたはプロジェクトのAGENTS.mdに追加します：

## Personal Preferences
My coding preferences and tool choices are documented in `~/.factory/memories.md`.
Refer to this file when making decisions about code style, architecture, or tooling.

プロジェクトメモリの設定

プロジェクトメモリは、コードベース固有の決定とコンテキストを記録します。

ステップ1：プロジェクトメモリの作成

プロジェクトルートに.factory/memories.mdを作成します：

# Project Memory

## Project Context
- **Name**: Acme Dashboard
- **Type**: B2B SaaS application
- **Stack**: Next.js 14, TypeScript, Prisma, PostgreSQL
- **Started**: January 2024

## Architecture Decisions

### 2024-01-15: Database Choice
**Decision**: PostgreSQL over MongoDB
**Reasoning**: Strong relational data model, ACID compliance needed for financial data
**Trade-offs**: More rigid schema, but better for reporting queries

### 2024-02-01: Authentication Approach
**Decision**: NextAuth.js with custom credentials provider
**Reasoning**: Need to integrate with existing enterprise LDAP
**Implementation**: See `src/lib/auth/` for setup

### 2024-02-20: State Management
**Decision**: Zustand for client state, React Query for server state
**Reasoning**: Simpler than Redux, better separation of concerns
**Pattern**: Store files in `src/stores/`, queries in `src/queries/`

## Known Technical Debt
- [ ] Auth refresh token logic needs refactoring (#234)
- [ ] Dashboard queries should be optimized with proper indexes
- [ ] Legacy API endpoints in `/api/v1/` need deprecation

## Domain Knowledge

### Business Rules
- Users belong to Organizations (multi-tenant)
- Subscription tiers: Free, Pro, Enterprise
- Free tier limited to 3 team members
- Data retention: 90 days for Free, unlimited for paid

### Key Entities
- `User`: Individual accounts, can belong to multiple orgs
- `Organization`: Tenant container, has subscription
- `Project`: Work container within an org
- `Task`: Work items within projects

## Team Conventions
- PR titles follow conventional commits
- All PRs need at least one approval
- Deploy to staging on merge to `develop`
- Deploy to production on merge to `main`

ステップ2：プロジェクトAGENTS.mdで参照

プロジェクトのAGENTS.mdを更新します：

## Project Memory
Architecture decisions, domain knowledge, and project history are documented in `.factory/memories.md`.
Always check this file before making significant architectural or design decisions.

メモリカテゴリ

メモリを有用なカテゴリに整理します：

設定（個人）

あなたの好みと作業方法：

## Preferences
- Code style choices
- Tool preferences
- Communication style
- Learning style

決定（プロジェクト）

何が決定され、その理由：

## Decisions
- Architecture choices with reasoning
- Library selections with trade-offs
- Design patterns adopted
- Standards agreed upon

コンテキスト（プロジェクト）

背景情報：

## Context
- Business domain knowledge
- Key entities and relationships
- External integrations
- Performance requirements

履歴（両方）

いつ何が起こったか：

## History
- Major refactors completed
- Migrations performed
- Issues resolved
- Lessons learned

自動メモリ取得

作業中にメモリを取得するのに役立つフックを作成します。

「これを記憶」フック

「remember this:」の後にコンテンツを続けると、自動的にメモリに追加されます。メモリキャプチャは特殊文字またはフレーズのいずれかでトリガーできます。好みに基づいて選択してください：

# prefix trigger
Phrase trigger

すばやく記録するには、メッセージの先頭に#を付けてトリガーします。使用例:

“#リポジトリパターンを使う”
“##早期リターンを好む”（ダブル##は個人用）

~/.factory/hooks/memory-capture.pyを作成します:

#!/usr/bin/env python3
"""Captures messages starting with # and appends to memories.md"""
import json, sys, os
from datetime import datetime

def main():
    try:
        data = json.load(sys.stdin)
        prompt = data.get('prompt', '').strip()

        if not prompt.startswith('#'):
            return

        # ## = personal, # = project
        if prompt.startswith('##'):
            content = prompt[2:].strip()
            mem_file = os.path.expanduser('~/.factory/memories.md')
        else:
            content = prompt[1:].strip()
            project_dir = os.environ.get('FACTORY_PROJECT_DIR', os.getcwd())
            project_factory = os.path.join(project_dir, '.factory')
            if os.path.exists(project_factory):
                mem_file = os.path.join(project_factory, 'memories.md')
            else:
                mem_file = os.path.expanduser('~/.factory/memories.md')

        if content:
            timestamp = datetime.now().strftime('%Y-%m-%d')
            with open(mem_file, 'a') as f:
                f.write(f"\n- [{timestamp}] {content}\n")

            print(json.dumps({'systemMessage': f'✓ Saved to {mem_file}'}))
    except:
        pass

if __name__ == '__main__':
    main()

“remember this:“や”note:“などのフレーズでトリガーします。使用例:

“remember this: リポジトリパターンを使う”
“note: 認証トークンは24時間で期限切れになる”

~/.factory/hooks/memory-capture.pyを作成します:

#!/usr/bin/env python3
"""Captures 'remember this:' statements and appends to memories.md"""
import json, sys, os
from datetime import datetime

def main():
    try:
        data = json.load(sys.stdin)
        prompt = data.get('prompt', '')

        triggers = ['remember this:', 'remember:', 'note:', 'save this:']

        for trigger in triggers:
            if trigger in prompt.lower():
                idx = prompt.lower().index(trigger)
                content = prompt[idx + len(trigger):].strip()

                if content:
                    # Personal if specified, otherwise project
                    if 'personal' in prompt.lower():
                        mem_file = os.path.expanduser('~/.factory/memories.md')
                    else:
                        project_dir = os.environ.get('FACTORY_PROJECT_DIR', os.getcwd())
                        project_factory = os.path.join(project_dir, '.factory')
                        if os.path.exists(project_factory):
                            mem_file = os.path.join(project_factory, 'memories.md')
                        else:
                            mem_file = os.path.expanduser('~/.factory/memories.md')

                    timestamp = datetime.now().strftime('%Y-%m-%d')
                    with open(mem_file, 'a') as f:
                        f.write(f"\n- [{timestamp}] {content}\n")

                    print(json.dumps({'systemMessage': f'✓ Saved to {mem_file}'}))
                break
    except:
        pass

if __name__ == '__main__':
    main()

実行可能にし、フックを設定します：

chmod +x ~/.factory/hooks/memory-capture.py

/hooksを使用してフック設定に追加します：

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "python3 ~/.factory/hooks/memory-capture.py"
          }
        ]
      }
    ]
  }
}

#プレフィックス使用：

“#状態管理にはZustandを使うことに決めた”
“##早期リターンを好む”（ダブル##は個人用に保存）

フレーズトリガー使用：

“remember this: 状態管理にはZustandを使うことに決めた”
“note: authモジュールは24時間有効なJWTを使う”

代替案：メモリキャプチャスキル

フックの代わりに、何かを記憶するように依頼したときにDroidが呼び出すskillを使用できます。これにより、カテゴリ化をよりインタラクティブに制御できます。

代替案：カスタムスラッシュコマンド

手動での素早い取得には、custom slash commandを作成します： ~/.factory/commands/remember.mdを作成：

---
description: Save a memory to your memories file
argument-hint: <what to remember>
---

Add this to my memories file (~/.factory/memories.md):

$ARGUMENTS

Format it appropriately based on whether it's a preference, decision, or learning. Include today's date.

その後、/remember we chose PostgreSQL for better ACID complianceを使用してメモリをオンデマンドで取得します。

どの方法を選ぶべきか？

フック — 追加手順なしで自動記録したい場合に最適
スキル — Droidに分類や整形を手伝わせたい場合に最適
スラッシュコマンド — 一貫した形式ですばやく手動記録したい場合に最適

メモリメンテナンス

定期的なメンテナンスでメモリを有用に保ちます。

月次レビューチェックリスト

## Monthly Memory Review

### Personal Memory (~/.factory/memories.md)
- [ ] Remove outdated preferences (tools you no longer use)
- [ ] Update decisions that have changed
- [ ] Add new patterns you've adopted
- [ ] Archive old entries that are no longer relevant

### Project Memory (.factory/memories.md)
- [ ] Review architecture decisions - still valid?
- [ ] Update technical debt items
- [ ] Add new domain knowledge learned
- [ ] Document recent major changes

古いメモリのアーカイブ

メモリが古くなったら、アーカイブに移動します：

# memories.md

## Current Decisions
[active decisions here]

## Archive (2023)
<details>
<summary>Archived decisions from 2023</summary>

### 2023-06: Original Auth System
**Decision**: Custom JWT implementation
**Status**: Replaced by NextAuth.js in 2024-02
**Reason for change**: Maintenance burden, security updates

</details>

上級：メモリ対応スキル

メモリファイルを活用するスキルを作成します：

---
name: context-aware-implementation
description: Implement features using project memory and conventions.
---

# Context-Aware Implementation

Before implementing any feature:

1. **Check project memory** (`.factory/memories.md`):
   - What architecture decisions apply?
   - What patterns should I follow?
   - What constraints exist?

2. **Check personal preferences** (`~/.factory/memories.md`):
   - What code style does the user prefer?
   - What tools should I use?

3. **Check rules** (`.factory/rules/`):
   - What conventions apply to this file type?
   - What testing requirements exist?

Then implement following all discovered context.

クイックリファレンス

ファイル場所

メモリタイプ	場所	スコープ
個人設定	`~/.factory/memories.md`	全プロジェクト
プロジェクト決定	`.factory/memories.md`	このプロジェクト
チーム規約	`.factory/rules/*.md`	このプロジェクト

メモリを追加するタイミング

イベント	記録内容	場所
アーキテクチャ決定を行った	決定 + 理由	プロジェクト
設定を発見した	好み	個人
ドメイン知識を学んだ	ビジネスルール、エンティティ	プロジェクト
ワークフローを変更した	新しいツールやパターン	個人
複雑な問題を解決した	解決策とコンテキスト	プロジェクト

メモリフォーマットテンプレート

### [Date]: [Title]
**Decision/Preference**: [What]
**Reasoning**: [Why]
**Context**: [When this applies]
**Trade-offs**: [What you gave up]

パワーユーザー

構築

スキル

フック

Droid Exec（ヘッドレス）

メモリとコンテキスト管理

メモリシステムアーキテクチャ

個人メモリの設定

ステップ1：メモリファイルの作成

ステップ2：AGENTS.mdで参照

プロジェクトメモリの設定

ステップ1：プロジェクトメモリの作成

ステップ2：プロジェクトAGENTS.mdで参照

メモリカテゴリ

設定（個人）

決定（プロジェクト）

コンテキスト（プロジェクト）

履歴（両方）

自動メモリ取得

「これを記憶」フック

代替案：メモリキャプチャスキル

代替案：カスタムスラッシュコマンド

メモリメンテナンス

月次レビューチェックリスト

古いメモリのアーカイブ

上級：メモリ対応スキル

クイックリファレンス

ファイル場所

メモリを追加するタイミング

メモリフォーマットテンプレート

次のステップ

Setup Checklist

ルールガイド

​メモリシステムアーキテクチャ

​個人メモリの設定

​ステップ1：メモリファイルの作成

​ステップ2：AGENTS.mdで参照

​プロジェクトメモリの設定

​ステップ1：プロジェクトメモリの作成

​ステップ2：プロジェクトAGENTS.mdで参照

​メモリカテゴリ

​設定（個人）

​決定（プロジェクト）

​コンテキスト（プロジェクト）

​履歴（両方）

​自動メモリ取得

​「これを記憶」フック

​代替案：メモリキャプチャスキル

​代替案：カスタムスラッシュコマンド

​メモリメンテナンス

​月次レビューチェックリスト

​古いメモリのアーカイブ

​上級：メモリ対応スキル

​クイックリファレンス

​ファイル場所

​メモリを追加するタイミング

​メモリフォーマットテンプレート

​次のステップ

Setup Checklist

ルールガイド

メモリシステムアーキテクチャ

個人メモリの設定

ステップ1：メモリファイルの作成

ステップ2：AGENTS.mdで参照

プロジェクトメモリの設定

ステップ1：プロジェクトメモリの作成

ステップ2：プロジェクトAGENTS.mdで参照

メモリカテゴリ

設定（個人）

決定（プロジェクト）

コンテキスト（プロジェクト）

履歴（両方）

自動メモリ取得

「これを記憶」フック

代替案：メモリキャプチャスキル

代替案：カスタムスラッシュコマンド

メモリメンテナンス

月次レビューチェックリスト

古いメモリのアーカイブ

上級：メモリ対応スキル

クイックリファレンス

ファイル場所

メモリを追加するタイミング

メモリフォーマットテンプレート

次のステップ