proposal: Consolidate optional local dev services into monorepo#2058
Draft
nick-inkeep wants to merge 2 commits intomainfrom
Draft
proposal: Consolidate optional local dev services into monorepo#2058nick-inkeep wants to merge 2 commits intomainfrom
nick-inkeep wants to merge 2 commits intomainfrom
Conversation
|
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Add SPEC.md for eliminating the companion repo (agents-optional-local-dev) by moving all Docker Compose configs, service configs, and setup automation directly into the agents monorepo and create-agents-template. Key points: - Move configs to optional-services/ in monorepo root - Rewrite setup-optional.sh to contain full logic (no shim/clone) - Auto-sync to create-agents-template via lint-staged + rsync - Update all docs (3 local dev + 5 deployment guides) - Archive companion repo with redirect README - User-facing pnpm commands unchanged See the spec for full surface area inventory, technical design, migration path, and acceptance criteria. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
nick-inkeep
force-pushed
the
proposal/consolidate-optional-services
branch
from
aec29f1 to
1c99906
Compare
7 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Proposal spec for consolidating the
agents-optional-local-devcompanion repo directly into theagentsmonorepo.Spec:
docs/proposals/consolidate-optional-services.mdProblem
Optional local dev services (Nango, SigNoz, OTEL Collector, Jaeger) live in a separate companion repo. A bootstrap shim clones it on demand. This creates coordination overhead (paired PRs, cross-repo sync) for ~3.3MB of configs with no legal barrier to inlining.
Proposed change
optional-services/at monorepo rootsetup-optional.sh— absorb companion'ssetup.shdirectly, eliminating the clone/delegate shimcreate-agents-template/via lint-staged + rsyncWhat stays the same
setup-dev:optional,optional:stop,optional:status,optional:reset.envdocker-compose.dbs.yml)Pending decisions for implementer
cp -Rin a pre-commit hookOPTIONAL_SERVICES_DIRenv var override — recommend dropping, trivial to re-addImplementation notes
biome.jsonchasignoreUnknown: false— committed YAML/XML inoptional-services/will need a Biome exclusionname: optional-servicesto the compose file for stable Docker project naming🤖 Generated with Claude Code