Skip to content
Template

python ml

official by meetsoma v1.0.0
pythonmldata-sciencepytorchtensorflownotebooks
Tierofficial
Version1.0.0
Authormeetsoma
Includes8 + 16 core
SourceGitHub ↗
soma init --template python-ml

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

/install template python-ml

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

soma fork template python-ml

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

Details

Python ML Template

Agent tuned for machine learning and data science projects. Reproducibility-first, proper experiment tracking, notebook-to-production discipline.

What's Included

  • Identity focused on ML workflows, data hygiene, and experiment reproducibility
  • Protocols: tool-discipline, quality-standards, working-style, pre-flight, correction-capture
  • Muscles: precision-edit, safe-file-ops, code-navigator
  • Scripts: soma-code, soma-reflect, soma-plans

Install

/hub install template python-ml

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

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

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

code navigator

v1.0.0

soma-code.sh — 11 commands for codebase navigation. map before editing, refs before renaming, find before grep.

official warm
toolingsearchrefactor
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 →