molecule-ai/molecule-ai-plugin-molecule-dev

Go to file

infra-sre d490e4ad8f All checks were successful CI / validate (pull_request) Successful in 57s Details CI / validate (push) Successful in 56s Details ci: rename .github/workflows -> .gitea/workflows (post-suspension sweep) GitHub org Molecule-AI was suspended 2026-05-06; SCM moved to Gitea (git.moleculesai.app). The wholesale `git push --mirror` migration left workflow files under .github/workflows/, which Gitea Actions does NOT read - it reads .gitea/workflows/ exclusively. This rename + the cross-repo `uses:` path rewrite are the minimum edits to make CI fire on this repo again. The workflow content itself is not modified (other than the path rewrites and lowercasing of the old `Molecule-AI` org reference to the post-suspension `molecule-ai`). Refs: feedback_post_suspension_migration_must_sweep_dormant_repos		2026-05-10 14:13:31 -07:00
.gitea/workflows	ci: rename .github/workflows -> .gitea/workflows (post-suspension sweep)	2026-05-10 14:13:31 -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
.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

README.md

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.