Agentic OsSAFE

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: agentic-os
description: Claude Code 上に永続的なマルチエージェントオペレーティングシステムを構築します。カーネルアーキテクチャ、スペシャリストエージェント、スラッシュコマンド、ファイルベースのメモリ、スケジュールされた自動化、外部データベースなしの状態管理をカバーします。
origin: ECC
---

# エージェニック OS

Claude Code をチャットセッションではなく永続的なランタイム / オペレーティングシステムとして扱います。このスキルは本番のエージェニックセットアップで使用されるアーキテクチャを成文化します:スペシャリストエージェントにタスクをルーティングするカーネル設定、永続的なファイルベースのメモリ、スケジュールされた自動化、JSON/Markdown データ層。

## 起動タイミング

- Claude Code 内でマルチエージェントワークフローを構築する
- セッション再起動後も維持される永続的な Claude Code 自動化をセットアップする
- 繰り返しタスク向けの「パーソナル OS」または「エージェニック OS」を作成する
- ユーザーが「エージェニック OS」、「パーソナル OS」、「マルチエージェント」、「エージェントコーディネーター」、「永続エージェント」と言う
- コンテキストがセッションをまたいで維持される必要がある長期プロジェクトを構造化する

## アーキテクチャ概要

エージェニック OS には 4 つの層があります。各層はプロジェクトルートのディレクトリです。

```
project-root/
├── CLAUDE.md          # カーネル: アイデンティティ、ルーティングルール、エージェントレジストリ
├── agents/            # スペシャリストエージェント定義(Markdown プロンプト)
├── .claude/commands/  # スラッシュコマンド: ユーザー向け CLI
├── scripts/           # デーモンスクリプト: スケジュールまたはイベント駆動タスク
└── data/              # 状態: JSON/Markdown ファイルシステム、外部 DB なし
```

### 層の責任

| 層 | 目的 | 永続化 |
|---|---|---|
| カーネル(`CLAUDE.md`) | アイデンティティ、ルーティング、モデルポリシー、エージェントレジストリ | Git 追跡 |
| エージェント(`agents/`) | スコープされたツールとメモリを持つスペシャリストアイデンティティ | Git 追跡 |
| コマンド(`.claude/commands/`) | ユーザー向けスラッシュコマンド(`/daily-sync`、`/outreach`) | Git 追跡 |
| スクリプト(`scripts/`) | cron またはウェブフックによってトリガーされる Python/JS デーモン | Git 追跡 |
| 状態(`data/`) | 追記専用ログ、プロジェクト状態、決定記録 | Git 無視または追跡 |

## カーネル

`CLAUDE.md` はカーネルです。COO / オーケストレーターとして機能します。Claude はセッション開始時にそれを読み、作業をルーティングするために使用します。

### カーネル構造

```markdown
# CLAUDE.md - エージェニック OS カーネル

## アイデンティティ
あなたは [project-name] の COO です。タスクをスペシャリストエージェントにルーティングします。
コードは直接書きません。適切なエージェントに委任し、結果を統合します。

## エージェントレジストリ

| エージェント | ロール | トリガー |
|---|---|---|
| @dev | コード、アーキテクチャ、デバッグ | ユーザーが「build」、「fix」、「refactor」と言う |
| @writer | ドキュメント、コンテンツ、メール | ユーザーが「write」、「draft」、「blog」と言う |
| @researcher | 調査、分析、事実確認 | ユーザーが「research」、「analyze」、「compare」と言う |
| @ops | DevOps、デプロイ、インフラ | ユーザーが「deploy」、「CI」、「server」と言う |

## ルーティングルール
1. ユーザーリクエストのインテントキーワードを解析する
2. エージェントレジストリのトリガー列にマッチさせる
3. `agents/<name>.md` から対応するエージェントファイルをロードする
4. 完全なコンテキストでハンドオフ実行する
5. 結果を統合してユーザーに提示する

## モデルポリシー
- デフォルトモデル: リポジトリまたはハーネスのデフォルトを使用する。
- @dev タスク: 複雑なアーキテクチャには高い推論モデルを優先する。
- @researcher タスク: 設定された調査対応モデルと承認された検索ツールを使用する。
- コストの上限: プロジェクトの設定された支出閾値を超える前に警告する。
```

### 重要な原則

カーネルは**小さく宣言的**であるべきです。ルーティングロジックはコードではなく Markdown テーブルに記載します。これによりシステムはデバッグなしに検査・編集可能になります。

## スペシャリストエージェント

各エージェントは `agents/` のスタンドアロン Markdown ファイルです。Claude はタスクをルーティングする際に関連するエージェントファイルをロードします。

### エージェント定義フォーマット

