@oaklandzoo/ostup 0.1.0 → 0.1.1

package/README.md

@@ -54,32 +54,35 @@ through creating them when you reach that step.
 
 ## Install
 
-Two paths. Pick the one that matches how you got ostup.
-
-### Path A: from npm (after `ostup` is published)
+The fastest path:
 
 ```
-npx ostup init
+npx @oaklandzoo/ostup init
 ```
 
-That is the whole install. `npx` downloads ostup on first run.
+That is the whole install. `npx` downloads ostup on first run, nothing
+to install permanently.
+
+If you'd rather install it globally so the command is just `ostup`:
 
-As of right now, `ostup` is not yet published to npm. Use Path B below.
+```
+npm install -g @oaklandzoo/ostup
+ostup --version    # should print 0.1.0
+ostup init
+```
 
-### Path B: from source (today's path)
+### Alternate: install from source
 
-If you cloned or downloaded https://github.com/DubsFan/goodshin:
+If you cloned https://github.com/DubsFan/goodshin and want to run from
+your local checkout:
 
 ```
 cd /path/to/goodshin/ostup
-npm install     # downloads ostup's own dependencies
-npm link        # adds `ostup` to your PATH globally
-ostup --version # should print 0.1.0
+npm install
+npm link
+ostup --version
 ```
 
-After `npm link` you can run `ostup` from any folder. You only do this
-once per machine.
-
 ## Use
 
 In Terminal, navigate to the parent folder where you want the new

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oaklandzoo/ostup",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Scaffolds a new repo with the Ostup Agent Kit pre-installed: slash commands, doc templates, and a clean working state.",
   "type": "module",
   "bin": {

package/src/mvp-flow.mjs

@@ -57,14 +57,14 @@ export async function runMvp({ flags = {}, cwd = process.cwd() } = {}) {
   await ensureFreshTarget(targetDir, flags.force);
   await mkdir(targetDir, { recursive: true });
 
+  await maybeScaffoldStack({ stack: answers.stack, projectName: answers.projectName, targetDir });
+
   await ingestMaterials({
     targetDir,
     ingestPath: answers.ingestPath,
     isDryRun: isDryRun(),
   });
 
-  await maybeScaffoldStack({ stack: answers.stack, projectName: answers.projectName, targetDir });
-
   const tokens = buildTokenMap({
     projectName: answers.projectName,
     displayName: answers.displayName,

package/src/summary.mjs

@@ -22,7 +22,10 @@ export function renderSummary({ targetDir, repoUrl, deployUrl, profile, projectN
   lines.push(
     `  Profile:     ${profile || 'goodshin'}`,
     '================================================',
-    `  Next: cd ${projectName} && claude`,
+    `  Next steps:`,
+    `    1. cd ${projectName}`,
+    `    2. claude    (or codex, gemini, your preferred CLI agent)`,
+    `    3. Open START_HERE.md and paste the prompt as your first message`,
     '================================================',
     ''
   );

package/src/templates.mjs

@@ -23,6 +23,7 @@ export const REGISTRY = [
   { src: '.claude/commands/generate-tasks.md', dest: '.claude/commands/generate-tasks.md' },
   { src: 'CLAUDE.md',                          dest: 'CLAUDE.md' },
   { src: 'AGENTS.md',                          dest: 'AGENTS.md' },
+  { src: 'START_HERE.md',                      dest: 'START_HERE.md' },
   { src: 'HANDOFF.md',                         dest: 'HANDOFF.md' },
   { src: 'docs/PROJECT_STATE.md',              dest: 'docs/PROJECT_STATE.md' },
   { src: 'docs/MANUAL_TASKS.md',               dest: 'docs/MANUAL_TASKS.md' },

package/templates/START_HERE.md

@@ -0,0 +1,41 @@
+# Start here
+
+You just scaffolded **{{DISPLAY_NAME}}** with ostup. This file tells you exactly what to do next.
+
+## Step 1: open this folder in your CLI agent
+
+In Terminal, from inside this folder:
+
+```
+claude
+```
+
+(Or `codex`, `gemini`, or whichever CLI agent you use.)
+
+## Step 2: paste this as your first message
+
+Copy the entire block between the lines and paste it as your first message to the agent:
+
+---
+
+Read everything in `{{INPUTS_PATH}}` thoroughly. The operator dropped source materials there: research, reference repos, brand assets, notes. Also read `CLAUDE.md` and `AGENTS.md` for project rules.
+
+Then, based on what is in `{{INPUTS_PATH}}`, ask the operator up to 3 clarifying questions about what to build. After the operator answers, propose a 30 to 60 minute MVP scope as a numbered list. Do not write code until the operator approves the scope.
+
+If `{{INPUTS_PATH}}` is empty or has only a README, ask the operator what they want to build instead.
+
+---
+
+## What happens after that
+
+1. The agent reads your project rules + your source material.
+2. The agent asks you a few questions.
+3. You answer.
+4. The agent proposes a scope.
+5. You approve (or push back).
+6. The agent builds the MVP and pushes commits to your GitHub repo.
+7. Vercel auto-deploys each push, so your live URL updates as the agent works.
+
+## When you no longer need this file
+
+Delete it. It is for first-session orientation only and does not affect your app.