Loam

Loam is a portable suite of Agent Skills for software development. It grew from obra/superpowers and ed3dai/ed3d-plugins, with an emphasis on lightweight planning, independent review loops, clear prose, and durable project state.

Principles

• Prefer simplicity, directness, and concision.
• Use strict typechecking, linting, formatting, and tests to rule out errors.
• Start projects with questions and write short, verifiable requirements.
• Keep project plans lightweight and use one durable progress record.
• Delegate bounded implementation and research to fresh native subagents when available.
• Have a different context review work than the one that wrote it.

Install

Loam ships the same skills/ tree to Agent Plugins clients, Claude Code, Codex, OpenCode, and Pi. It contains no custom agents or lifecycle hooks.

Agent Plugins

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

Claude Code

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

Codex

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

OpenCode

Add the npm package to opencode.json:

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

Pi

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

Use

Describe the work normally: “plan this feature,” “implement this project plan,” “debug this failure,” or “review this branch.” The host discovers relevant skills from their descriptions. To get oriented, ask: “How can I use Loam?”

The main workflow is research, plan, implement, review. Planning produces .loam/projects/<project>/spec.md, plan.md, and isolated issue files.

Contents

• Workflow: design exploration, PRD writing, project planning, implementation, TDD, independent review, debugging, and branch completion.
• Research: codebase investigation plus internet and remote-source research.

Every skill and its supporting resources live under skills/.

Expansion Packs

Loam Meta provides the authoring skills for agent directives, Agent Skills, portable packages, marketplaces, and AGENTS.md maintenance. It installs independently and is also listed in Loam's Claude Code and Codex marketplaces.

Loam Code provides coding standards and language-specific guidance for TypeScript, React, Go, Python, Rust, PostgreSQL, testing, comments, commits, and defensive design. Install it alongside Loam to retain the former bundled coding guidance; it is also listed in Loam's Claude Code and Codex marketplaces.

Loam Research provides technical-writing and data-visualization guidance, including the house palette, accessibility rules, validation scripts, and reference assets. It installs independently and is also listed in Loam's Claude Code and Codex marketplaces.

The .loam directory

This directory contains all the planning materials your agent writes. It's up to you whether to commit it to git or ignore it. Personally, I would recommend ignoring it. I think the types of written material that make good project guidance for an agent are very different from the types of written material that makes good durable documentation.

Development

See docs/CONTRIBUTING.md.

Remix Loam

Tune the suite to your own workflow: swap its PRD format, issue tracker, coding standards, review policy, or language guidance. Install Loam Meta when changing skills, agent directives, or package adapters.

Credits

Loam 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.