Skip to content
Template

fullstack

official by meetsoma v1.0.0
Tierofficial
Version1.0.0
Authormeetsoma
Includes14 + 16 core
SourceGitHub ↗
soma init --template fullstack

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

/install template fullstack

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

soma fork template fullstack

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

Details

Full-Stack Developer

The daily driver. Every muscle and protocol you need for productive web and app development, with learning protocols that adapt to your codebase over time.

Install

soma install template fullstack

What You Get

  • 6 muscles — precision-edit (hot), safe-file-ops, task-tooling, test-hygiene, doc-hygiene, micro-exhale
  • 8 protocols — tool-discipline, quality-standards, working-style, git-identity, pre-flight, correction-capture, detection-triggers, pattern-evolution
  • SOMA.md — full-stack identity that moves between layers fluently
  • Settings — balanced budget, standard heat thresholds

Recommended Add-ons

These hub AMPS extend the daily driver for heavier workloads:

  • code-navigator — fast codebase navigation with soma-code.sh
  • verification-instinct — verify after every meaningful change
  • scope-discipline — do what was asked, no more
  • incremental-refactor — scan before touching, one file at a time
soma install muscle code-navigator

Best For

  • Day-to-day feature development
  • Bug fixing and debugging
  • Code review and iteration
  • Projects where you want the agent to learn your conventions over time

What's Included

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

quality standards

v1.0.0

Deletion is irreversible — move or archive. Tests cover NEW code, not just pass on old. Blast radius before editing — find every caller, test, and doc. Atomic commits — one concern each.

official cold
qualitysafetygit
meetsoma

working style

v1.2.0

Be direct — no ceremony. Lead with action. Know your tools before starting — name them, note gaps. Understand before you change, verify after you build AND after you ship. Maintain the tools — when code changes, verify scripts still produce correct output. Plans live in files, not in context.

official warm
workflowstylecommunication
meetsoma

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

pre flight

v1.0.0

Check what exists before creating. Verify assumptions before building.

core cold
workflowsafetyverification
meetsoma

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

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

precision edit

v1.0.0

the match must be verified by `read` first.

official warm
editingworkflowcopy
meetsoma

safe file ops

v1.0.0

Safe file operations — read before write, verify after edit, never delete without scanning dependencies.

official warm
safetyfilesediting
meetsoma

task tooling

v1.0.0

Before touching code, name your tools. Map scripts, muscles, and MAPs for each phase of the task. Gaps are worth building for.

official warm
workflowplanningtools
meetsoma

test hygiene

v1.1.0

Validate tests aren't stale after any code removal, rename, or restructure. Run all suites, grep for orphaned references, check pass counts. Dead tests are worse than no tests.

official warm
meetsoma

doc hygiene

v1.0.0

plans rot. Update `remaining` on every touch. Empty → archive. After shipping, scan for stale docs. Verify docs match code before referencing.

official warm
meetsoma

micro exhale

v1.0.0

after major completions, append `## HH:MM` summary to session log. One file per day, read first, never overwrite. Checkpoint within session, not a full exhale.

official hot
meetsoma

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 →