Go to file
2026-05-10 19:51:20 +00:00
.github/workflows fix(ci): lowercase 'molecule-ai/' in cross-repo workflow refs 2026-05-07 00:59:15 -07:00
.molecule-ci/scripts import from local vendored copy (2026-05-06) 2026-05-06 13:53:26 -07:00
adapters import from local vendored copy (2026-05-06) 2026-05-06 13:53:26 -07:00
rules import from local vendored copy (2026-05-06) 2026-05-06 13:53:26 -07:00
runbooks docs(install): migrate git clone URL to git.moleculesai.app (#37)\n\nAnonymous git-clone refs in CLAUDE.md, runbooks/local-dev-setup.md migrated github.com/Molecule-AI \u2192 git.moleculesai.app/molecule-ai. Public repo, no auth-shape change. Same pattern as the other plugin-* sweeps in the #37 series.\n\nRefs: molecule-ai/internal#37, molecule-ai/internal#38, molecule-ai/internal#42 2026-05-07 00:01:08 -07:00
skills/review-loop import from local vendored copy (2026-05-06) 2026-05-06 13:53:26 -07:00
tests test(molecule-dev): add 26-test smoke suite + coverage rationale 2026-05-10 13:59:48 +00:00
.ci-recovery-marker-1778442674.txt chore(ci): re-fire after incident recovery 2026-05-10 (see internal#233; revert me) 2026-05-10 19:51:20 +00:00
.gitignore chore: append Python ignores to .gitignore 2026-05-10 16:19:50 +00:00
CLAUDE.md docs(install): migrate git clone URL to git.moleculesai.app (#37)\n\nAnonymous git-clone refs in CLAUDE.md, runbooks/local-dev-setup.md migrated github.com/Molecule-AI \u2192 git.moleculesai.app/molecule-ai. Public repo, no auth-shape change. Same pattern as the other plugin-* sweeps in the #37 series.\n\nRefs: molecule-ai/internal#37, molecule-ai/internal#38, molecule-ai/internal#42 2026-05-07 00:01:08 -07:00
known-issues.md import from local vendored copy (2026-05-06) 2026-05-06 13:53:26 -07:00
plugin.yaml import from local vendored copy (2026-05-06) 2026-05-06 13:53:26 -07:00
README.md docs: write substantive README.md 2026-05-10 08:33:55 +00:00

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:

  1. Scope check — does the diff match the ticket?
  2. Style check — conventions followed?
  3. Test check — coverage sufficient?
  4. Security check — secrets or injection risks?
  5. 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.

License

Business Source License 1.1 — © Molecule AI.