```markdown
# @dev - ソフトウェアエンジニア

## アイデンティティ
あなたはシニアソフトウェアエンジニアです。クリーンで、テスト済みの、本番グレードのコードを書きます。
シンプルなソリューションを好みます。要件が曖昧な場合は明確化の質問をします。

## メモリスコープ
- コンテキストのために `data/projects/<current-project>.md` を読む
- アーキテクチャ決定のために `data/decisions/` を読む
- 実行ログを `data/logs/<date>[email protected]` に追記する

## ツールアクセス
- プロジェクトルート内のフルファイルシステムアクセス
- Git 操作(status、diff、commit、branch)
- テストランナーアクセス
- `.claude/mcp.json` で設定された MCP サーバー

## 制約
- 新機能には常にテストを書く
- `main` に直接コミットしない;フィーチャーブランチを使用する
- 新しいファイルを作成するより既存のファイルを編集することを優先する
- 可能な限り関数を 50 行未満に保つ
```

### マルチエージェント連携パターン

タスクが複数のエージェントにまたがる場合、カーネルはそれらを順次または並行して実行します:

```
ユーザー: 「ランディングページを作ってローンチブログ記事を書いて」

カーネルルーティング:
1. @dev - 「[要件] でランディングページを作成する」
2. @writer - 「ランディングページのコピーを使って [プロダクト] のローンチブログ記事を書く」
3. カーネルが両方の出力を統合した応答に統合する
```

並行実行のために、Claude Code のバックグラウンドタスク機能や特定のエージェントコンテキストで Claude Code を呼び出すシェルスクリプトを使用します。

## コマンドと毎日のワークフロー

スラッシュコマンドは `.claude/commands/` の Markdown ファイルです。再利用可能なワークフローを定義します。

### コマンド構造

```markdown
# /daily-sync

朝のブリーフィングを実行する:

1. コンテキストのために `data/logs/last-sync.md` を読む
2. プロジェクト状態を確認する:`git status`、保留中の PR、CI の健全性
3. 新しいタスクや必要な決定のために `data/inbox/` を確認する
4. ブロッカー、優先事項、次のアクションのサマリーを生成する
5. ブリーフィングを `data/logs/daily/<date>.md` に追記する
```

### 標準コマンドセット

| コマンド | 目的 |
|---|---|
| `/daily-sync` | 朝のブリーフィング:状態、ブロッカー、優先事項 |
| `/outreach` | アウトリーチワークフローを実行する(メール、LinkedIn など) |
| `/research <topic>` | 引用追跡付きの詳細な調査 |
| `/apply-jobs` | 対象ロール向けに履歴書とカバーレターをカスタマイズする |
| `/analytics` | Stripe、GitHub、またはカスタムソースからメトリクスを取得する |
| `/interview-prep` | フラッシュカードまたはモック面接質問を生成する |
| `/decision <topic>` | 賛否と選択したパスで決定を記録する |

### コマンドの有効化

コマンドファイルを `.claude/commands/<command-name>.md` に配置します。Claude Code はそれらを自動検出します。ユーザーは `/<command-name>` で呼び出します。

## 永続メモリ

メモリはファイルベースです。ベクトル DB なし、Redis なし、PostgreSQL なし。`data/` の JSON と Markdown ファイルがデータベースです。

### メモリディレクトリ構造

```
data/
├── daily-logs/         # 追記専用の毎日のアクティビティログ
├── projects/           # プロジェクトごとのコンテキストファイル
├── decisions/          # アーキテクチャとビジネスの決定(ADR フォーマット)
├── inbox/              # トリアージ待ちの新しいタスクやアイデア
├── contacts/           # 人、会社、関係のノート
└── templates/          # 再利用可能なプロンプトとフォーマット
```

### 毎日のログフォーマット

```markdown
# 2026-04-22 - 毎日のログ

## セッション
- 09:00 - セッション 1: 認証モジュールのリファクタリング(@dev)
- 11:30 - セッション 2: 投資家向けアップデートの下書き(@writer)

## 決定
- JWT からセッション Cookie に切り替え(`data/decisions/2026-04-22-auth.md` を参照)

## ブロッカー
- ベンダーからの API キー待ち(2026-04-24 にフォローアップ)

## 次のアクション
- [ ] 認証リファクタリング PR をマージする
- [ ] 投資家向けアップデートをレビュー用に送信する
```

### 自動リフレクションパターン

各セッションの終わりに、カーネルはリフレクションを追記します:

```markdown
## リフレクション - セッション 3
- 機能したこと: 並行エージェント実行で 20 分節約
- 機能しなかったこと: @researcher がペイウォールのあるソースにヒット、より良いソースランキングが必要
- 変更すべきこと: 調査ノートに `source-tier` フィールドを追加する(A/B/C の信頼性)
```

これによりコードを変更することなく時間とともにシステムを改善するフィードバックループが作られます。

## スケジュールされた自動化

エージェニック OS タスクは、セッションが終了すると停止する Claude Code の組み込み cron ではなく、外部 cron を使用してスケジュールで実行されます。

### macOS: LaunchAgent

```xml
<!-- ~/Library/LaunchAgents/com.agentic.daily-sync.plist -->
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" ...>
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.agentic.daily-sync</string>
    <key>ProgramArguments</key>
    <array>
        <string>/claude</string>
        <string>--cwd</string>
        <string>/path/to/project</string>
        <string>--command</string>
        <string>/daily-sync</string>
    </array>
    <key>StartCalendarInterval</key>
    <dict>
        <key>Hour</key>
        <integer>8</int

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.