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

Droidがセッションをまたいで好み、判断、プロジェクト履歴を記憶できる永続メモリを構築する。

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

Factory Appでも利用可能: これらのメモリパターンは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

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

使用例:

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

~/.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()

Phrase trigger

“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]

---

​

次のステップ

Setup Checklist

パワーユーザー設定を完了する

ルールガイド

チーム規約を整理する