claude-ceo-assistant created pull request molecule-ai/docs#1

claude-ceo-assistant
Thu, 07 May 2026 07:39:23 +0000

1#docs(install): migrate active github.com refs to git.moleculesai.app (#37)#

What

Sweep of docs repo for active github.com/Molecule-AI references. Part of internal#37 per-repo doc sweep series. Phase 1 findings: internal#38.

98 hits total in docs. 12 actionable edits across 9 files (2 commits — initial sweep + follow-up after re-read caught additional /tree// paths). 86+ historical PR/issue cross-refs LEFT AS-IS per Q3 audit-trail decision.

Per-file change summary

Commit 1 (d05d92b) — initial sweep, 7 edits / 5 files

File | Change
app/(home)/page.tsx:21 | molecule-monorepo (404 on Gitea — renamed) → molecule-core (Gitea). "View on GitHub" → "View on Gitea".
content/docs/quickstart.md:14 | git clone github.com/Molecule-AI/molecule-core → git.moleculesai.app/molecule-ai/molecule-core
content/docs/quickstart.md:81 | "GitHub repo" link → "Gitea repo"
content/docs/self-hosting.mdx:20 | git clone (same as quickstart:14)
content/docs/architecture.mdx:141 | github.com/Molecule-AI/molecule-cli (PUBLIC) → git.moleculesai.app/molecule-ai/molecule-cli
content/docs/architecture/molecule-technical-doc.md:7 | molecule-monorepo doc-scan reference → molecule-core (with explicit rename note)
content/docs/architecture/molecule-technical-doc.md:1156-1160 | Footer "Links" section: GitHub → Gitea, /tree/ → /src/branch/ path-shape

Commit 2 (a52ed96) — follow-up, 5 edits / 4 files

File | Change
content/docs/guides/remote-workspaces.md:151,152 | molecule-sdk-python links (PUBLIC) → Gitea, /tree/main → /src/branch/main
content/docs/guides/external-workspace-quickstart.md:223 | Design-doc link in internal/ (PRIVATE) → Gitea path; tracking-issue link reformulated
content/docs/guides/skill-catalog.md:68,174 | molecule-ai/skills repo doesn't exist on Gitea (404) — replaced with placeholder note pointing at internal issue tracker
docs/marketing/blog/2026-04-20-...mcp.md:240 | GitHub Discussions (no Gitea equivalent) → issue-tracker link

LEFT AS-IS (per Q3 + parked follow-ups)

Surface | Count | Why
content/docs/changelog.mdx historical PR/issue cross-refs | 86+ | Audit trail per Phase 1 #38 B3. Rewriting falsifies the changelog.
content/docs/changelog.mdx:349 "Documentation Specialist" link to org page | 1 | Meta-narrative author attribution; org-page is dead but historical attribution stays.
content/docs/guides/external-workspace-quickstart.md:229 gist link | 1 | gist.github.com/molecule-ai/... — gist is gone with the org; no Gitea-snippet equivalent. Could remove entirely; left for parked-follow-up call (worth its own discussion, not a host-substitution).
content/docs/incidents/INCIDENT_LOG.md:168,175 git clone --mirror | 2 | These describe a historical incident-response action ("we mirrored these repos for backup"); rewriting them changes the incident narrative.

DoD waivers

Pure-docs PR. No tests / security / observation / back-compat / migration / version bump. The new Gitea URLs work for logged-in viewers (private repos → Gitea private-repo response is more informative than github 404).

Hostile self-review (3 weakest spots)

1. docs is a Next.js docs site; the changes include a .tsx file edit (app/(home)/page.tsx). No frontend test was run. The "View on GitHub" → "View on Gitea" string change is text-content; no logic changed. Mitigation: site builds the same since the surrounding JSX is unchanged. Accepted because: a docs-site dev-server boot is order-of-magnitude bigger than the change merits.

2. The skill-catalog.md placeholder is a known-incomplete fix. molecule-ai/skills isn't on Gitea; the placeholder points users at the internal issue tracker instead, which they may not have access to. Mitigation: noted explicitly in the changed text ("repo location TBD post-2026-05-06 GitHub-org-suspension"); reader knows it's an interim state. Accepted because: alternative (delete the skill-submission section entirely) loses the documentation surface that may be restored when skills repo is recreated.

3. Two passes were needed — my first grep filter -vE "/(issues|pull|commit|releases)/" missed /tree/<branch>/ paths AND active mentions in guides/. The follow-up commit caught them. Lesson: for future sweeps, also exclude /blob/ and the /tree/ paths separately, OR positively select for "(?:git clone|/blob/|/tree/|<a href)" patterns instead of negative filtering.

Refs: internal#37, internal#38.