feat(onboard): add guided first-run reports

Author: rexleimo

CHANGELOG.md

@@ -14,6 +14,21 @@ All notable user-visible changes are documented in this file.
   - New CLI command group: `loopforge skills list|show|doctor|run`
   - New docs pages: skills reference and skills quickstart (EN + ZH)
 
+## [1.1.0] - 2026-03-06
+
+### Added
+
+- `loopforge onboard --starter <hello|workspace-brief|repo-onboarding>` for guided first-day task selection.
+- Workspace-local onboarding reports at `.loopforge/onboard-report.json` and `.loopforge/onboard-report.md`.
+- New first-day docs pages for starter tasks and onboarding troubleshooting (EN + zh-CN).
+- New blog post documenting the next LoopForge iteration informed by OpenFang and OpenClaw.
+
+### Changed
+
+- `loopforge doctor` now includes additive `next_actions` guidance and prints `Suggested next steps` in text output.
+- Onboarding metrics reports now include recommended fixes for the most common failure categories.
+- README, homepage, CLI reference, walkthrough, reliability docs, and nav now route users through `onboard` first.
+
 ## [1.0.0] - 2026-03-06
 
 ### Changed

Cargo.lock

@@ -14,7 +14,7 @@ members = [
 ]
 
 [workspace.package]
-version = "1.0.0"
+version = "1.1.0"
 edition = "2021"
 license = "MIT"
 rust-version = "1.75"

Cargo.toml

@@ -39,12 +39,39 @@ cargo build --release -p loopforge-cli
 ./target/release/loopforge --help
 ```
 
-## Quick start (dev)
+## Quick start (recommended)
+
+For repository-wide verification during development:
 
 ```bash
 ./init.sh
 ```
 
+For the best first user run, use `onboard`:
+
+```bash
+# 1) Start Ollama
+ollama serve
+
+# 2) Run one-command onboarding
+loopforge onboard --workspace loopforge-onboard-demo
+```
+
+Useful variations:
+
+```bash
+# setup-only path (skip first task)
+loopforge onboard --workspace loopforge-onboard-demo --skip-agent
+
+# use a more useful starter task
+loopforge onboard --workspace loopforge-onboard-demo --starter workspace-brief
+```
+
+After onboarding, LoopForge writes:
+
+- `loopforge-onboard-demo/.loopforge/onboard-report.json`
+- `loopforge-onboard-demo/.loopforge/onboard-report.md`
+
 ## Run with Ollama (OpenAI-compatible)
 
 LoopForge defaults to `ollama` at `http://127.0.0.1:11434/v1` in `~/.loopforge/config.toml`.
@@ -53,7 +80,7 @@ LoopForge defaults to `ollama` at `http://127.0.0.1:11434/v1` in `~/.loopforge/c
 # 1) Start Ollama
 ollama serve
 
-# 2) Init LoopForge
+# 2) Init LoopForge (optional if you use onboard)
 loopforge init
 
 # 3) Run an agent session in a workspace directory