My aggregated monorepo of OCaml code, automaintained
Update CLAUDE.md usage tips
-37
-37
CLAUDE.md
-37
CLAUDE.md
···
14
14
| Sync all repos | `monopam sync` |
15
15
| Sync and push upstream | `monopam sync --remote` |
16
16
| Sync one repo | `monopam sync <repo-name>` |
17
-
| Create feature worktree | `monopam feature add <name>` |
18
-
| Remove feature worktree | `monopam feature remove <name>` |
19
-
| List feature worktrees | `monopam feature list` |
20
17
| Build | `opam exec -- dune build` |
21
18
| Test | `opam exec -- dune test` |
22
19
···
63
60
- **Always commit before sync**: `monopam sync` only exports committed changes
64
61
- **Check status first**: Run `monopam status` to see what needs attention
65
62
- **One repo per directory**: Each subdirectory maps to exactly one git remote
66
-
67
-
## Parallel Development with Feature Worktrees
68
-
69
-
Feature worktrees allow multiple Claudes (or developers) to work on different
70
-
features simultaneously in separate branches:
71
-
72
-
```bash
73
-
# Create worktrees for parallel work
74
-
monopam feature add auth-system
75
-
monopam feature add api-refactor
76
-
77
-
# Each worktree is at work/<name> on branch <name>
78
-
cd work/auth-system # On branch 'auth-system'
79
-
cd work/api-refactor # On branch 'api-refactor'
80
-
81
-
# When done, merge back to main
82
-
cd mono
83
-
git merge auth-system
84
-
git merge api-refactor
85
-
86
-
# Clean up
87
-
monopam feature remove auth-system
88
-
monopam feature remove api-refactor
89
-
```
90
-
91
-
Workspace structure with features:
92
-
```
93
-
root/
94
-
├── mono/ # Main monorepo (main branch)
95
-
├── work/
96
-
│ ├── auth-system/ # Worktree on 'auth-system' branch
97
-
│ └── api-refactor/ # Worktree on 'api-refactor' branch
98
-
└── ...
99
-
```
100
63
101
64
## Troubleshooting
102
65