@shipfast-ai/shipfast 1.5.0 → 1.5.1

package/README.md

@@ -82,6 +82,33 @@ This skips ALL permission checks — use only in trusted environments.
 
 ## How It Works
 
+### 0. Discover (for new projects)
+
+```
+/sf-project Build a SaaS billing system
+```
+
+Before any planning, the LLM acts as a **senior technical discovery lead** — asking project-specific questions until it understands the full picture.
+
+**10-category coverage framework** (the LLM must understand all before proceeding):
+
+| Category | What it captures |
+|----------|-----------------|
+| Problem | What pain point does this solve? For whom? |
+| Users | Who uses it? Distinct roles/needs? |
+| Core Flow | Primary user journey, step by step |
+| Data | What's created, stored, queried? Relationships? |
+| Boundaries | What's v1? What's explicitly NOT v1? |
+| Tech | Stack decisions (or detected from existing code) |
+| Auth | Who can do what? Access control model? |
+| Integrations | External services, APIs, third-party deps? |
+| Constraints | Timeline, team, budget, compliance? |
+| Risks | What could go wrong? Hardest part? |
+
+Questions are **generated dynamically by the LLM** — not static templates. A SaaS project gets billing/multi-tenant questions. A CLI tool gets input/output questions. An API gets protocol/auth questions.
+
+**Anti-loop**: max 4 rounds (16 questions). 8/10 categories clear = stop. User can say "enough" anytime. Safe tech defaults assumed without asking (PostgreSQL, REST, JWT). All answers stored as locked decisions in brain.db.
+
 ### 1. Discuss (when needed)
 
 ```

package/bin/install.js

@@ -187,7 +187,7 @@ function installFor(key, runtime) {
 }
 
 function printDone(count) {
-  console.log(`\n${green}${bold}Installed for ${count} runtime${count > 1 ? 's' : ''}!${reset}\n`);
+  console.log(`\n${green}${bold}ShipFast v${pkg.version} installed for ${count} runtime${count > 1 ? 's' : ''}!${reset}\n`);
   console.log(`${bold}Next:${reset}`);
   console.log(`  ${cyan}cd your-project${reset}`);
   console.log(`  ${cyan}shipfast init${reset}        Index your codebase\n`);
@@ -801,7 +801,7 @@ function writeMcpConfig(dir) {
 function writeInstruction(filePath) {
   const marker = '<!-- ShipFast -->';
   const close = '<!-- /ShipFast -->';
-  const block = `${marker}\n## ShipFast\nThis repo uses ShipFast. Brain: .shipfast/brain.db\n\nFor any task: \`/sf-do <task>\` (recommended — full pipeline with fresh context per task).\nFor quick edits: check brain_decisions and brain_learnings MCP tools before changes.\n\nContext: ShipFast saves progress to brain.db automatically.\nIf context runs low, run \`/sf-resume\` in a new session — all state persists.\nRun \`/sf-help\` for all 20 commands.\n${close}`;
+  const block = `${marker}\n## ShipFast\nThis repo uses ShipFast. Brain: .shipfast/brain.db\n\nFor any task: \`/sf-do <task>\` (recommended — full pipeline with fresh context per task).\nFor new projects: \`/sf-project <description>\` — runs discovery first (10-category questioning until the project is fully understood).\nFor quick edits: check brain_decisions and brain_learnings MCP tools before changes.\n\nContext: ShipFast saves progress to brain.db automatically.\nIf context runs low, run \`/sf-resume\` in a new session — all state persists.\nRun \`/sf-help\` for all 20 commands.\n${close}`;
 
   let content = '';
   if (fs.existsSync(filePath)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipfast-ai/shipfast",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "Autonomous context-engineered development system with SQLite brain. 5 agents, 20 commands, per-task fresh context, 70-90% fewer tokens.",
   "bin": {
     "shipfast": "bin/install.js"