ventureos 1.1.16 → 1.1.17

package/CONTRIBUTING.md

@@ -0,0 +1,28 @@
+# Contributing to VentureOS
+
+Thanks for your interest in contributing.
+
+## What you can contribute
+
+- **Agent improvements** — better prompts, sharper frameworks, more accurate scoring
+- **New workflows** — additional phases or specialist agents
+- **Bug fixes** — broken paths, config issues, install failures
+- **Templates** — richer output templates for any phase
+
+## How to contribute
+
+1. Fork the repo
+2. Create a branch: `git checkout -b your-feature`
+3. Make your changes
+4. Open a pull request with a clear description of what you changed and why
+
+## Guidelines
+
+- Keep agent files focused — one agent, one job
+- Don't break existing workflows or file references
+- Test your changes with `npx ventureos` before submitting
+
+## Issues
+
+Found a bug or have a suggestion? Open an issue:
+[github.com/A-Boutaib/ventureos/issues](https://github.com/A-Boutaib/ventureos/issues)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Abderrahmane Boutaib
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,7 @@
 # VentureOS
 
 [![npm version](https://img.shields.io/npm/v/ventureos.svg)](https://www.npmjs.com/package/ventureos)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 **Your AI co-founder. From raw idea to validated venture — 12 weeks of structured ideation and incubation.**
 
@@ -39,10 +40,6 @@ npx ventureos
 
 That's it. VentureOS will detect what AI tools you have, ask you a few quick questions, and tell you exactly how to start.
 
-> **What's a terminal?**
-> On Mac: press `Cmd + Space`, type "Terminal", press Enter.
-> On Windows: press the Windows key, type "cmd", press Enter.
-
 ---
 
 ## What happens when you run it
@@ -181,20 +178,17 @@ If you pivot or decide to stop, VentureOS archives everything and documents the
 **Do I need to know how to code?**
 No. You type in plain English. VentureOS handles everything else.
 
-**What's an API key?**
-It's like a password that gives you access to an AI service (like ChatGPT or Claude). If you use Cursor, Windsurf, or Antigravity, you don't need one — they include AI access in their apps.
-
 **Does it save my work?**
 Yes. Every session is saved automatically. Start and stop whenever you like.
 
 **Can I use it for multiple ideas?**
 Yes. Run `npx ventureos config` to switch ventures or start a new one.
 
-**What if something goes wrong?**
-VentureOS never just crashes. If there's a problem (wrong key, no connection, etc.), it shows you your options and waits for you to decide what to do next.
 
 ---
 
 ## Need help?
 
 Open an issue on GitHub: [github.com/A-Boutaib/ventureos/issues](https://github.com/A-Boutaib/ventureos/issues)
+
+Want to contribute? See [CONTRIBUTING.md](CONTRIBUTING.md).

package/SETUP.md

@@ -64,6 +64,20 @@ To load a specialist:
 Load ventureOS/agents/domain-explorer.md and follow the activation instructions.
 ```
 
+### Antigravity
+
+Make sure your project folder is set as a trusted workspace in Antigravity (required for agents to read files).
+
+In the chat panel:
+```
+Load the file ventureOS/venture-master.md and follow the activation instructions.
+```
+
+To load a specialist directly:
+```
+Load ventureOS/agents/customer-discovery.md and follow the activation instructions.
+```
+
 ### Other AI Tools (ChatGPT, Gemini, etc.)
 
 1. Open `ventureOS/venture-master.md` in a text editor
@@ -81,13 +95,11 @@ When you load `venture-master.md`, Victor (the orchestrator) will:
 
 1. Read your `config.yaml`
 2. Load venture state from `_memory/venture-state.yaml`
-3. Greet you and display the venture status banner
-4. Show the phase-aware menu
-5. Wait for your input
+3. Greet you and wait for your input
 
-**If this is your first venture**, type `NV` (New Venture) and Victor will guide you through setup.
+**If this is your first venture**, Victor will ask: _"Would you like to start a new venture, or explore a domain first?"_ — just answer naturally.
 
-**If you have an existing venture**, Victor will pick up where you left off based on the saved state.
+**If you have an existing venture**, Victor will display the venture status and phase-aware menu, then pick up where you left off.
 
 ---
 
@@ -106,8 +118,10 @@ Victor's main menu:
 | `DS` | Define the Solution — wedge design, prototyping (Phase 4) |
 | `BC` | Build Business Case — risks, experiment plan, check-in pitch (Phase 5) |
 | `DB` | Design the Business — business model, GTM, final pitch (Phase 6) |
-| `NVB` | Board Feedback — on-demand synthetic venture board feedback |
+| `AP` | Autopilot — full synthetic venture run, Victor decides at every gate |
+| `NVB` | New Venture Board — formal gate evaluation (Week 8 / Week 12) |
 | `AG` | Agents — view all specialists and how to activate them |
+| `MH` | Show this menu again |
 | `CH` | Chat — free discussion with Victor |
 | `DA` | Dismiss Agent |
 
@@ -124,15 +138,16 @@ You can also load specialists directly at any time:
 | Specialist | File |
 |-----------|------|
 | Victor (Orchestrator) | `ventureOS/venture-master.md` |
-| Diana (Market Research) | `ventureOS/agents/domain-explorer.md` |
-| Clara (Customer Discovery) | `ventureOS/agents/customer-discovery.md` |
-| Paulo (Product Strategy) | `ventureOS/agents/product-strategist.md` |
-| Bernard (Business Model) | `ventureOS/agents/business-architect.md` |
-| Fiona (Financial Analysis) | `ventureOS/agents/financial-analyst.md` |
-| Eva (Venture Board) | `ventureOS/agents/venture-evaluator.md` |
-| Petra (Pitch Creation) | `ventureOS/agents/pitch-master.md` |
-| Grace (GTM & Growth) | `ventureOS/agents/growth-strategist.md` |
-| Olivia (Team & Ops) | `ventureOS/agents/venture-ops.md` |
+| Researcher (Market Research) | `ventureOS/agents/domain-explorer.md` |
+| Discovery (Customer Discovery) | `ventureOS/agents/customer-discovery.md` |
+| Product (Product Strategy) | `ventureOS/agents/product-strategist.md` |
+| Business (Business Model) | `ventureOS/agents/business-architect.md` |
+| Finance (Financial Analysis) | `ventureOS/agents/financial-analyst.md` |
+| NVB (New Venture Board) | `ventureOS/agents/venture-evaluator.md` |
+| Pitch (Pitch Creation) | `ventureOS/agents/pitch-master.md` |
+| Growth (GTM & Growth) | `ventureOS/agents/growth-strategist.md` |
+| Ops (Team & Operations) | `ventureOS/agents/venture-ops.md` |
+| Designer (Slide Decks) | `ventureOS/agents/slide-designer.md` |
 
 ---
 
@@ -175,9 +190,10 @@ _ventures/my-venture/
 
 ## Tips
 
-**Guided vs Yolo mode**
+**Guided vs Yolo vs Autopilot**
 - Guided: agent pauses at each step for your review. Best for real ventures.
 - Yolo: agent runs everything and presents all outputs at once. Best for rapid screening of multiple ideas.
+- Autopilot: Victor runs the full 12-week journey in one go — synthetic interviews, gate decisions, full venture-scan-report at the end. Best for quickly stress-testing an idea before committing.
 
 **Resuming a session**
 - VentureOS saves state to `ventureOS/_memory/venture-state.yaml` after each step.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ventureos",
-  "version": "1.1.16",
+  "version": "1.1.17",
   "description": "VentureOS — AI-powered venture building framework. From raw idea to validated venture — 12 weeks of structured ideation and incubation.",
   "type": "module",
   "bin": {
@@ -16,6 +16,8 @@
     "config.yaml",
     "README.md",
     "SETUP.md",
+    "LICENSE",
+    "CONTRIBUTING.md",
     "agents/",
     "workflows/",
     "templates/",