임무 중심 조직을 위한 고성능 Next.js 16.4.2 (앱 라우터) Turborepo 모노레포로, 세 가지 앱(apps/admin, [[T1])과 공유 작업 공간 패키지(packages/*)를 포함하고 있습니다.

퀵스타트

선택적으로 6명의 에이전트가 있는 GitHub 이슈-투-develop 워크플로우를 사용할 때는 다음 기능을 사용하세요 삼손 코덱스 클라우드 가이드. node scripts/factory/setup-cloud.mjs는 동결된 의존성을 설치하고 네이티브 개인 지시; --verify-only는 수리 없이 기존 세팅을 점검합니다. 코디네이터는 네이티브 핸드오프를 제어합니다; 설정은 이슈 트라이얼을 시작하지 않습니다.

1. 사전 조건 설치: Node.js 24.22.1, Bun 1.4.3, 그리고 PATH에 Git을 설치하세요.
2. 설정 경로를 선택하세요.

자격 증명 없는 미션 컨트롤 샌드박스

이 경로를 새 복제, 일회용 에이전트 환경, 또는 첫 실행 시 아직 Supabase 자격 증명이 없습니다:

그 다음 http://localhost:3030를 엽니다. setup 명령어가 gitignored를 생성합니다 .env.local가 기본값이 되고, 동결된 락파일로 의존성을 설치한 뒤 실행됩니다 bun run skills:verify.

호스팅된 Supabase 앱 개발

Supabase 프로젝트 URL과 익명 공개 키가 있을 때 이 경로를 사용하세요:

1. 실행 설정 (‘.env. 생성’

Asymmetric.al - Kingdom Impact Platform

A high-performance Next.js 16.4.2 (App Router) Turborepo monorepo for mission-focused organizations, with three apps (apps/admin, apps/donor, apps/missionary) and shared workspace packages (packages/*).

Quickstart

For the optional six-agent GitHub issue-to-develop workflow, use the Samson Codex Cloud guide. node scripts/factory/setup-cloud.mjs installs frozen dependencies and native personal instructions; --verify-only checks existing setup without repair. The coordinator controls native handoffs; setup does not start an issue trial.

1. Install prerequisites: Node.js 24.22.1, Bun 1.4.3, and Git on your PATH.
2. Choose your setup path.

Credential-free Mission Control sandbox

Use this path for a fresh clone, disposable agent environment, or first run when you do not have Supabase credentials yet:

bun run setup:mission-control:cloud
bun run dev:mission-control

Then open http://localhost:3030. The setup command creates gitignored .env.local defaults, installs dependencies with the frozen lockfile, and runs bun run skills:verify.

Hosted Supabase app development

Use this path when you have a Supabase project URL and anon public key:

1. Run setup (creates .env.local on first run if needed, installs dependencies, checks that committed skill mirrors match docs/ai/skills/, then runs repo setup checks):
   • macOS / Linux / Git Bash: bun run setup
   • Windows PowerShell: see Windows below (.\scripts\setup.ps1).
2. Fill required Supabase values in .env.local if the first run stopped with “missing required env vars”, then run setup again.
3. Start dev: bun run dev (or an app-specific script from package.json). For a single surface, bun run dev:donor is typical (donor on port 3000).
4. Optional smoke check: bun run verify (implemented in scripts/verify/index.mjs). Set VERIFY_HTTP=1 and VERIFY_BASE_URL= when you also want HTTP route checks.

After git pull when skill files changed: run bun run skills:verify. If it reports drift between docs/ai/skills/ and the mirrors under .agents/skills/, .cursor/skills/, and .claude/skills/, run bun run skills:sync and commit the updated mirror files so CI and teammates stay aligned.

Required for hosted Supabase app development: NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY

Optional: Other entries in .env.example (Stripe, demo accounts, etc.)

bun run dev runs all apps via Turbo (turbo run dev). Default HTTP checks in bun run verify use http://localhost:3000 (VERIFY_BASE_URL), so use bun run dev:donor (or point VERIFY_BASE_URL at the app you are running).

Per-app dev commands (from root package.json):

• bun run dev:donor → donor app, port 3000
• bun run dev:admin → admin app, port 3030