molecule-ai/molecule-ai-workspace-template-claude-code
35
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: align runbook + known-issues with molecule-core local-build flow (followup to molecule-core #63) #5

New Issue
Open
opened 2026-05-07 22:16:27 +00:00 by claude-ceo-assistant · 0 comments
claude-ceo-assistant commented 2026-05-07 22:16:27 +00:00
Owner
Copy Link

Followup to molecule-core Issue #63 / Task #194 (PR landing 2026-05-07).

What changed in molecule-core

When MOLECULE_IMAGE_REGISTRY is unset, the workspace-server provisioner now clones THIS template repo from Gitea and docker builds it locally instead of attempting the (post-suspension 403) GHCR pull. See molecule-core/docs/adr/ADR-002-local-build-mode-via-registry-presence.md for the full design.

Doc updates needed in this repo

runbooks/local-dev-setup.md Step 1

Replace the GitHub clone URL (currently 403 on the suspended org) with the Gitea canonical URL:

-git clone https://github.com/Molecule-AI/molecule-ai-workspace-template-claude-code.git
+git clone https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-claude-code.git

Add a note that explains: when the contributor is running molecule-core locally with MOLECULE_IMAGE_REGISTRY unset, the provisioner clones this repo automatically — manual cloning is only needed when modifying template code itself.

known-issues.md

Append §5 documenting the post-2026-05-06 image-source flow:

  • GHCR returns 403 for molecule-ai/workspace-template-* (org suspended)
  • Provisioner switched to local-build mode when MOLECULE_IMAGE_REGISTRY is unset
  • First-provision build is 5–10 min on Apple Silicon; cached afterwards
  • Production tenants unaffected (their MOLECULE_IMAGE_REGISTRY points at ECR)
  • Pointer to molecule-core's docs/development/local-development.md and ADR-002

Draft text is in molecule-core PR description. Copy verbatim from there once that PR is merged.

Why this is a separate issue

The local copy of this template repo on the implementing agent's host (~/molecules-org/.../) is a gitignored sandbox per the saved memory feedback_workspace_template_sandbox_is_stale — its origin still points at the suspended GitHub URL. PRs against this Gitea repo need to be opened from a fresh Gitea-origin clone. Filing as a doc-only follow-up.

Acceptance criteria

  • runbook clone URL updated to Gitea
  • known-issues §5 added
  • PR linked back to molecule-core #63 (closing comment)
Followup to molecule-core Issue #63 / Task #194 (PR landing 2026-05-07). ## What changed in molecule-core When `MOLECULE_IMAGE_REGISTRY` is unset, the workspace-server provisioner now clones THIS template repo from Gitea and `docker build`s it locally instead of attempting the (post-suspension 403) GHCR pull. See `molecule-core/docs/adr/ADR-002-local-build-mode-via-registry-presence.md` for the full design. ## Doc updates needed in this repo ### `runbooks/local-dev-setup.md` Step 1 Replace the GitHub clone URL (currently 403 on the suspended org) with the Gitea canonical URL: ```diff -git clone https://github.com/Molecule-AI/molecule-ai-workspace-template-claude-code.git +git clone https://git.moleculesai.app/molecule-ai/molecule-ai-workspace-template-claude-code.git ``` Add a note that explains: when the contributor is running `molecule-core` locally with `MOLECULE_IMAGE_REGISTRY` unset, the provisioner clones this repo automatically — manual cloning is only needed when modifying template code itself. ### `known-issues.md` Append §5 documenting the post-2026-05-06 image-source flow: * GHCR returns 403 for `molecule-ai/workspace-template-*` (org suspended) * Provisioner switched to local-build mode when `MOLECULE_IMAGE_REGISTRY` is unset * First-provision build is 5–10 min on Apple Silicon; cached afterwards * Production tenants unaffected (their `MOLECULE_IMAGE_REGISTRY` points at ECR) * Pointer to molecule-core's `docs/development/local-development.md` and ADR-002 Draft text is in molecule-core PR description. Copy verbatim from there once that PR is merged. ## Why this is a separate issue The local copy of this template repo on the implementing agent's host (`~/molecules-org/.../`) is a gitignored sandbox per the saved memory `feedback_workspace_template_sandbox_is_stale` — its `origin` still points at the suspended GitHub URL. PRs against this Gitea repo need to be opened from a fresh Gitea-origin clone. Filing as a doc-only follow-up. ## Acceptance criteria * [ ] runbook clone URL updated to Gitea * [ ] known-issues §5 added * [ ] PR linked back to molecule-core #63 (closing comment)
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
No items
No Label
Milestone
Clear milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: molecule-ai/molecule-ai-workspace-template-claude-code#5
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?