You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Update docs with Phase 0-1 completion status and learnings
AGENT_CONTEXT.md:
- Add current status table showing Phase 0-1 complete
- Note viral-baseimage is not local (use GitHub API)
- Document micromamba learnings (symlink location, PATH for non-interactive)
- Add decision log entries for license, base image, feature branch cleanup
- Document what was done in Phase 0 and Phase 1
- Add reference repositories section
MONOREPO_IMPLEMENTATION_PLAN.md:
- Mark Phase 0 as complete with checkmarks
- Mark Phase 1 as complete with completed items list
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: AGENT_CONTEXT.md
+57-8Lines changed: 57 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,6 +2,22 @@
2
2
3
3
> This document provides background context for the Claude Code agent that will implement the monorepo migration. Read this alongside `MONOREPO_IMPLEMENTATION_PLAN.md`.
| Phase 1: Foundation | ✅ COMPLETE | pyproject.toml, baseimage, CI workflow created |
13
+
| Phase 2: Migrate viral-core | 🔲 NOT STARTED | Next step |
14
+
| Phase 3: Migrate derivatives | 🔲 NOT STARTED | assemble, phylo, classify |
15
+
| Phase 4: Finalize | 🔲 NOT STARTED | mega image, docs, badges |
16
+
17
+
**Next action:** Push to origin, then start Phase 2 (migrate viral-core with git history preservation).
18
+
19
+
---
20
+
5
21
## Overview
6
22
7
23
You are helping migrate 5 separate git repositories into a single monorepo at `github.com/broadinstitute/viral-ngs`. This is a substantial refactoring project that will modernize the codebase's CI/CD, Docker builds, and Python packaging.
@@ -12,13 +28,13 @@ All repositories are located at `/Users/dpark/dev/`:
12
28
13
29
| Repository | Path | Description |
14
30
|------------|------|-------------|
15
-
| viral-baseimage |`/Users/dpark/dev/viral-baseimage`| Base Docker image with conda/python |
31
+
| viral-baseimage |NOT LOCAL (use GitHub API)| Base Docker image with conda/python |
2. **No default Python**: Must explicitly install Python in base image
206
-
3. **Symlink trick**: Create `conda` and `mamba` symlinks to `micromamba`
207
-
4. **Activation**: Set `MAMBA_DOCKERFILE_ACTIVATE=1`
222
+
3. **Symlink trick**: Create `conda` and `mamba` symlinks pointing to `/usr/bin/micromamba`
223
+
4. **Activation**: Set `ARG MAMBA_DOCKERFILE_ACTIVATE=1` for RUN commands
224
+
5. **PATH for non-interactive**: Must explicitly add `/opt/conda/bin` to PATH with `ENV` statement - the mambaorg entrypoint only sets PATH for interactive shells
225
+
6. **Base image**: Use `mambaorg/micromamba:2.4.0-ubuntu24.04` as base (simpler than building from scratch)
226
+
7. **Symlink location**: In mambaorg image, micromamba is at `/usr/bin/micromamba`, NOT `/usr/local/bin/`
208
227
209
228
## Test Strategy
210
229
@@ -261,13 +280,16 @@ These decisions have been made and should not be revisited:
0 commit comments