Skip to content

Correct vendor/ docs: snapshots, not git subtree/submodule#200

Draft
weishi-imbue wants to merge 1 commit into
mainfrom
mngr/doc-update-git
Draft

Correct vendor/ docs: snapshots, not git subtree/submodule#200
weishi-imbue wants to merge 1 commit into
mainfrom
mngr/doc-update-git

Conversation

@weishi-imbue

@weishi-imbue weishi-imbue commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Summary

Corrects the vendor/ guidance so agents stop treating vendor/mngr / vendor/tk as git subtrees.

CLAUDE.md told agents to add external read-only dependencies as a git subtree under vendor/, but the team's actual model (per the vendor/mngr discussion) is that vendor/mngr and vendor/tk are plain copied-in snapshots: vendor/mngr re-synced from the mngr monorepo (git archive for releases, rsync for dev iteration), vendor/tk a manually-maintained fork with no upstream pull. Neither is a subtree or submodule.

Changes

  • CLAUDE.md -- replace the "add a git subtree" instruction with the real model; tell agents not to run git subtree / git submodule against vendor/.
  • README.md -- note how each vendored dependency is maintained.

The mngr monorepo's canonical sync doc (apps/minds/docs/vendor-mngr-sync.md) is added in a companion PR (imbue-ai/mngr#2241).

Generated with Claude Code

CLAUDE.md told agents to add external read-only deps as a git subtree, but vendor/mngr and vendor/tk are plain copied-in snapshots. State the real model (vendor/mngr re-synced from the mngr monorepo via just sync-vendor-mngr / the release flow; vendor/tk a manually-maintained fork, no upstream pull) and note the maintenance mechanism in README.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant