Skip to content
Template

core

core by meetsoma v2.0.0
Tiercore
Version2.0.0
Authormeetsoma
Includes0 + 16 core
SourceGitHub ↗
soma init --template core

New project — scaffolds .soma/ with this template's identity, protocols, and settings.

/install template core

Existing project — adds this template's protocols and settings to your current .soma/.

soma fork template core

Copies to ~/.soma/templates/core/ for customization. Your fork resolves first on future inits.

Details

Core

The default Soma setup. Clean, minimal, ready to grow.

Install

soma init

This is what every new Soma project starts with. No template flag needed.

What You Get

  • SOMA.md — seed identity file that grows into your agent's body/ over time
  • 13 bundled protocols — breath-cycle, heat-tracking, session-checkpoints, pattern-evolution, working-style, quality-standards, tool-discipline, correction-capture, detection-triggers, pre-flight, frontmatter-standard, git-identity, task-tracking
  • No pre-loaded muscles — you build muscle memory as you work
  • Settings — balanced defaults, standard heat thresholds

All 13 protocols ship with meetsoma — no install needed. Muscles and additional protocols can be added from the hub as your project evolves.

Recommended Add-ons

As your project grows, consider installing from the hub:

  • verification-instinct — verify after every meaningful change
  • pre-flight-check — check what exists before building something new
  • scope-discipline — do what was asked, no more
  • deep-recall — reconstruct working memory across sessions
soma install muscle verification-instinct

Best For

  • Starting fresh on any project
  • Learning how Soma works without noise
  • Building your own protocol stack from scratch
  • Resetting to clean defaults

What's Included

Ships with Soma

These core protocols are always available — no install needed.

breath cycle

v3.0.1

Inhale → hold → exhale. Auto-breathe at 50%/70%/85%. Rotation is self-initiated (natural-language wrap-up phrases fire it). The exhale is a complete checklist — the preload is the last step, never the only one.

core warm
sessionmemorycontinuity
Curtis Mercier

community safe

v2.1.0

Community/public content must never contain private data. ⚠ The channel guard blocks pro-keywords and credential FILE SHAPES only — nothing blocks emails, API keys or IPs at push time. This protocol covers the judgment and the check you must run yourself.

core cold
privacysafetyself-awareness
Curtis Mercier

correction capture

v1.1.0

When corrected, acknowledge without justifying, log old→new pattern, write a muscle if repeated. Third correction on same thing → escalate to protocol or identity.

core cold
learningself-improvementmemory
meetsoma

detection triggers

v1.0.0

Capture on corrections, preferences, 3+ patterns, knowledge gaps. Bubble-up: log → muscle → protocol → core.

core cold
learningself-improvementmemory
Curtis Mercier

frontmatter standard

v1.2.0

Every .md file needs frontmatter: type, status, created, updated. All AMPS get `## TL;DR` for warm-tier loading.

core cold
structuremetadataorganization
Curtis Mercier

git identity

v2.0.0

Soma's guard checks git identity on every commit. Configure expected email in settings.json — mismatches trigger warnings. This behavior is built into soma-guard.ts.

core cold
gitattributionidentity
Curtis Mercier

heat tracking

v2.0.0

Soma loads protocols and muscles by temperature: cold (skip), warm (breadcrumb), hot (full). Heat auto-adjusts from usage patterns and decays when idle. /pin and /kill for manual control.

core cold
memoryloadingperformance
Curtis Mercier

hub sharing

v1.0.0

How Soma handles /hub share. This behavior is built into the hub extension — this protocol helps you understand what's happening. Not loaded into the system prompt.

core cold
hubshareprivacy
Curtis Mercier

implementation plans

v1.0.0

Write plans your next self can execute without re-reading anything.

core cold
planningexecutioncontinuity
Curtis Mercier

meta workflow

v1.2.0

The operating cadence — how work flows in a project. Three nested loops (session / feature / evolution); the cadence self-amends from its own observations. The body IS the project; instantiate this as a per-project META_WORKFLOW.md.

core warm
workflowcadencecycles
meetsoma

pattern evolution

v1.4.0

Maturation: Skills → Muscles → Protocols → Automations. Born from gaps and repeated friction. Not every pattern climbs the full ladder.

core cold
learningpatternsgrowth
Curtis Mercier

pre flight

v1.0.0

Check what exists before creating. Verify assumptions before building.

core cold
workflowsafetyverification
meetsoma

response style

v1.0.0

Prefer prose over bullets. Minimum formatting for the content. One question per response max. No hollow social scripts.

core cold
communicationformattingux
meetsoma

session checkpoints

v2.0.0

Soma can auto-commit .soma/ state on every exhale and surface git diffs on boot. Two tracks: .soma/ internal git (never pushed) and project code (squash before push).

core cold
sessiongitcontinuity
Curtis Mercier

task tracking

v1.0.0

One board: .soma/_kanban.md. Move cards in real time. Verify on exhale. A stale board is worse than no board.

core cold
workflowplanningcontinuity
Curtis Mercier

tool discipline

v3.1.0

Scripts first, then raw commands. Read before edit. Check .soma/amps/scripts/ before writing grep/find. Build a script when you do the same thing twice.

core cold
toolssafetyself-awareness
meetsoma
View source on GitHub →