aes-cli 0.9.0__tar.gz → 0.12.0__tar.gz

{aes_cli-0.9.0 → aes_cli-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aes-cli
-Version: 0.9.0
+Version: 0.12.0
 Summary: CLI tool for the Agentic Engineering Standard
 Author: Hiro
 License: Apache-2.0

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/__init__.py

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-__version__ = "0.9.0"
+__version__ = "0.12.0"

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/commands/init.py

@@ -459,6 +459,8 @@ def _print_post_init_summary(
             ("Cursor", ".cursorrules"),
             ("Copilot", ".github/copilot-instructions.md"),
             ("Windsurf", ".windsurfrules"),
+            ("Codex", "AGENTS.md"),
+            ("OpenClaw", ".openclaw/openclaw.json"),
         ]
         for tool_name, file_name in sync_targets:
             if (project_root / file_name).exists():

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/domains.py

@@ -1485,23 +1485,40 @@ _ASSISTANT_SKILLS = [
     ),
 ]
 
-_ASSISTANT_CONVERSE_COMMAND = CommandDef(
-    id="converse",
-    trigger="/converse",
-    description="Start or resume a conversation session with the assistant",
-    runbook_purpose="Run the assistant's main conversational loop. The agent listens across configured channels, responds to messages, executes skills on demand, and proactively checks heartbeat tasks.",
-    worker_specialty="Multi-platform conversational AI assistant",
+_ASSISTANT_BUILD_COMMAND = CommandDef(
+    id="build",
+    trigger="/build",
+    description="Build the assistant project from scratch: identity, channels, skills, integrations, permissions, tests",
+    runbook_purpose="Construct the complete assistant project. The agent sets up project structure, defines identity and model config, wires channel integrations, implements skills, configures security and permissions, and verifies with tests.",
+    worker_specialty="Constructing assistant projects — identity, channels, skills, integrations",
+    runbook_phases=[
+        {"title": "Project Structure", "content": "Create directory layout matching the AES assistant convention: skills/, config/, scripts/, tests/. Set up pyproject.toml, environment files, and dependency management."},
+        {"title": "Identity & Model", "content": "Configure identity (persona, name, emoji) in agent.yaml. Set up model provider, API key environment variables, and sandbox settings. Create USER.md template for user profile."},
+        {"title": "Channel Integration", "content": "Wire messaging channels (Telegram, Discord, etc.). Set up bot token environment variables, configure channel-specific settings, and implement message routing stubs."},
+        {"title": "Skill Wiring", "content": "Implement skill manifests and runbooks for each configured skill. Wire MCP servers if needed. Set up auto-activation rules and skill dependencies."},
+        {"title": "Security & Permissions", "content": "Configure permissions.yaml with shell confirmation rules, action confirmations, and channel-specific security policies. Set up credential management via environment variables."},
+        {"title": "Tests & Verification", "content": "Write unit tests for skill execution, channel routing, and permission checks. Add integration test that validates the full config. Verify all environment variables are documented."},
+    ],
+)
+
+_ASSISTANT_RUN_COMMAND = CommandDef(
+    id="run",
+    trigger="/run",
+    description="Start the autonomous assistant loop: initialize, monitor channels, execute skills, maintain heartbeat",
+    runbook_purpose="Run the assistant's autonomous agent loop. The agent initializes from stored state, monitors connected channels for messages, executes skills on demand or automatically, persists learnings to memory, and maintains the heartbeat cycle for proactive tasks.",
+    worker_specialty="Running autonomous assistant agents — channel monitoring, skill execution, heartbeat maintenance",
     runbook_phases=[
-        {"title": "Session Setup", "content": "Load user profile from USER.md. Check HEARTBEAT.md for pending tasks. Review recent conversation history for context continuity."},
-        {"title": "Message Processing", "content": "Receive messages from connected channels. Determine intent — is this a greeting, a question, a skill invocation, or a general conversation? Route accordingly."},
-        {"title": "Skill Execution", "content": "When a skill is triggered (explicitly via command or automatically via context match), execute it and return results to the user."},
-        {"title": "Memory & Wrap-up", "content": "Persist important learnings to MEMORY.md. Update AGENTS.md if the user's preferences or context changed."},
+        {"title": "Initialization", "content": "Load user profile from USER.md. Restore session state from MEMORY.md. Check HEARTBEAT.md for pending tasks. Review recent activity log for context continuity."},
+        {"title": "Channel Monitoring", "content": "Connect to configured channels (Telegram, Discord, etc.). Listen for incoming messages. Determine intent — greeting, skill invocation, general conversation, or system command. Route accordingly."},
+        {"title": "Skill Execution", "content": "When a skill is triggered (explicitly via command or automatically via context match), execute it within permission boundaries. Return results to the originating channel. Handle errors gracefully with user-facing messages."},
+        {"title": "Memory & Learning", "content": "Persist important learnings to MEMORY.md. Update active instincts based on interaction patterns. Record conversation context for future sessions."},
+        {"title": "Heartbeat & Maintenance", "content": "Execute heartbeat checklist at configured intervals. Proactively surface important updates (calendar, PRs, unread messages). Respect quiet hours. Log heartbeat results to activity log."},
     ],
 )
 
 ASSISTANT_CONFIG = DomainConfig(
     mode="agent-integrated",
-    workflow_commands=[_ASSISTANT_CONVERSE_COMMAND],
+    workflow_commands=[_ASSISTANT_BUILD_COMMAND, _ASSISTANT_RUN_COMMAND],
 
     # Identity defaults for scaffold
     identity_persona=(
@@ -1527,7 +1544,7 @@ ASSISTANT_CONFIG = DomainConfig(
         "discord": {"enabled": "true", "bot_token_env": "DISCORD_BOT_TOKEN"},
     },
 
-    instructions_description="Personal AI assistant connected to messaging platforms via OpenClaw. Runs 24/7, responds across channels, and executes skills on demand.",
+    instructions_description="Autonomous AI assistant powered by OpenClaw. Runs 24/7, monitors channels, executes skills, and maintains proactive heartbeat tasks.",
     instructions_quick_ref=(
         "```bash\n"
         "aes sync -t openclaw           # generate .openclaw/ config\n"

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/i18n/_messages.py

@@ -178,7 +178,7 @@ MESSAGES: dict = {
     "init.type_skip": "Skip",
     "init.type_ml": "ML pipeline",
     "init.type_research": "Research / Content pipeline",
-    "init.type_assistant": "Assistant (24/7 AI on messaging platforms)",
+    "init.type_assistant": "Assistant (24/7 autonomous agent)",
     "init.type_custom": "Custom",
     "init.overwrite_warning": "{agent_dir}/ already exists at {path}",
     "init.overwrite_confirm": "Overwrite existing files?",

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/i18n/ja.py

@@ -178,7 +178,7 @@ MESSAGES: dict = {
     "init.type_skip": "スキップ",
     "init.type_ml": "ML パイプライン",
     "init.type_research": "研究 / コンテンツパイプライン",
-    "init.type_assistant": "アシスタント（24時間メッセージングAI）",
+    "init.type_assistant": "アシスタント（24時間自律エージェント）",
     "init.type_custom": "カスタム",
     "init.overwrite_warning": "{path} に {agent_dir}/ が既に存在します",
     "init.overwrite_confirm": "既存のファイルを上書きしますか？",

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/registry.py

@@ -15,6 +15,7 @@ from typing import Dict, List, Optional, Tuple
 REGISTRY_URL = os.environ.get("AES_REGISTRY_URL", "https://registry.aes-official.com")
 INDEX_PATH = "index.json"
 PACKAGES_PATH = "packages"
+_USER_AGENT = "aes-cli/0.11.0"
 
 
 def _validate_registry_url(url: str) -> str:
@@ -131,6 +132,7 @@ def fetch_index(registry_url: Optional[str] = None) -> dict:
     url = f"{base.rstrip('/')}/{INDEX_PATH}"
 
     req = urllib.request.Request(url)
+    req.add_header("User-Agent", _USER_AGENT)
     token = os.environ.get("AES_REGISTRY_KEY")
     if token:
         req.add_header("Authorization", f"Bearer {token}")
@@ -158,6 +160,7 @@ def download_package(
     tarball_path = dest / f"{name}-{version}.tar.gz"
 
     req = urllib.request.Request(url)
+    req.add_header("User-Agent", _USER_AGENT)
     token = os.environ.get("AES_REGISTRY_KEY")
     if token:
         req.add_header("Authorization", f"Bearer {token}")
@@ -206,6 +209,7 @@ def upload_package(
     # Upload tarball — server auto-updates index from X-AES-* headers
     upload_url = f"{base.rstrip('/')}/{PACKAGES_PATH}/{name}/{version}.tar.gz"
     req = urllib.request.Request(upload_url, data=tarball_data, method="PUT")
+    req.add_header("User-Agent", _USER_AGENT)
     req.add_header("Authorization", f"Bearer {token}")
     req.add_header("Content-Type", "application/gzip")
     req.add_header("X-AES-Description", description)

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/scaffold/instructions.md.jinja

@@ -20,6 +20,7 @@
 {% for rule in domain_config.instructions_rules %}
 {{ loop.index }}. {{ rule }}
 {% endfor %}
+{{ domain_config.instructions_rules|length + 1 }}. **Memory discipline** — update `.agent/memory/operations.md` after every significant action. Run `/memory` at session end. Next session starts blind without this.
 
 ## Primary Workflow
 
@@ -165,6 +166,7 @@ Key rules: `aes_skill`/`aes_workflow` version key is **required**. `inputs` is a
      Example: "Python 3.9+ — use `from __future__ import annotations` everywhere." -->
 
 1. **Fail graceful** — Each item wrapped in try/except, log error, continue.
+2. **Memory discipline** — update `.agent/memory/operations.md` after every significant action. Run `/memory` at session end.
 
 ## Domain Model
 

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/scaffold/ja/instructions.md.jinja

@@ -20,6 +20,7 @@
 {% for rule in domain_config.instructions_rules %}
 {{ loop.index }}. {{ rule }}
 {% endfor %}
+{{ domain_config.instructions_rules|length + 1 }}. **メモリ規律** — 重要なアクションの後に `.agent/memory/operations.md` を必ず更新してください。セッション終了時に `/memory` を実行してください。これを怠ると次のセッションが盲目的に開始されます。
 
 ## 主要ワークフロー
 
@@ -165,6 +166,7 @@ idempotency:
      例: "Python 3.9+ — `from __future__ import annotations` を全ファイルで使用。" -->
 
 1. **グレースフルフェイル** — 各アイテムをtry/exceptでラップし、エラーをログして続行。
+2. **メモリ規律** — 重要なアクションの後に `.agent/memory/operations.md` を必ず更新。セッション終了時に `/memory` を実行。
 
 ## ドメインモデル
 

aes_cli-0.12.0/aes/scaffold/ja/memory_command.md.jinja

@@ -0,0 +1,195 @@
+# コマンド: /memory
+
+現在の会話をレビューし、記憶に値するアイテムを `.agent/memory/` に保存します。
+
+## 実行タイミング
+
+- **手動**: `/memory` を実行して重要な学びを保存
+- **自動トリガー**: 重要な作業セッションの終了時に実行 — コマンド完了後、アーキテクチャの意思決定後、困難なバグの解決後、大規模な実装作業の完了後
+
+## フェーズ 1: コンテキストのレビュー
+
+会話をスキャンし、保存する価値のあるアイテムを特定:
+
+1. **アーキテクチャの決定** — 新しいパターン、技術選択、根拠を伴うデザインのトレードオフ
+2. **苦労して得た解決策** — 診断に労力を要したバグ、非自明な修正、ワークアラウンド
+3. **プロジェクトの規約** — 複数のインタラクションで確認されたパターン
+4. **環境/インフラのメモ** — デプロイの詳細、ランタイムの癖、認証情報の設定
+5. **ステータスの変更** — 構築されたもの、進行中に移行したもの、計画されたもの
+
+**無視するもの:**
+- 一時的な状態（現在のタスクの詳細、進行中の作業の詳細）
+- セッション間で未確認の単一観察による結論
+- `.agent/instructions.md` に既に記載されている情報
+- セッション固有の詳細（一時ファイルパス、エフェメラルID）
+
+## フェーズ 2: 既存メモリの確認
+
+重複を避けるために、現在のメモリファイルを読む:
+
+1. `.agent/memory/project.md` — 全セクションを確認
+2. `.agent/memory/learnings.yaml` — 既存の学習IDを確認
+
+各候補アイテムについて:
+- 既存エントリを**更新**する場合 → 既存エントリをその場で修正
+- 既存エントリと**矛盾**する場合 → 新しい理解で置き換え
+- **真に新しい**場合 → 適切なセクションに追加
+- 既存エントリと**重複**する場合 → スキップ
+
+## フェーズ 3: プロジェクトメモリへの保存
+
+`.agent/memory/project.md` を以下のセクションに該当するアイテムで更新:
+
+| セクション | 記載内容 |
+|-----------|---------|
+| **プロジェクト概要** | システム目的の変更、スコープの変更 |
+| **アーキテクチャ** | 根拠を伴う新しい技術的決定 |
+| **ステータス** | 構築済み、進行中、計画中のもの |
+| **主要パターン** | コードベースから確認されたパターン |
+| **環境メモ** | デプロイ、ランタイム、インフラの詳細 |
+
+`project.md` を200行以下に維持してください。制限に近づいた場合は、超過するのではなく、古いエントリを統合または削除してください。
+
+### BOM チェック
+
+このセッションで新しいAIモデル、フレームワーク、ツール、またはデータソースを導入した場合、`.agent/bom.yaml` を更新:
+- 新しいモデル → `models:` にプロバイダー、バージョン、目的を追加
+- 新しいフレームワーク/ライブラリ → `frameworks:` にバージョンを追加
+- 新しいツール（MCPサーバー、CLI、API） → `tools:` にタイプを追加
+- 新しいデータソース → `data_sources:` にタイプとURIを追加
+
+## フェーズ 4: 構造化された学習の保存
+
+明確な適用性を持つ苦労して得た教訓について、`.agent/memory/learnings.yaml` に追加:
+
+```yaml
+- id: "ケバブケースid"
+  date: "YYYY-MM-DD"
+  context: "何が起きていたか"
+  observation: "何が観察されたか"
+  lesson: "一般化された教訓"
+  applies_when:
+    - "条件 1"
+    - "条件 2"
+  action: "これが適用される場合に何をするか"
+```
+
+構造化された学習は以下の場合にのみ作成:
+- 複数の観察で確認された、または
+- 発見に大きな労力を要した、または
+- 忘れると実害が生じる
+
+## フェーズ 5: インスティンクトの抽出（`.agent/learning/` が存在する場合）
+
+セッションをレビューし、インスティンクトとして体系化する価値のある繰り返しパターンを特定します。
+
+### 抽出する条件
+
+パターンが以下の場合にのみ抽出:
+- このセッションで2回以上成功して適用された、または
+- ユーザーから与えられた恒久的な行動変更となるべき修正、または
+- 発見に労力を要した非自明なテクニック
+
+些細なパターン、一回限りの修正、プロジェクト固有の詳細（それらは `project.md` に記載）は抽出しないでください。
+
+### 抽出方法
+
+1. `.agent/learning/config.yaml` を読んで抽出設定を確認
+2. 各候補パターンについて、`.agent/learning/instincts/candidates/` に新しいファイルを作成:
+
+```yaml
+apiVersion: aes/v1
+kind: Instinct
+
+metadata:
+  id: "ケバブケースの説明的id"
+  created_at: "YYYY-MM-DDTHH:MM:SSZ"
+  last_validated: "YYYY-MM-DDTHH:MM:SSZ"
+  source_session: "YYYY-MM-DD"
+  tags: []
+
+pattern:
+  description: "パターンの内容 — 明確な一文"
+  trigger: "このパターンが発動すべき条件"
+  action: "実行すべきステップ"
+
+confidence:
+  score: 0.4
+  validations: 1
+  contradictions: 0
+  status: candidate
+```
+
+3. 設定の `max_candidates_per_session`（デフォルト: 3）を上限とする
+
+### 既存インスティンクトの管理
+
+1. `.agent/learning/instincts/candidates/` を確認 — 十分な検証があるものを昇格:
+   - `validations >= 3` かつ `score >= 0.6` の場合: ファイルを `active/` に移動し、`status: active` に設定
+2. `.agent/learning/instincts/active/` を確認 — 検証または反証:
+   - アクティブなインスティンクトがこのセッションで成功裏に適用された場合: `validations` をインクリメントし、`last_validated` を更新
+   - アクティブなインスティンクトが反証された場合: `contradictions` をインクリメントし、`score` を `decay_rate` 分減少
+   - `score < min_score`（デフォルト 0.3）の場合: ファイルを `archived/` に移動し、`status: archived` に設定
+
+## フェーズ 6: 重要な決定の記録
+
+セッションで重要な技術的決定が行われた場合、決定記録を作成します。
+
+### 記録を作成する条件
+
+- トレードオフのある複数の有効な選択肢から選んだ場合
+- 規約やスタンダードなアプローチから逸脱した場合
+- 試した後にアプローチを却下した場合（とその理由）
+- 品質ゲートを上書きまたは調整した場合
+- コンプライアンスに関連する選択をした場合
+
+### 作成方法
+
+`.agent/memory/decisions/` で次の利用可能な番号を見つけて作成:
+
+```yaml
+aes_decision: "1.4"
+id: "dr-NNN-短いスラグ"
+timestamp: "YYYY-MM-DDTHH:MM:SSZ"
+summary: "一文: 何が決定されたか、なぜか"
+context: "この決定を促した問題"
+alternatives:
+  - option: "代替案A"
+    rejected_reason: "却下された理由"
+rationale: "制約を考慮して選択されたアプローチが最適である理由"
+outcome: "結果 — メトリクス、ステータス、成果物"
+approval: auto
+tags: []
+```
+
+実際の選択肢がないルーチン作業ではこのフェーズをスキップしてください。
+
+## フェーズ 7: セッションスナップショット
+
+セッションが実質的な作業を含んでいた場合、`.agent/memory/sessions/YYYY-MM-DD.md` を作成:
+
+```markdown
+# セッション: YYYY-MM-DD
+
+## 実施内容
+- ...
+
+## 行われた決定
+- ...
+
+## 未解決の質問
+- ...
+```
+
+軽微なセッション（クイックフィックス、小さな設定変更）ではこのフェーズをスキップしてください。
+
+## フェーズ 8: 報告
+
+保存されたものを要約:
+- `project.md` に追加または更新されたアイテム
+- `learnings.yaml` に追加された学習（ある場合）
+- 抽出または昇格されたインスティンクト（ある場合）
+- 作成された決定記録（ある場合）
+- 作成されたセッションファイル（ある場合）
+- 重複としてスキップされたアイテム
+- 更新されたBOMエントリ（ある場合）

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/scaffold/ja/operations.md.jinja

@@ -1,9 +1,10 @@
 # {{ name }} — オペレーション記録
 
-> 全コマンド共通の時系列ログ。
-> コマンド開始時に**ログ全体を読んでください** — 他のワーカーのエントリがコンテキストを提供します。
-> 読了後、下の**読了カーソル**を更新し、次回どこまで読んだか記録してください。
-> 新しいエントリは自分のコマンドタグ付きでアクティビティログに追記してください。
+> **必須**: すべてのコマンドは開始前にこのファイルを読み、各アクション後に更新しなければなりません。
+> 1. アクティビティログ全体を読む — 他のワーカーのエントリがコンテキストを提供します
+> 2. 読了後、ワーカーテーブルの**読了カーソル**を更新する
+> 3. 各アクション後、番号付きエントリをアクティビティログに追記する
+> 4. メモリ更新をスキップしないでください — 次のセッションがこの状態に依存しています
 
 ## ワーカー
 

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/scaffold/ja/orchestrator.md.jinja

@@ -1,10 +1,11 @@
 {% if domain_config %}
 # {{ name }} — オーケストレーター
 
-## オペレーション記録
+## オペレーション記録（必須）
 
-`.agent/memory/operations.md` で各コマンドワーカーの現在の状態を確認してください。
-各コマンドにはアクティビティ履歴とチェックマーク付きのインデックスセクションがあります。
+決定を行う前に `.agent/memory/operations.md` を必ず読んでください。
+各コマンドワーカーは読了カーソルを保持しています — 自分のカーソル以降のエントリで他のワーカーの作業を確認してください。
+`aes init` 後にアクティビティエントリがない場合は、新規開始です — 直ちにログ記録を開始してください。
 {% if domain_config.workflow_commands %}
 追跡中のコマンド:
 {% for cmd in domain_config.workflow_commands %}

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/scaffold/ja/setup.md.jinja

@@ -112,7 +112,16 @@
 - インタビュー: 「APIキーや設定変数は必要ですか？」と確認
 必須変数とデフォルト値付きのオプション変数を列挙。
 
-## フェーズ 8: 検証と同期
+## フェーズ 8: 学習の設定（`.agent/learning/` が存在する場合）
+
+`.agent/learning/config.yaml` をレビュー:
+1. **抽出設定**: 予想されるセッション頻度に基づいて `max_candidates_per_session`（デフォルト3）と `min_session_length`（デフォルト5）を調整
+2. **信頼度の閾値**: `promotion_threshold`（0.6）と `promotion_min_validations`（3）をレビュー — 高速イテレーションには低い値、慎重な学習には高い値
+3. **コンテキスト読み込み**: コンテキストウィンドウの予算に基づいて `max_instincts_in_context`（デフォルト10）と `format`（compact vs full）を設定
+
+`.agent/learning/` が存在しない場合（学習なしのdev-assistプロジェクト）はこのフェーズをスキップ。
+
+## フェーズ 9: 検証と同期
 
 ```bash
 aes validate
@@ -228,7 +237,16 @@ aes sync
 - インタビュー: 「APIキーや設定変数は必要ですか？」と確認
 必須変数とデフォルト値付きのオプション変数を列挙。
 
-## フェーズ 8: 検証と同期
+## フェーズ 8: 学習の設定（`.agent/learning/` が存在する場合）
+
+`.agent/learning/config.yaml` をレビュー:
+1. **抽出設定**: 予想されるセッション頻度に基づいて `max_candidates_per_session`（デフォルト3）と `min_session_length`（デフォルト5）を調整
+2. **信頼度の閾値**: `promotion_threshold`（0.6）と `promotion_min_validations`（3）をレビュー — 高速イテレーションには低い値、慎重な学習には高い値
+3. **コンテキスト読み込み**: コンテキストウィンドウの予算に基づいて `max_instincts_in_context`（デフォルト10）と `format`（compact vs full）を設定
+
+`.agent/learning/` が存在しない場合（学習なしのdev-assistプロジェクト）はこのフェーズをスキップ。
+
+## フェーズ 9: 検証と同期
 
 ```bash
 aes validate

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/scaffold/ja/workflow_command.md.jinja

@@ -6,17 +6,18 @@
 
 あなたは **{{ cmd.trigger }}** ワーカーです — {{ cmd.worker_specialty or cmd.description }}。
 
-## メモリ
+## メモリ（必須）
 
-開始前に、`.agent/memory/operations.md` の**すべて**を読んでください。
+開始前に、`.agent/memory/operations.md` の**すべて**を読まなければなりません。
 前回の**読了カーソル**以降のアクティビティログエントリを確認してください — これらは他のワーカーがあなたの未確認の間に行った作業です。
 このコンテキストを作業に活用してください（例: `/build` が構築したもの、`/run` が遭遇した問題、行われた決定事項）。
 
-各フェーズ完了後、`{{ cmd.trigger }}` タグ付きの番号付きエントリをアクティビティログに追記してください:
+各フェーズ完了後、`{{ cmd.trigger }}` タグ付きの番号付きエントリをアクティビティログに必ず追記してください:
 ```
 N. [{{ cmd.trigger }}] YYYY-MM-DD: 実施内容 — 結果
 ```
 
+アクティビティログエントリを書くまで次のフェーズに進まないでください。
 完了時、ワーカーテーブルの**読了カーソル**を最後のエントリ番号に更新してください。
 
 ## 完了チェック
@@ -39,10 +40,12 @@ N. [{{ cmd.trigger }}] YYYY-MM-DD: 実施内容 — 結果
 {{ phase.content }}
 {% endfor %}
 
-## 完了後
+## 完了後（必須）
 
 1. `.agent/memory/operations.md` を更新:
    - アクティビティログに最終エントリを追記
    - **読了カーソル**を最後のエントリ番号に更新
    - 横断的な課題や決定事項を「課題と決定事項」セクションに追加
-2. 報告: 完了したフェーズ、処理したアイテム数、発生したエラー
+2. 重要な決定が行われた場合、`.agent/memory/decisions/` に決定記録を作成（フォーマットは `/memory` を参照）
+3. 確認: 完了報告の前にoperations.mdが更新されていることを確認
+4. 報告: 完了したフェーズ、処理したアイテム数、発生したエラー

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/scaffold/memory_command.md.jinja

@@ -50,6 +50,14 @@ Update `.agent/memory/project.md` with items that belong in these sections:
 
 Keep `project.md` under 200 lines. If approaching the limit, consolidate or remove outdated entries rather than exceeding it.
 
+### BOM Check
+
+If this session introduced new AI models, frameworks, tools, or data sources, update `.agent/bom.yaml`:
+- New model → add to `models:` with provider, version, purpose
+- New framework/library → add to `frameworks:` with version
+- New tool (MCP server, CLI, API) → add to `tools:` with type
+- New data source → add to `data_sources:` with type and URI
+
 ## Phase 4: Save Structured Learnings
 
 For hard-won lessons with clear applicability, append to `.agent/memory/learnings.yaml`:
@@ -71,7 +79,92 @@ Only create structured learnings for insights that:
 - Required significant effort to discover, OR
 - Would cause real damage if forgotten
 
-## Phase 5: Session Snapshot
+## Phase 5: Extract Instincts (if `.agent/learning/` exists)
+
+Review the session for repeatable patterns worth codifying as instincts.
+
+### When to extract
+
+Only extract when a pattern was:
+- Applied successfully more than once in this session, OR
+- A correction the user gave that should become permanent behavior, OR
+- A non-obvious technique that took effort to discover
+
+Do NOT extract trivial patterns, one-off fixes, or project-specific details (those go in `project.md`).
+
+### How to extract
+
+1. Read `.agent/learning/config.yaml` for extraction settings
+2. For each candidate pattern, create a new file in `.agent/learning/instincts/candidates/`:
+
+```yaml
+apiVersion: aes/v1
+kind: Instinct
+
+metadata:
+  id: "kebab-case-descriptive-id"
+  created_at: "YYYY-MM-DDTHH:MM:SSZ"
+  last_validated: "YYYY-MM-DDTHH:MM:SSZ"
+  source_session: "YYYY-MM-DD"
+  tags: []
+
+pattern:
+  description: "What the pattern is — one clear sentence"
+  trigger: "When this pattern should activate"
+  action: "Step-by-step what to do"
+
+confidence:
+  score: 0.4
+  validations: 1
+  contradictions: 0
+  status: candidate
+```
+
+3. Limit to `max_candidates_per_session` from config (default: 3)
+
+### Manage existing instincts
+
+1. Check `.agent/learning/instincts/candidates/` — promote any with enough validations:
+   - If `validations >= 3` AND `score >= 0.6`: move file to `active/`, set `status: active`
+2. Check `.agent/learning/instincts/active/` — validate or contradict:
+   - If an active instinct was applied successfully this session: increment `validations`, update `last_validated`
+   - If an active instinct was contradicted: increment `contradictions`, reduce `score` by `decay_rate`
+   - If `score < min_score` (default 0.3): move file to `archived/`, set `status: archived`
+
+## Phase 6: Record Significant Decisions
+
+If the session involved a significant technical decision, create a decision record.
+
+### When to create a record
+
+- Chose between multiple valid alternatives with trade-offs
+- Deviated from a convention or standard approach
+- Rejected an approach after trying it (and why)
+- Overrode or adjusted a quality gate
+- Made a compliance-relevant choice
+
+### How to create
+
+Find the next available number in `.agent/memory/decisions/` and create:
+
+```yaml
+aes_decision: "1.4"
+id: "dr-NNN-short-slug"
+timestamp: "YYYY-MM-DDTHH:MM:SSZ"
+summary: "One sentence: what was decided and why"
+context: "What problem prompted this decision"
+alternatives:
+  - option: "Alternative A"
+    rejected_reason: "Why it was rejected"
+rationale: "Why the chosen approach is best given constraints"
+outcome: "What resulted — metrics, status, artifacts"
+approval: auto
+tags: []
+```
+
+Skip this phase for routine work that doesn't involve real alternatives.
+
+## Phase 7: Session Snapshot
 
 If the session involved substantial work, create `.agent/memory/sessions/YYYY-MM-DD.md`:
 
@@ -90,10 +183,13 @@ If the session involved substantial work, create `.agent/memory/sessions/YYYY-MM
 
 Skip this phase for minor sessions (quick fixes, small config changes).
 
-## Phase 6: Report
+## Phase 8: Report
 
 Summarize what was persisted:
 - Items added or updated in `project.md`
 - Learnings added to `learnings.yaml` (if any)
+- Instincts extracted or promoted (if any)
+- Decision records created (if any)
 - Session file created (if any)
 - Items skipped as duplicates
+- BOM entries updated (if any)

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/scaffold/operations.md.jinja

@@ -1,9 +1,10 @@
 # {{ name }} — Operations Memory
 
-> Unified chronological log across all commands.
-> **Read the entire log** when starting any command — entries from other workers give you context.
-> After reading, update your **Read Cursor** below so you know where you left off next time.
-> Append new entries to the Activity Log tagged with your command.
+> **REQUIRED**: Every command MUST read this file before starting and update it after each action.
+> 1. Read the entire Activity Log — entries from other workers give you context
+> 2. After reading, update your **Read Cursor** in the Workers table
+> 3. After each action, append a numbered entry to the Activity Log
+> 4. Do NOT skip memory updates — the next session depends on this state
 
 ## Workers
 

{aes_cli-0.9.0 → aes_cli-0.12.0}/aes/scaffold/orchestrator.md.jinja

@@ -1,10 +1,11 @@
 {% if domain_config %}
 # {{ name }} — Orchestrator
 
-## Operations Memory
+## Operations Memory (REQUIRED)
 
-Check `.agent/memory/operations.md` for the current state of each command worker.
-Each command has its own indexed section with activity history and checkmarks.
+You MUST read `.agent/memory/operations.md` before making any decisions.
+Each command worker maintains its Read Cursor — check for entries after yours to see what other workers have done.
+If operations.md has no activity entries after `aes init`, you are starting fresh — begin logging immediately.
 {% if domain_config.workflow_commands %}
 Commands tracked:
 {% for cmd in domain_config.workflow_commands %}