docs: reorganize both READMEs around a Quick Start, add ecosystem diagram

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cys",
-  "version": "0.6.18",
+  "version": "0.6.19",
   "description": "Development methodology skills with parallel plan execution: design, plan, run, check, ship. Named after the author's twin daughters, Cielo y Sophia.",
   "author": { "name": "Christian Bacilio" },
   "repository": "https://github.com/bacsystem/parallel-plan-executor",

.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cys",
-  "version": "0.6.18",
+  "version": "0.6.19",
   "description": "Development methodology skills for design, plan, check, and ship — parallel plan execution (cys:run) is Claude Code only for now.",
   "author": { "name": "Christian Bacilio" },
   "repository": "https://github.com/bacsystem/parallel-plan-executor",

CHANGELOG.md

@@ -5,6 +5,29 @@ 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.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.6.19 — 2026-07-19
+
+Changed:
+
+- Reorganized both `README.md` and `README.es.md` around a clear path
+  for a new user: What is cys → demo → Quick Start → plugin install (per
+  platform) → permissions setup → Using cys (step-by-step guide, manual
+  reference, `/run-plan`, Handoff, branch topology) → Building from
+  source → How it works → safety checks & known limitations → reporting
+  bugs & contributing. Added a table of contents to both. Surfaces a
+  distinction the old ordering buried: installing the cys plugin via the
+  marketplace already gives a ready-to-run, pre-built copy of this repo
+  — cloning and `npm run build` are only needed for contributors or
+  advanced engine use, not a typical first run.
+- Embedded `docs/diagram/flujo-cys-ecosystem.mmd`'s content directly as
+  a rendered Mermaid diagram in both READMEs instead of only linking the
+  file.
+
+Fixed:
+
+- `examples/README.md`'s `#usage` anchor link, stale after the
+  reorganization renamed that section to `#using-cys`.
+
 ## 0.6.18 — 2026-07-19
 
 Added:

examples/README.md

@@ -26,4 +26,4 @@ read yourself right now.
 4. To actually run this plan in parallel (not just read its graph), point
    `cys:run` / `/cys:run-plan` at `examples/hello-parallel/plan.md`
    against a throwaway git repo of your own — see the main
-   [README](../README.md#usage) for the full launch steps.
+   [README](../README.md#using-cys) for the full launch steps.

gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "cys",
-  "version": "0.6.18",
+  "version": "0.6.19",
   "description": "Development methodology skills for design, plan, check, and ship — parallel plan execution (cys:run) is Claude Code only for now.",
   "repository": "https://github.com/bacsystem/parallel-plan-executor",
   "license": "MIT"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "parallel-plan-executor",
-  "version": "0.6.18",
+  "version": "0.6.19",
   "author": "Christian Bacilio",
   "private": true,
   "type": "module",