{"_id":"@denniswilmot/atlas-start","_rev":"4-586752fd543178e8bfc7c012438319c3","name":"@denniswilmot/atlas-start","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@denniswilmot/atlas-start","version":"0.1.0","keywords":["atlas","intellibus","agent","harness","cursor"],"license":"UNLICENSED","_id":"@denniswilmot/atlas-start@0.1.0","maintainers":[{"name":"denniswilmot-intellibus","email":"dennis.wilmot@intellibus.com"}],"homepage":"https://github.com/intellibus/atlas-start#readme","bugs":{"url":"https://github.com/intellibus/atlas-start/issues"},"bin":{"atlas-start":"bin/atlas-start.js"},"dist":{"shasum":"d44772f6e354e1c1afaa324c008cb333f6883b25","tarball":"https://registry.npmjs.org/@denniswilmot/atlas-start/-/atlas-start-0.1.0.tgz","fileCount":122,"integrity":"sha512-fuVv7KMqIQlBRzYiddp9P6UZG6x/7g0i9HtnbnKKlNOo9tr3iOyHdCHeE22/6ft2YQwnljFTM/zLJH/DUzfAjQ==","signatures":[{"sig":"MEUCIQDws5CgZ3J0fNdvjlPvWvqAa++l63mmsU3xUMOamzcKuwIgCGxld7GtKHOLGU3Kxd0+hkueHTi/JlfLDgpEE+Rof0g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2656556},"engines":{"node":">=20"},"gitHead":"6cc019205f5c7243b5090588aad4f09adeee19a5","scripts":{"next":"node scripts/atlas-cli.js next","test":"node --test tests/*.test.js","start":"node scripts/atlas-cli.js start","create":"node scripts/atlas-cli.js create","detect":"node scripts/atlas-cli.js detect","doctor":"node scripts/atlas-cli.js doctor","test:e2e":"node scripts/e2e-golden-path.js","sync-engine":"cp scripts/progress-engine.js scripts/persona-status.js skills/start-atlas-development/scripts/","scaffold-app":"node scripts/scaffold-app.js","test:fixtures":"node --test tests/progress-engine.test.js tests/fixtures-audit.test.js tests/database-profile.test.js tests/persona-status.test.js tests/install-profile.test.js tests/create-app.test.js tests/validate-app-brand.test.js","precommit-check":"npm run validate-workflow && npm run test","validate-workflow":"node scripts/validate-workflow.js","validate-brand-assets":"node scripts/validate-brand-assets.js","generate-failure-fixtures":"node scripts/generate-failure-fixtures.js"},"_npmUser":{"name":"denniswilmot-intellibus","email":"dennis.wilmot@intellibus.com"},"repository":{"url":"git+https://github.com/intellibus/atlas-start.git","type":"git"},"_npmVersion":"11.12.1","description":"Intellibus agent harness for Atlas web apps - CLI, skills, specs, audits","directories":{},"_nodeVersion":"26.0.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/atlas-start_0.1.0_1779992379206_0.7616965844357191","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@denniswilmot/atlas-start","version":"0.1.1","keywords":["atlas","intellibus","agent","harness","cursor"],"license":"UNLICENSED","_id":"@denniswilmot/atlas-start@0.1.1","maintainers":[{"name":"denniswilmot-intellibus","email":"dennis.wilmot@intellibus.com"}],"homepage":"https://github.com/intellibus/atlas-start#readme","bugs":{"url":"https://github.com/intellibus/atlas-start/issues"},"bin":{"atlas-start":"bin/atlas-start.js"},"dist":{"shasum":"68574ce10d29131da4340e68252ecec0474cfaf3","tarball":"https://registry.npmjs.org/@denniswilmot/atlas-start/-/atlas-start-0.1.1.tgz","fileCount":122,"integrity":"sha512-zbvXUQXdbbsZ1YiVs4FeGNhxdgB2aU+HXOpKWMNtsoHE4l1O1OAp9GtkxE+UjjinrfOnE1KkcoaQGbokDRlUOg==","signatures":[{"sig":"MEUCIQDM5FOEp7KIRzKzQ5WAdMsJ09phmS9MqcI6CQnpdf1wlgIgHbyzmRBlkEzpQ+65GbaHb3RSGLRTs8H3i7zr4IXc6hE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2656556},"engines":{"node":">=20"},"gitHead":"6cc019205f5c7243b5090588aad4f09adeee19a5","scripts":{"next":"node scripts/atlas-cli.js next","test":"node --test tests/*.test.js","start":"node scripts/atlas-cli.js start","create":"node scripts/atlas-cli.js create","detect":"node scripts/atlas-cli.js detect","doctor":"node scripts/atlas-cli.js doctor","test:e2e":"node scripts/e2e-golden-path.js","sync-engine":"cp scripts/progress-engine.js scripts/persona-status.js skills/start-atlas-development/scripts/","scaffold-app":"node scripts/scaffold-app.js","test:fixtures":"node --test tests/progress-engine.test.js tests/fixtures-audit.test.js tests/database-profile.test.js tests/persona-status.test.js tests/install-profile.test.js tests/create-app.test.js tests/validate-app-brand.test.js","precommit-check":"npm run validate-workflow && npm run test","validate-workflow":"node scripts/validate-workflow.js","validate-brand-assets":"node scripts/validate-brand-assets.js","generate-failure-fixtures":"node scripts/generate-failure-fixtures.js"},"_npmUser":{"name":"denniswilmot-intellibus","email":"dennis.wilmot@intellibus.com"},"repository":{"url":"git+https://github.com/intellibus/atlas-start.git","type":"git"},"_npmVersion":"11.12.1","description":"Intellibus agent harness for Atlas web apps - CLI, skills, specs, audits","directories":{},"_nodeVersion":"26.0.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/atlas-start_0.1.1_1779992467128_0.0878150675523075","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@denniswilmot/atlas-start","version":"0.1.2","keywords":["atlas","intellibus","agent","harness","cursor"],"license":"UNLICENSED","_id":"@denniswilmot/atlas-start@0.1.2","maintainers":[{"name":"denniswilmot-intellibus","email":"dennis.wilmot@intellibus.com"}],"homepage":"https://github.com/intellibus/atlas-start#readme","bugs":{"url":"https://github.com/intellibus/atlas-start/issues"},"bin":{"atlas-start":"bin/atlas-start.js"},"dist":{"shasum":"55d038ce58b119db966a3c343906d8ef74d4dcdd","tarball":"https://registry.npmjs.org/@denniswilmot/atlas-start/-/atlas-start-0.1.2.tgz","fileCount":122,"integrity":"sha512-9JfAWpV/InU9S4HuDu7XCawJ0dZs1S5vWhMRax7316Map3F1mqhxXoeG1KeoBLWNNztSfx4wUAZ85lvfgJTBdQ==","signatures":[{"sig":"MEUCIQCQBDjWHBcFgZtb0whAPkHpjqY54OMTF7Fnlhr4HXVulAIgfdisrymabDQ3Sd+ECAE4/SJzd4UvIFE40Lb3ju3KxvE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2656556},"engines":{"node":">=20"},"gitHead":"6cc019205f5c7243b5090588aad4f09adeee19a5","scripts":{"next":"node scripts/atlas-cli.js next","test":"node --test tests/*.test.js","start":"node scripts/atlas-cli.js start","create":"node scripts/atlas-cli.js create","detect":"node scripts/atlas-cli.js detect","doctor":"node scripts/atlas-cli.js doctor","test:e2e":"node scripts/e2e-golden-path.js","sync-engine":"cp scripts/progress-engine.js scripts/persona-status.js skills/start-atlas-development/scripts/","scaffold-app":"node scripts/scaffold-app.js","test:fixtures":"node --test tests/progress-engine.test.js tests/fixtures-audit.test.js tests/database-profile.test.js tests/persona-status.test.js tests/install-profile.test.js tests/create-app.test.js tests/validate-app-brand.test.js","precommit-check":"npm run validate-workflow && npm run test","validate-workflow":"node scripts/validate-workflow.js","validate-brand-assets":"node scripts/validate-brand-assets.js","generate-failure-fixtures":"node scripts/generate-failure-fixtures.js"},"_npmUser":{"name":"denniswilmot-intellibus","email":"dennis.wilmot@intellibus.com"},"repository":{"url":"git+https://github.com/intellibus/atlas-start.git","type":"git"},"_npmVersion":"11.12.1","description":"Intellibus agent harness for Atlas web apps - CLI, skills, specs, audits","directories":{},"_nodeVersion":"26.0.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/atlas-start_0.1.2_1779992631390_0.892922282635817","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@denniswilmot/atlas-start","version":"0.1.3","description":"Intellibus agent harness for Atlas web apps - CLI, skills, specs, audits","repository":{"type":"git","url":"git+https://github.com/intellibus/atlas-start.git"},"homepage":"https://github.com/intellibus/atlas-start#readme","bugs":{"url":"https://github.com/intellibus/atlas-start/issues"},"bin":{"atlas-start":"bin/atlas-start.js"},"engines":{"node":">=20"},"keywords":["atlas","intellibus","agent","harness","cursor"],"license":"UNLICENSED","publishConfig":{"access":"public"},"scripts":{"start":"node scripts/atlas-cli.js start","create":"node scripts/atlas-cli.js create","detect":"node scripts/atlas-cli.js detect","next":"node scripts/atlas-cli.js next","doctor":"node scripts/atlas-cli.js doctor","validate-workflow":"node scripts/validate-workflow.js","test":"node --test tests/*.test.js","test:fixtures":"node --test tests/progress-engine.test.js tests/fixtures-audit.test.js tests/database-profile.test.js tests/persona-status.test.js tests/install-profile.test.js tests/create-app.test.js tests/validate-app-brand.test.js","test:e2e":"node scripts/e2e-golden-path.js","scaffold-app":"node scripts/scaffold-app.js","generate-failure-fixtures":"node scripts/generate-failure-fixtures.js","validate-brand-assets":"node scripts/validate-brand-assets.js","sync-engine":"cp scripts/progress-engine.js scripts/persona-status.js skills/start-atlas-development/scripts/","precommit-check":"npm run validate-workflow && npm run test"},"gitHead":"46a5754507fa98f284624de6156c13e473872c6d","_id":"@denniswilmot/atlas-start@0.1.3","_nodeVersion":"26.0.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-2bUzHtl8uYZKVc4ZIq2s1INyjIDj1Olyw5n+N4jy3d4oXO5fOxcrm0kzOFsQWUhaFPCu79UOi0Nm9j+cCbYfIQ==","shasum":"6d22f9cd7ed91b8e5fc2c251d2909f23545b8aa7","tarball":"https://registry.npmjs.org/@denniswilmot/atlas-start/-/atlas-start-0.1.3.tgz","fileCount":122,"unpackedSize":2670379,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDQMYypjjhAdL/d8qVqSVwr8PCqiPM2803PByYHKjd/JAiEAqMc1FJH/GFj7wEfOX9MI8OUP+F27ekU/2RoV6XzEZok="}]},"_npmUser":{"name":"denniswilmot-intellibus","email":"dennis.wilmot@intellibus.com"},"directories":{},"maintainers":[{"name":"denniswilmot-intellibus","email":"dennis.wilmot@intellibus.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/atlas-start_0.1.3_1780024693721_0.7152033524404438"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-28T18:19:39.104Z","modified":"2026-05-29T03:18:14.139Z","0.1.0":"2026-05-28T18:19:39.426Z","0.1.1":"2026-05-28T18:21:07.305Z","0.1.2":"2026-05-28T18:23:51.643Z","0.1.3":"2026-05-29T03:18:14.008Z"},"bugs":{"url":"https://github.com/intellibus/atlas-start/issues"},"license":"UNLICENSED","homepage":"https://github.com/intellibus/atlas-start#readme","keywords":["atlas","intellibus","agent","harness","cursor"],"repository":{"type":"git","url":"git+https://github.com/intellibus/atlas-start.git"},"description":"Intellibus agent harness for Atlas web apps - CLI, skills, specs, audits","maintainers":[{"name":"denniswilmot-intellibus","email":"dennis.wilmot@intellibus.com"}],"readme":"# Intellibus Atlas Start\n\n**Intellibus's agentic development workflow** — take a product idea from first notes to a **deployed web application**, with agents and engineers working from the same playbook. It ships canonical **brand assets** — Intellibus logos, WDG logos, theme presets, and related marks — so new apps scaffold on-brand instead of recreating marks from memory. Each scaffold also includes a pre-wired **Atlas chatbot UI**: `AtlasChat` panel, typed block renderer, `/api/atlas/chat` agentic tool loop, and starter tools — all aligned with [harness principles](docs/onboarding/harness-principles.md) — so you extend domain behavior instead of building chat infrastructure from scratch.\n\nAtlas Start gives you a closed loop: specify, build, verify, and ship. Every repo has a knowable state, every state has a valid next move, and every phase has a gate — so teams move fast **without** drifting from [our principles](docs/onboarding/harness-principles.md) (Better Auth, Drizzle, Atlas harness, URA, audits, pre-launch).\n\n| | |\n|---|---|\n| **What it is** | Workflow + CLI + skills + templates for agent-assisted app delivery |\n| **Where it goes** | Idea → decisions → PRD & issues → scaffold → auth & Atlas → build → audit → deploy |\n| **Why it works** | Stateful progress tracking, human gates where it matters, freedom during long UI build, [efficient agent sessions](docs/onboarding/agent-efficiency.md) (context budget, model tiers, prompt cache) |\n\n**Repository:** [github.com/intellibus/atlas-start](https://github.com/intellibus/atlas-start)  \n**npm:** [@denniswilmot/atlas-start](https://www.npmjs.com/package/@denniswilmot/atlas-start)\n\n### Install\n\n```bash\nnpm i @denniswilmot/atlas-start\n```\n\nGlobal CLI (optional):\n\n```bash\nnpm i -g @denniswilmot/atlas-start\natlas-start create example-app -t starter -p intellibus\n```\n\nNo install required — `npx` runs the latest version:\n\n```bash\nnpx @denniswilmot/atlas-start create example-app -t starter -p intellibus\n```\n\n---\n\n## Golden path (engineers + agents)\n\n**One numbered flow** — idea to production. Engineers run shell steps; agents take over at step 3 in the **app folder** (not atlas-start).\n\n```bash\n# 0. You have an idea — pick a folder name: example-app\n\n# 1. Create (from Desktop, ~/projects, anywhere — NOT inside atlas-start)\nnpx @denniswilmot/atlas-start create example-app -t starter -p intellibus\n\n# 2. Env + run\ncd example-app\ncp .env.example .env.local\n# Set OPENROUTER_API_KEY, BETTER_AUTH_SECRET, DATABASE_URL\nnpm run dev\n\n# 3. Cursor → open example-app folder → chat:\n#    \"Start atlas build\"\n\n# 4–5. Agent drives spec + build; you approve gates and review work\n\n# 6. Before prod\nnode scripts/harness-audit.js --format text\nnode scripts/audit-prelaunch.js --format text\n\n# 7. Push app repo + CI (example-app/.github/workflows/atlas-audit.yml)\n#    uses: intellibus/atlas-start/.github/workflows/atlas-app-audit.yml@main\n\n# 8. Deploy on Vercel — same env vars as .env.local + BETTER_AUTH_URL=prod URL\n```\n\n| Step | Who | What |\n|------|-----|------|\n| **0** | Engineer | Idea + anti-goals; pick kebab-case folder name |\n| **1** | Engineer | `npx @denniswilmot/atlas-start create <name> -t starter -p intellibus` |\n| **2** | Engineer | `.env.local` + `npm run dev` |\n| **3** | Engineer opens app in Cursor; **Agent** | User says **Start atlas build** |\n| **4–5** | Engineer approves gates; **Agent** | brief → grill → PRD → issues → build |\n| **6** | Either | `harness-audit` + `audit-prelaunch` (or **Run pre-launch checklist**) |\n| **7** | Engineer | Push app repo; reusable [app CI](docs/onboarding/app-ci.md) |\n| **8** | Engineer | Deploy; prod env + migrations |\n\n**Agents:** Do not scaffold from atlas-start. Work in the engineer's app repo after step 3. Full detail: [idea-to-deploy.md](docs/onboarding/idea-to-deploy.md) · [start-atlas-development skill](skills/start-atlas-development/SKILL.md).\n\n**Harness contributors only:** `git clone git@github.com:intellibus/atlas-start.git` — [engineering guide](docs/onboarding/engineering-guide.md).\n\n### Step 2 — env vars\n\n```bash\nOPENROUTER_API_KEY=sk-or-v1-...      # https://openrouter.ai/keys\nBETTER_AUTH_SECRET=...               # openssl rand -base64 32\nDATABASE_URL=postgresql://...        # Supabase pooled Postgres URL\n```\n\n**Brownfield / existing app:** skip step 1 — `npx @denniswilmot/atlas-start start` in the app repo, then **Start atlas build**. Interactive create: `npx @denniswilmot/atlas-start create`.\n\n> **npm:** [@denniswilmot/atlas-start](https://www.npmjs.com/package/@denniswilmot/atlas-start) — `npm i @denniswilmot/atlas-start` or `npx @denniswilmot/atlas-start create`. Do not use bare `npx @denniswilmot/atlas-start create`.\n\n| Template | Flag |\n|----------|------|\n| Starter (default) | `-t starter` |\n| Minimal | `-t minimal` |\n\n---\n\n## Onboarding\n\nAll how-to guides live in **[`docs/onboarding/`](docs/onboarding/)**. Pick by role:\n\n| Guide | Who | What you get |\n|-------|-----|--------------|\n| **[Idea → deploy](docs/onboarding/idea-to-deploy.md)** | **All engineers** | **End-to-end path — name app, create, dev, CI, deploy** |\n| [Atlas build — simple](docs/onboarding/atlas-build-simple.md) | Engineer + agent | Minimal bootstrap → `Start atlas build` |\n| [Create app](docs/onboarding/create-app.md) | Engineer | `npx @denniswilmot/atlas-start create` — project name + template prompts |\n| [Harness principles](docs/onboarding/harness-principles.md) | Everyone | Gates vs freedom — state always front-of-mind |\n| [Agent efficiency](docs/onboarding/agent-efficiency.md) | Agent + engineer | Context budget, model tiers, prompt caching, batched gates |\n| [Command reference](docs/onboarding/command-reference.md) | Everyone | Every CLI command, phase, skill, artifact |\n| [Workflow manifest](docs/onboarding/workflow.md) | Agent + engineer | Flight plan vs flight log, human gates, progress v3 |\n| [Full phase guide](docs/onboarding/start-atlas-development.md) | Agent | Complete lifecycle walkthrough |\n| [Atlas Dev Prep](docs/onboarding/atlas-dev-prep.md) | Agent | grill-me → to-prd → to-issues |\n| [Engineering guide](docs/onboarding/engineering-guide.md) | Harness engineers | `npm run validate-workflow`, tests, inspect progress |\n| [Database setup](docs/onboarding/database-setup.md) | Engineer | Supabase Postgres — team default, no local Postgres install |\n| [Starter template](docs/onboarding/starter-template.md) | Engineer | Next.js starter profile, `npm install`, persona guardrails |\n| [Pre-launch checklist](docs/onboarding/pre-launch-checklist.md) | Agent + engineer | GTM + security gate before deploy |\n| [Client project model](docs/design/client-project-model.md) | Product + engineer | Brand packs, profiles, data isolation (partial) |\n| [Backlog / audit status](docs/OUTSTANDING.md) | Team | What's done vs audit gaps |\n| [Impeccable](docs/onboarding/impeccable.md) | Agent | Optional UI polish after URA structure |\n| [Atlas Dev Prep (vendor)](docs/onboarding/matt-pocock-skills.md) | Engineer | Upstream prep skills install details |\n\nDocs hub (specs + onboarding index): [`docs/README.md`](docs/README.md)\n\n---\n\n## What `npx @denniswilmot/atlas-start create` does\n\nInteractive, create-react-app style. One command from any directory:\n\n| Step | What happens |\n|------|----------------|\n| **Prompt** | Project name, Starter vs Minimal template, client brand |\n| **Scaffold** | Next.js 14 + Drizzle + Better Auth + Atlas templates + logos |\n| **Install** | `npm install` (Next, React, stack deps) |\n| **Bootstrap** | `atlas start` — skills, progress, audit scripts |\n\nThen `cd your-app`, copy `.env.example` → `.env.local`, set **OPENROUTER_API_KEY** + **DATABASE_URL** + **BETTER_AUTH_SECRET**, `npm run dev`, and **Start atlas build** in Cursor.\n\n---\n\n## What `npx @denniswilmot/atlas-start start` does (existing apps)\n\n| Step | What happens | Why |\n|------|----------------|-----|\n| **Detect** | Reads repo signals — idea in docs? `package.json`? auth wired? progress file? | Picks your **entry path** (see below) so you don't restart work already done |\n| **Install harness skills** | Copies skills → `.cursor/skills/` | Agent has phase instructions in-repo, not improvised |\n| **Install Atlas Dev Prep** | Adds `grill-me`, `to-prd`, `to-issues`, etc. if missing | Spec phase tooling — no manual setup |\n| **Init progress** | Creates `.atlas-dev/progress.json` + copies `workflow.json` | Harness **remembers** phase across conversations |\n| **Copy scripts** | `harness-audit.js`, `progress-engine.js`, … → `scripts/` | Deterministic gates agents, engineers, and CI can run |\n\nInspect routing without installing:\n\n```bash\nnpx @denniswilmot/atlas-start detect\n```\n\n---\n\n## What the agent does (and why it persists)\n\n`Start atlas build` invokes the **master workflow** ([`start-atlas-development`](skills/start-atlas-development/SKILL.md)). The agent:\n\n1. Runs **`progress.sh next`** — reads [`config/workflow.json`](config/workflow.json) + `.atlas-dev/progress.json`\n2. Obeys the `action` field — run skill, or **stop and ask the user** when `await_user`\n3. Updates progress after each step — so `Resume atlas build` picks up exactly where you left off\n\n### Flight plan vs flight log\n\n| File | Role |\n|------|------|\n| **`config/workflow.json`** | Flight plan — phases, skills, gates, user prompts |\n| **`.atlas-dev/progress.json`** | Flight log — status, artifacts, `awaitingUser` |\n\nSee [Workflow guide](docs/onboarding/workflow.md) · **[Harness principles](docs/onboarding/harness-principles.md)** (gates vs freedom, long-running build).  \nInspect state: `npx @denniswilmot/atlas-start status` or `progress.sh session`.\n\nThat continuity is core product behavior. The workflow is **stateful across sessions** — pick up idea-to-deploy work exactly where you left off, not from a blank prompt.\n\n---\n\n## How the harness routes your repo\n\nWhen `atlas start` (or detect) runs, it asks two questions:\n\n1. **Is there product knowledge?** — Do we know *what* we're building? (README, any docs, brief — not one fixed path.)\n2. **Is there implementation?** — Does runnable app code exist? (`package.json`, src tree.)\n\nThose axes define your **entry path**. If `.atlas-dev/progress.json` exists, **resume** always wins.\n\n| Path | Product knowledge | Code exists | What happens next |\n|------|-------------------|-------------|-------------------|\n| **Greenfield** | No | No | Capture idea → Atlas Dev Prep → scaffold |\n| **Idea-only** | Yes | No | Prep first (grill → PRD → issues), *then* scaffold |\n| **Brownfield** | Yes | Yes | Merge intent + code; skip satisfied phases (auth, atlas, …) |\n| **Brownfield (no idea)** | No | Yes | Extract intent from code + conversation, then continue |\n| **Resume** | Any | Any | Continue at `currentPhase` in progress.json |\n\n**Greenfield** ≠ empty folder. It means *no articulated product intent in the repo yet*.\n\n**Brownfield** ≠ legacy mess. It means *code and intent coexist* — the harness merges them.\n\n**Idea-only** blocks premature scaffold: decisions and GitHub slices exist before `package.json`.\n\n### Signals (what detect looks for)\n\nSignals refine *where* you start and *what* gets skipped:\n\n| Signal | Meaning | Often skips |\n|--------|---------|-------------|\n| `idea_in_repo` | Product context found anywhere | — |\n| `scaffolded` | App exists | `scaffold` |\n| `better_auth` | Auth wired | `auth` |\n| `atlas` | Harness core present | `atlas` only when persona is personalized |\n| `atlas_persona_pending` | Atlas UI wired, placeholder `prompt.ts` | **does not** skip atlas — agent prompts user |\n| `atlas_persona_complete` | Persona customized from brief | allows skipping atlas phase |\n| `ura_plan` | `docs/ura-plan.md` | `ura_plan` |\n| `github_issues` | Open slices | jump toward `build` |\n| `progress` | Progress file exists | → **resume** |\n\nScattered notes? Agent runs **`reorganize-repo`** → canonical `docs/brief.md`. The brief is harness *output*, not a required input path.\n\n---\n\n## The lifecycle (what you're building toward)\n\nThree layers stack on every app:\n\n```mermaid\nflowchart LR\n  subgraph spec [Specification]\n    S1[Idea] --> S2[Decisions]\n    S2 --> S3[PRD + issues]\n  end\n  subgraph impl [Implementation]\n    I1[Scaffold] --> I2[Auth + Atlas + URA]\n    I2 --> I3[Build slices]\n  end\n  subgraph assure [Assurance]\n    A1[React Doctor] --> A2[Verify + audit]\n    A2 --> A3[Pre-launch]\n  end\n  spec --> impl --> assure\n```\n\nFull phase order (skipped automatically when done):\n\n```\nsetup → ideation → grill → PRD → issues → scaffold → auth → atlas → ura_plan → build → react_doctor → verify → audit → prelaunch → done\n```\n\n| Stage | Phases | Output |\n|-------|--------|--------|\n| **Atlas Dev Prep** | setup, ideation, grill, PRD, issues | Resolved plan + GitHub slices |\n| **Foundation** | scaffold, auth, atlas, ura_plan | Runnable app with company standards |\n| **Delivery** | build | Issues closed one vertical slice at a time |\n| **Assurance** | react_doctor, verify, audit, prelaunch | Merge-ready, launch-ready |\n\n### Atlas Dev Prep (spec phase)\n\nInstalled by `atlas start`. Produces: decision tree resolved → PRD issue → vertical-slice issues.\n\n| Skill | Role |\n|-------|------|\n| `grill-me` | Resolve every open product/architecture branch |\n| `to-prd` | Conversation → PRD (no re-interview) |\n| `to-issues` | PRD → AFK-ready slices |\n| `grill-me-ura` | Optional — URA / Atlas pressure after prep grill |\n\n[Atlas Dev Prep guide →](docs/onboarding/atlas-dev-prep.md)\n\n### Build & assurance (after prep)\n\n| Phase | Skill |\n|-------|-------|\n| Reorganize intent | `reorganize-repo` |\n| Scaffold | `npx @denniswilmot/atlas-start create` (engineer) or `new-app` skill (in-workflow) |\n| Auth | `better-auth-setup` — pre-wired on Starter template |\n| Atlas | `atlas-chat-ui`, `add-atlas-tool` — persona tracked in `outstandingTasks` until `prompt.ts` is customized |\n| Host UI | `ura-ui` |\n| React health | `react-doctor` |\n| Verify | `verification-loop` |\n| Company audit | `harness-audit` |\n| Go-live | `pre-launch-checklist` |\n\nTemplates agents copy: [`templates/atlas/`](templates/atlas/README.md) · [`templates/auth/`](templates/auth/) · [`templates/db/`](templates/db/README.md) · [`templates/starter/`](docs/onboarding/starter-template.md)\n\n### Install profiles\n\n| Profile | Default for | What you get |\n|---------|-------------|--------------|\n| **`starter`** | Intellibus / WDG client profiles | Next.js shell, Atlas FAB mounted, setup-aware dev home, login form, `npm install`, persona outstanding task |\n| **`minimal`** | CI / E2E | Templates copied, no Atlas on layout — full phases run later |\n\nConfig: [`config/install-profiles.json`](config/install-profiles.json) · [`config/client-profiles.json`](config/client-profiles.json)\n\n---\n\n## What every app must satisfy\n\n| Standard | Contract |\n|----------|----------|\n| **Better Auth** | No bespoke auth |\n| **Drizzle ORM** | All persistence — Supabase Postgres ([templates/db](templates/db/README.md)) |\n| **Atlas** | Tool loop, typed blocks, route context — [spec](docs/architecture/atlas-harness.md) |\n| **URA** | Context-first UI, data-shape views, caching — [rules](docs/design/ura-design-rules.md) |\n| **React Doctor** | Score ≥ 75 |\n| **Impeccable** | UI polish after URA structure — [guide](docs/onboarding/impeccable.md) |\n| **Pre-launch** | GTM + security gate |\n\n---\n\n## Brand assets (logos)\n\nThis repo ships **canonical brand marks** agents and apps copy from — not recreated from memory.\n\n```\nassets/logos/\n├── intellibus/          # Block logo, hackathon variant (PNG)\n└── wdg/                 # WDG marks + hi-res variants (SVG, PNG, AI)\n```\n\n| Brand | Use in apps |\n|-------|-------------|\n| **Intellibus** | App chrome, login, Atlas chat header, marketing |\n| **WDG** | WDG-branded products, whitepapers, events |\n\n**At scaffold:** `npx @denniswilmot/atlas-start create` copies logos to `public/logos/` in the new app.  \n**Catalog:** [assets/logos/README.md](assets/logos/README.md)  \n**Agent guide:** [docs/design/brand-assets.md](docs/design/brand-assets.md)\n\nDo not hotlink harness repo paths in production — copy files into each app's `public/` or `src/assets/`.\n\n---\n\n## Command reference\n\nEvery command, phase, skill, and artifact in one place:\n\n**[docs/onboarding/command-reference.md](docs/onboarding/command-reference.md)**\n\nQuick subset:\n\n| Intent | Say or run |\n|--------|------------|\n| **New app** | `npx @denniswilmot/atlas-start create` |\n| Bootstrap existing repo | `npx @denniswilmot/atlas-start start` |\n| Run / continue workflow | `Start atlas build` / `Resume atlas build` |\n| Inspect routing | `npx @denniswilmot/atlas-start detect` |\n| Inspect next workflow step | `npx @denniswilmot/atlas-start next` |\n| Validate harness manifest | `npm run validate-workflow` (harness repo) |\n\nSee the command reference for the full phase → skill map, pre-launch sub-skills, and detect paths.\n\n---\n\n## Working on this harness (engineers)\n\nFull guide: **[docs/onboarding/engineering-guide.md](docs/onboarding/engineering-guide.md)**\n\n| Task | Command |\n|------|---------|\n| Validate workflow ↔ skills ↔ progress | `npm run validate-workflow` |\n| Run progress-engine tests | `npm test` |\n| Validate + show next action | `npm run doctor` |\n| Simulate repo routing | `npm run detect` |\n| Pre-PR check | `npm run precommit-check` |\n\n---\n\n## Audits (from app repo)\n\n```bash\nnode scripts/harness-audit.js --format text      # company standards\nnode scripts/audit-prelaunch.js --format text    # GTM + security\nnode scripts/validate-app-brand.js               # required logo files in public/logos/\n```\n\n**CI:** App repos call the reusable workflow — no copied audit YAML. See **[docs/onboarding/app-ci.md](docs/onboarding/app-ci.md)**.\n\n```yaml\njobs:\n  atlas-audit:\n    uses: intellibus/atlas-start/.github/workflows/atlas-app-audit.yml@main\n    permissions:\n      contents: read\n```\n\n---\n\n## Canonical specs\n\n| Document | Role |\n|----------|------|\n| [Atlas harness](docs/architecture/atlas-harness.md) | Agentic chat architecture |\n| [URA design rules](docs/design/ura-design-rules.md) | UI laws |\n| [Architecture index](docs/architecture/INDEX.md) | Spec catalog |\n\nDocs hub: [`docs/README.md`](docs/README.md)\n\n---\n\n## This repository\n\n```\natlas-start/\n├── README.md           ← start here\n├── package.json        ← `npx @denniswilmot/atlas-start` CLI\n├── config/             ← workflow, client profiles, install profiles, database profiles, agent-efficiency\n├── skills/             ← phase skills (copied to app by atlas start)\n├── scripts/            ← atlas-cli, create-app, scaffold-app, progress-engine, audits\n├── tests/              ← progress-engine, fixtures, persona, install-profile\n├── docs/               ← specs + onboarding\n├── templates/          ← atlas, auth, db, starter (Next.js layout + dev home)\n└── assets/logos/       ← intellibus/ + wdg/ brand marks (copy into apps)\n```\n\nPer-app artifacts: `.atlas-dev/progress.json` (includes `outstandingTasks`), `docs/brief.md`, `docs/ura-plan.md`, `src/lib/atlas/*`, GitHub issues.\n\n---\n\n## Further reading\n\nOnboarding index: **[`docs/onboarding/`](docs/onboarding/)** · [Onboarding section above](#onboarding)\n\n- [Create app](docs/onboarding/create-app.md) — `npx @denniswilmot/atlas-start create` interactive guide\n- [Engineering guide](docs/onboarding/engineering-guide.md) — inspect, validate, develop this repo\n- [Workflow manifest](docs/onboarding/workflow.md) — flight plan, human gates, progress v3\n- [Command reference](docs/onboarding/command-reference.md) — all commands, phases, skills\n- [Starter template](docs/onboarding/starter-template.md) — Next.js starter, npm install, persona guardrails\n- [Database setup](docs/onboarding/database-setup.md) — Supabase Postgres\n- [Full phase guide](docs/onboarding/start-atlas-development.md)\n- [Atlas Dev Prep](docs/onboarding/atlas-dev-prep.md)\n- [Pre-launch checklist](docs/onboarding/pre-launch-checklist.md)\n- [Backlog](docs/OUTSTANDING.md)\n","readmeFilename":"README.md"}