Loam Code

Loam Code is an expansion pack for Loam. It packages viv shaw's coding standards, language-specific patterns, testing guidance, comment guidance, and Git commit practices as portable Agent Skills.

Loam Code installs independently. Pair it with Loam for the research, planning, implementation, debugging, and review workflows referenced by its guidance.

Principles

• Prefer idiomatic code, concrete designs, and clear module boundaries.
• Rule out errors with strict typechecking, linting, formatting, and tests.
• Validate data at system boundaries and keep trusted interiors simple.
• Write tests around behavior, invariants, and meaningful failure modes.
• Keep comments and commits concise, accurate, and useful to future readers.

Install

Loam Code ships one canonical skills/ tree to Agent Plugins clients, Claude Code, Codex, OpenCode, and Pi.

Agent Plugins

Install this repository with any client that supports the Agent Plugins format.

Claude Code

Through the Loam marketplace:

/plugin marketplace add rhizomatous/loam
/plugin install loam-code@loam

Or add this repository directly and install loam-code@loam-code.

Codex

codex plugin marketplace add rhizomatous/loam
codex plugin add loam-code@loam

OpenCode

Add the npm package to opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@vivshaw/loam-code"]
}

Pi

pi install git:github.com/rhizomatous/loam-code
# or...
pi install npm:@vivshaw/loam-code

Contents

• Core practice: coding-effectively and defense-in-depth.
• Languages and runtimes: howto-code-in-go, howto-code-in-python, howto-code-in-rust, howto-code-in-typescript, howto-develop-with-postgres, and programming-in-react.
• Testing: writing-good-tests and property-based-testing.
• Engineering prose: writing-comments and writing-git-commits.

Each skill and its supporting resources live under skills/.

Development

See docs/CONTRIBUTING.md.

Credits

Loam Code is licensed under CC BY-SA 4.0.

• Material adapted from obra/superpowers retains its MIT license notice.
• Material adapted from ed3dai/ed3d-plugins retains its CC BY-SA 4.0 license notice.