molecule-core/.claude/CLAUDE_LOOP_NOTES.md
Hongming Wang 24fec62d7f initial commit — Molecule AI platform
Forked clean from public hackathon repo (Starfire-AgentTeam, BSL 1.1)
with full rebrand to Molecule AI under github.com/Molecule-AI/molecule-monorepo.

Brand: Starfire → Molecule AI.
Slug: starfire / agent-molecule → molecule.
Env vars: STARFIRE_* → MOLECULE_*.
Go module: github.com/agent-molecule/platform → github.com/Molecule-AI/molecule-monorepo/platform.
Python packages: starfire_plugin → molecule_plugin, starfire_agent → molecule_agent.
DB: agentmolecule → molecule.

History truncated; see public repo for prior commits and contributor
attribution. Verified green: go test -race ./... (platform), pytest
(workspace-template 1129 + sdk 132), vitest (canvas 352), build (mcp).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-13 11:55:37 -07:00

1.0 KiB

Loop discipline — process notes

Rule: a "skipped" PR must have a comment explaining the skip

When the hourly maintenance loop skips a PR for any reason — CI red, conflicting, merge dirty, missing tests, design drift — the FIRST skip in a session must leave a PR comment with the specific blocker and the exact fix the author needs to apply. Subsequent skips of the same PR (SHA unchanged) can be silent.

The failure mode this rule prevents: silently skipping a PR for many hours under a vague reason ("blocked / no CI / conflicting") without ever telling the author what they need to do. The PR sits indefinitely because the author has no comment to act on.

Concrete check at the top of each loop:

  • For every "known-blocked" PR I'm about to silently skip, verify there is a bot/me comment on the PR newer than the PR's head SHA that names the specific blocker. If not, that PR isn't actually blocked on the author — it's blocked on me writing the comment.

Caught 2026-04-13 on PR #114 (skipped 6+ loops with no comment).