mcpField
M
monorepo-setup-git

monorepo-setup-git

github.com/editframeDevelopment1968 installsUpdated 2w ago
Repository

About monorepo-setup-git

monorepo-setup-git is a skill documenting Git conventions for an Editframe monorepo and its sibling telecine and elements repositories. It covers where to push changes, how skills are synchronized, and how to monitor CI and deployment workflows.

Key features

  1. 01Documents sibling repository layout
  2. 02Defines push and pull workflows
  3. 03Describes skills synchronization
  4. 04Lists CI monitoring scripts
  5. 05Explains the telecine deploy gate

Use cases

  1. 01Choose the correct repository and remote for a push
  2. 02Sync skills from the monorepo
  3. 03Monitor deployment and release jobs

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/editframe/skills --skill monorepo-setup-git

After installing, type/monorepo-setup-gitin Claude Code to confirm it loaded.

Details

From the project README

Monorepo Git Configuration

Repo Layout

telecine and elements are standalone sibling repos cloned alongside the monorepo:

~/Editframe/worktrees/<branch>/
  monorepo/     # primary monorepo checkout
  telecine/     # telecine repo clone
  elements/     # elements repo clone

The monorepo has one remote: skills → [email protected]:editframe/skills.git.

telecine and elements each have origin pointing to their respective GitHub repos.

Push/Pull Workflows

Telecine

Work directly in the sibling telecine repo. Push to origin from there:

# From ~/Editframe/worktrees/<branch>/telecine/
git push origin main           # push to telecine main
git push origin <branch>       # push a branch

Never push telecine from the monorepo root.

Elements

Work directly in the sibling elements repo:

# From ~/Editframe/worktrees/<branch>/elements/
git push origin main
git push origin <branch>
git push origin v<version>     # push a tag to trigger release CI
Skills

Skills are pushed from the monorepo using the provided script:

# From monorepo/
scripts/push-skills

This pushes to the skills remote ([email protected]:editframe/skills.git).

The skills-sync tag tracks the last synced commit:

git tag -f -a skills-sync HEAD -m "skills synced $(date -I)"
git push skills skills-sync

CI Monitoring

# Poll telecine deploy until complete
scripts/wait-for-telecine-action

# Poll elements release until complete
scripts/wait-for-elements-action

# Get failed job logs
scripts/gh-logs editframe/telecine
scripts/gh-logs editframe/elements

Telecine Deploy Gate

A push to telecine/main triggers CI. The deploy job only runs after build-runner, all docker (*) matrix jobs, integration, typecheck, and playwright all pass. Pushing directly to main is allowed — CI gates the deploy.

Standard flow for a branch:

# From telecine/
git push origin <branch>
# Open PR on github.com/editframe/telecine, let CI pass, merge
# Then from monorepo/
scripts/wait-for-telecine-action

Comments

Markdown supported