emerge-context

Maps repositories, deployments, and stale documentation across the Emerge, Exam Studio, and CleverClass estate.

Updated Sep 1, 2026
One-click install
npx skills add https://github.com/Harbour-Emerge/skills --skill emerge-context-harbour-emerge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: emerge-context
Source: https://github.com/Harbour-Emerge/skills/tree/main/emerge-context
Command: npx skills add https://github.com/Harbour-Emerge/skills --skill emerge-context-harbour-emerge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working across eight repos for three products (Emerge, Exam Studio, CleverClass) means constantly rediscovering which repo owns what, what stack each actually runs, where things are deployed, and which widely-repeated claims are now stale. This Skill provides a verified orientation map so you open the right repo first and avoid acting on outdated documentation. ## Core Features & Use Cases - Repo routing table: Maps every repo on the drive to its product, verified stack (Go monolith, Django/DRF, FastAPI, Laravel, Next.js 16), and deployment target, including port allocations for the Exam Studio compose stack. - Git state awareness: Records current branches, dirty file counts, remote URLs, and traps like the archived read-only lms-questionbank-engine repo and the Harbour-Emerge org migration. - Stale-doc corrections: Lists eight specific corrections to EMERGE_SETUP.md plus estate-wide landmines such as decorative permission flags, unsigned tenant headers, and silent test skips. - Use Case: Before starting a task touching the survey platform, load this Skill to learn that Survey-Forms is a Go modular monolith on branch deploy/dockerize-cicd, deploys to the demo box behind Caddy on plain HTTP 8070, and that 443 is not open at the firewall. ## Quick Start Ask the assistant to orient you on the Emerge estate and tell you which repo to open for your current task.

Frequently Asked Questions about emerge-context

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find which repo owns a feature in the Emerge estate?

Consult the repo map table, which routes each product area to its repo and verified stack. Emerge spans Emerge-Design and Survey-Forms, Exam Studio spans the three lms-* services plus lms-tutor, and CleverClass and phd-monitoring are standalone repos.

What stack does the Exam Studio LMS system use?

Exam Studio uses Django with DRF for the paper orchestrator, FastAPI for the questionbank and retrieval engines, all wired by one docker-compose file in lms-paper-orchestrator/deploy. Host ports 8060-8063 map to container ports 8000-8300.

Can I push changes to the lms-questionbank-engine repository?

No, lms-questionbank-engine is archived and read-only on GitHub. Pushes fail with a 403 error that only surfaces on push, never on fetch, so plan around it before starting work that must land there.

Why does the deploy script fail with a bash carriage return error?

The repos are edited on Windows with core.autocrlf=true but run on Linux. Without .gitattributes forcing LF line endings, deploy.sh fails with a bash\r error that names neither the file nor the cause.

Is the X-School-Id header in Exam Studio an authentication mechanism?

No, X-School-Id is scoping, not authentication. The header is required and isolates data by tenant value, but it is unsigned, so any caller reaching port 8055 can claim any tenant. Cross-tenant reads deliberately return 404, never 403.

When should I not trust the CleverClass documentation?

CleverClass docs/deployment.md describes Vercel and Render, neither of which is used, and the README describes a chatbot when it is actually a commerce platform. Source deployment facts only from the deploy/ directory, never from docs/.