the-metafactory

the-metafactory/soma

Instructions file CodexOpenCode

Instructions for the-metafactory/soma, covering soma agent instructions, how to work in this repo, substrate adapters, codex bootstrap and design boundaries.

the-metafactory/soma

Agent

How the engineering skills should consume soma's domain documentation when exploring the codebase.

the-metafactory/soma

Agent

Issues and PRDs for this repo live as GitHub issues. Use the gh CLI for all operations.

the-metafactory/soma

Agent

The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.

the-metafactory/soma

Skill Claude CodeCodex

Portable Personal AI Assistant core. USE WHEN designing substrate-neutral assistant identity, memory, ISA, skills, learning, or adapters for Codex, Pi.dev, Claude Code, Cursor, or Grok.

the-metafactory/soma

Skill Claude CodeCodex

Files-first assistant memory: durable notes (semantic/procedural), episodic session digests and action logs, a generated INDEX, deterministic consolidation, and a health audit. Use to remember a durable fact, recall what is known about a topic, log a session or action, run maintenance, or check memory-tree health. No…

the-metafactory/soma

Skill Claude CodeCodex

Owns the Ideal State Artifact: the commitment-time scaffold for articulating done, deriving ISC criteria, planning features, recording decisions, and verifying work. Use for ideal state, VSA/ISC criteria, project specs, scaffolding, completeness checks, reconciliation, or seeding an VSA from a repo.

the-metafactory/soma

Skill Claude CodeCodex

Finish a PAI→Soma migration by placing PAI's imported life-OS content correctly: keep the Purpose compartment as a lean 4-field distillation, promote the rich imported categories (beliefs, mental models, decision frames, challenges, lessons) into Soma memory as recall-able notes, and protect the curated purpose.md…

the-metafactory/soma

Skill Claude CodeCodex

Plan a huge chunk of work — more than one agent session can hold — as a shared map of decision nodes on the work graph, and resolve them one at a time until the way to the destination is clear. Use to chart a map for a loose idea, or to walk an existing map's frontier. Every operation is a soma graph verb; nodes close…

the-metafactory/soma

Skill Claude CodeCodex

Use when work should run through the Algorithm: current-state to ideal-state, VSA/ISC creation or refinement, effort tiers, seven-phase execution, verification-first planning, substantial build/design/refactor/migration work, or explicit Algorithm requests.

the-metafactory/soma

Skill Claude CodeCodex

USE WHEN reproducing issue 86 — surfaces every claude-path rewrite class plus PAI Customization block.