docs: update README, TASKS, and CHANGELOG for unified installer

Author: apiad

CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.11.0] - 2026-03-11
+
+### Added
+- Unified `install.sh` script that handles both initial project bootstrapping and non-destructive framework updates/integrations in existing repositories.
+- Automatic git environment validation (clean tree requirement) and post-install commits to `install.sh`.
+- Interactive summary and confirmation of proposed changes (created vs. updated files) in the installer.
+
+### Removed
+- `add-gemini.sh` script (its logic is now integrated into the unified `install.sh`).
+
+### Changed
+- Streamlined `README.md` with a single, unified "Quick Start" command for all use cases.
+
 ## [0.10.1] - 2026-03-03
 
 ### Changed

README.md

@@ -19,42 +19,28 @@
 
 ## 🔥 Quick Start
 
-The fastest way to bootstrap a new project from this template is to run the following command in your terminal:
+The fastest way to bootstrap a new project or integrate the framework into an existing one is to run the following command in your terminal:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/apiad/starter/main/install.sh | bash
 ```
 
 This interactive script will:
-1.  **Prompt** for your project name and target directory.
-2.  **Clone** the template and **reset** the Git history.
-3.  **Clean** out placeholder content (`README.md`, `CHANGELOG.md`, `journal/`, etc.).
-4.  **Initialize** a fresh project structure, ready for the Gemini CLI.
-5.  **Launch** the Gemini CLI to start your first session.
+1.  **Validate** your environment (requires `git`, `node`, and a clean working tree).
+2.  **Clone** the latest framework components to a temporary location.
+3.  **Analyze** your current directory and propose a list of files to create or update.
+4.  **Prompt** for your explicit confirmation before applying any changes.
+5.  **Integrate** the `.gemini/` configuration and framework files (non-destructively).
+6.  **Commit** the changes automatically with a descriptive message.
 
-Once Gemini CLI is open, run `/scaffold` to begin, or `/onboard` to get an overview of the repository.
+Once the installation is complete, run `gemini /onboard` to get an overview of the repository and start your first session.
 
-### 📥 Integration (Existing Projects)
-
-To add this framework to an existing Git repository, run:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/apiad/starter/main/add-gemini.sh | bash
-```
-
-This script will:
-1.  **Check** for a clean working tree.
-2.  **Prompt** for permission before overwriting any existing core files.
-3.  **Extract** the `.gemini/` configuration and framework files.
-4.  **Create** a first integration commit.
-
-### 🏗️ Alternative Installation
+### 🏗️ Alternative: Manual Setup
 
 If you prefer a manual setup:
 
-1. Clone the repo or [create a new project directly](https://github.com/apiad/starter/generate).
-2. Delete `README.md`, `CHANGELOG.md`, and `journal/*.md` to get a fresh history.
-3. Run `gemini /scaffold` to start a new project.
+1. [Create a new project from this template](https://github.com/apiad/starter/generate).
+2. Follow the onboarding instructions in the generated repository.
 
 ---
 

TASKS.md

@@ -19,6 +19,7 @@ Put done tasks into the Archive.
 ---
 
  ## Archive
+- [x] Consolidate `add-gemini.sh` into a unified, non-destructive `install.sh` for setup and updates. (2026-03-11) (See plan: plans/unified-installer.md)
 - [x] Implement the `install.sh` scaffolding script for new projects. (2026-03-03) (See plan: plans/install-script-scaffolding.md)
 - [x] Refactor the `/research` command to follow a more extensible, executive-style reporting workflow with iterative updates and asset linking. (2026-03-02)
 - [x] Implement drafting (`/draft`) and editing (`/revise`) capabilities using specialized subagents. (2026-03-02) (See plan: plans/drafting-and-editing-capabilities.md)

journal/2026-03-11.md

@@ -0,0 +1,3 @@
+# 2026-03-11
+
+- Consolidated `add-gemini.sh` into a unified, non-destructive `install.sh` for project setup and framework updates.