molecule-dev

Molecule AI codebase conventions, quality standards, past bugs, and coordination workflows. Agents operating in Molecule AI workspaces load these rules automatically.

What it provides

Codebase conventions (`rules/codebase-conventions.md`)

Patterns, idioms, and anti-patterns specific to the Molecule AI codebase. Covers:

Python style (type hints, docstrings, error handling)
Go conventions (context usage, error wrapping)
Directory structure and naming
Deprecation policy

Review loop skill (`review-loop`)

Guides the agent through a structured review before each commit:

Scope check — does the diff match the ticket?
Style check — conventions followed?
Test check — coverage sufficient?
Security check — secrets or injection risks?
Sign-off — agent declares the change ready

Install

In org template (org.yaml)

plugins:
  - molecule-dev

From URL (community install)

github://Molecule-AI/molecule-ai-plugin-molecule-dev

Runtimes

claude_code — primary
deepagents — supported
hermes — supported

Architecture

rules/
  codebase-conventions.md   # Prose rules loaded into agent memory
adapters/
  claude_code.py            # Registers rules + review-loop skill
skills/
  review-loop/              # SKILL.md + scripts/
runbooks/
  local-dev-setup.md        # Setup guide for contributors

Known issues

See known-issues.md.

1.5 KiB Raw Blame History