fullstack
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.0Scripts 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.
quality standards
v1.0.0Deletion 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.
working style
v1.2.0Be 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.
git identity
v2.0.0Soma'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.
pre flight
v1.0.0Check what exists before creating. Verify assumptions before building.
correction capture
v1.1.0When corrected, acknowledge without justifying, log old→new pattern, write a muscle if repeated. Third correction on same thing → escalate to protocol or identity.
detection triggers
v1.0.0Capture on corrections, preferences, 3+ patterns, knowledge gaps. Bubble-up: log → muscle → protocol → core.
pattern evolution
v1.4.0Maturation: Skills → Muscles → Protocols → Automations. Born from gaps and repeated friction. Not every pattern climbs the full ladder.
precision edit
v1.0.0the match must be verified by `read` first.
safe file ops
v1.0.0Safe file operations — read before write, verify after edit, never delete without scanning dependencies.
task tooling
v1.0.0Before touching code, name your tools. Map scripts, muscles, and MAPs for each phase of the task. Gaps are worth building for.
test hygiene
v1.1.0Validate 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.
doc hygiene
v1.0.0plans rot. Update `remaining` on every touch. Empty → archive. After shipping, scan for stale docs. Verify docs match code before referencing.
micro exhale
v1.0.0after major completions, append `## HH:MM` summary to session log. One file per day, read first, never overwrite. Checkpoint within session, not a full exhale.
Ships with Soma
These core protocols are always available — no install needed.
breath cycle
v3.0.1Inhale → 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.
community safe
v2.1.0Community/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.
correction capture
v1.1.0When corrected, acknowledge without justifying, log old→new pattern, write a muscle if repeated. Third correction on same thing → escalate to protocol or identity.
detection triggers
v1.0.0Capture on corrections, preferences, 3+ patterns, knowledge gaps. Bubble-up: log → muscle → protocol → core.
frontmatter standard
v1.2.0Every .md file needs frontmatter: type, status, created, updated. All AMPS get `## TL;DR` for warm-tier loading.
git identity
v2.0.0Soma'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.
heat tracking
v2.0.0Soma 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.
hub sharing
v1.0.0How 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.
implementation plans
v1.0.0Write plans your next self can execute without re-reading anything.
meta workflow
v1.2.0The 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.
pattern evolution
v1.4.0Maturation: Skills → Muscles → Protocols → Automations. Born from gaps and repeated friction. Not every pattern climbs the full ladder.
pre flight
v1.0.0Check what exists before creating. Verify assumptions before building.
response style
v1.0.0Prefer prose over bullets. Minimum formatting for the content. One question per response max. No hollow social scripts.
session checkpoints
v2.0.0Soma 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).
task tracking
v1.0.0One board: .soma/_kanban.md. Move cards in real time. Verify on exhale. A stale board is worse than no board.
tool discipline
v3.1.0Scripts 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.