docs(book): F7.5 (2/2) — COMPONENT_GUIDE moved; guides/ batch COMPLETE

src/uix/soma/COMPONENT_GUIDE.md (1449 L, English body) moved to
docs/guides/component-guide.md. The only Spanish passage — the
archetype-canon banner (2026-06-19) — translated in the move; the rest
is verbatim. Banner's ARCHETYPE_COHERENCE_AUDIT link reaches into src
(audit fossil, stays with the code); the checklist cross-link is now
the sibling ./completion-checklist.md and the 'soma/README s9' mention
now names architecture/soma.md (its post-F7.2 home). Corpus swept:
authoring + README E4 stratum rows (also stale THEMING_GUIDE name),
building-a-component phases 0/2, architecture/{soma-architecture s4/
s13-tree/s17, overview, morfo, active-architecture}.

F7.5 complete: docs/guides/ = component-guide, completion-checklist,
demo-authoring, component-audit. docs:check 0 errors, warns back at
the 11 baseline.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

docs/README.md

@@ -40,7 +40,7 @@ The corpus is organized in layers of permanence, not by folder:
 | **E1 — architecture** | how the layers fit | `docs/architecture/` (the book chapters) + in-place stubs |
 | **E2 — canon** | the fixed vocabulary & contracts | `CANON.md`, `eidos/TSC.md`, `GUIA_IMPLEMENTACION_SEMAUIX.md` |
 | **E3 — decisions / RFC** | *why* it is built this way | `decisions.md` + the RFCs & decision logs |
-| **E4 — guides** | how to do a thing | `COMPONENT_GUIDE.md`, `THEMING*` |
+| **E4 — guides** | how to do a thing | `guides/`, `theming/guide.md` |
 | **E5 — module reference** | per-artifact docs | `arts/*/README`, `libs/*`, `svrs/*` |
 | **process** | ephemeral (hand-offs, snapshots, audits) | `docs/process/` — never a source of truth |
 

docs/architecture/active-architecture.md

@@ -828,7 +828,7 @@ must evolve consciously.
 - [`architecture/morfo.md`](./morfo.md) — declaration, archetypes, the 2-of-3 rule
 - [`architecture/sema.md`](./sema.md) — the `emit` contract, canonical verbs
 - [`SOMA_ARCHITECTURE.md`](./soma-architecture.md) — the runtime + components
-- [`COMPONENT_GUIDE.md`](../../src/uix/soma/COMPONENT_GUIDE.md) — the operational guide to create/migrate components
+- [`component-guide.md`](../guides/component-guide.md) — the operational guide to create/migrate components
 - [`architecture/eidos.md`](./eidos.md) — the visual layer: tokens, themes, recipes, wrappers
 - [`src/arts/adom/README.md`](../../src/arts/adom/README.md) — `dom.apply` + reactive DOM services
 - [`GUIA_IMPLEMENTACION_SEMAUIX.md`](../../src/docs/GUIA_IMPLEMENTACION_SEMAUIX.md) — the original API conventions (historical seed; [`CANON.md`](../CANON.md) rules)

docs/architecture/morfo.md

@@ -869,6 +869,6 @@ picker docs still need the event table, targets and `data-event` trace path.
 
 - [types.ts](../../src/uix/morfo/types.ts) — the TypeScript interfaces (authoritative reference).
 - [PERMUTATION_RUNNER.md](../../src/uix/morfo/PERMUTATION_RUNNER.md) — CI tool that cycles components through their state space.
-- [COMPONENT_GUIDE.md](../../src/uix/soma/COMPONENT_GUIDE.md) — soma component authoring (morfo-specific discipline: translation-namespace grep, DOM-topology audit, smoke validation).
+- [component-guide.md](../guides/component-guide.md) — soma component authoring (morfo-specific discipline: translation-namespace grep, DOM-topology audit, smoke validation).
 - [sema/README.md](./sema.md) — semantic layer (morfo provides everything Sema needs via `events[].semantic`).
 - [`src/docs/GUIA_IMPLEMENTACION_SEMAUIX.md`](../../src/docs/GUIA_IMPLEMENTACION_SEMAUIX.md) — convenciones doctrinales del API.

docs/architecture/overview.md

@@ -497,7 +497,7 @@ Seven pieces, seven responsibilities, none invades the next.
    consumes from the DOM + wrappers
 4. [`SOMA_ARCHITECTURE.md`](./soma-architecture.md) — the
    runtime that transcribes morfo
-5. [`COMPONENT_GUIDE.md`](../../src/uix/soma/COMPONENT_GUIDE.md) — the
+5. [`component-guide.md`](../guides/component-guide.md) — the
    operational guide to create/migrate components
 6. [`src/arts/adom/README.md`](../../src/arts/adom/README.md) — `dom.apply`
 7. [`architecture/active-uix.md`](./active-uix.md) — the composition root

docs/architecture/soma-architecture.md

@@ -414,7 +414,7 @@ re-anchor `placeholder` so the final month lands in the rightmost visible
 column, never showing the user a month that doesn't contain their selection.
 
 See A27 in
-[`COMPONENT_GUIDE.md`](../../src/uix/soma/COMPONENT_GUIDE.md) for the full
+[`component-guide.md`](../guides/component-guide.md) for the full
 checklist.
 
 ## 5. Runtime parts
@@ -862,7 +862,7 @@ could change, it is accessed through a formal boundary (as
 ```
 src/uix/soma/
 ├── SOMA_ARCHITECTURE.md       ← stub (this chapter lives in docs/architecture/)
-├── COMPONENT_GUIDE.md         ← step-by-step implementation guide
+├── COMPONENT_GUIDE.md         ← stub (the guide lives in docs/guides/component-guide.md)
 ├── README.md                  ← stub (the soma chapter lives in docs/architecture/)
 ├── runtime.svelte.ts          ← SomaRuntime (morfo interpreter)
 ├── errors.ts                  ← typed runtime/context errors
@@ -1008,7 +1008,7 @@ A soma component is considered stable when:
 
 ## 17. New component checklist
 
-See [`COMPONENT_GUIDE.md`](../../src/uix/soma/COMPONENT_GUIDE.md) for the
+See [`component-guide.md`](../guides/component-guide.md) for the
 full step-by-step process (27 general steps + 4 date/time specific, with
 rules A1–A29). Summary:
 

docs/authoring.md

@@ -43,7 +43,7 @@ timeless it must read.
 | **E1 — architecture** | how the layers fit | `src/uix/active_architecture.md`, per-layer `README.md` (in-place) |
 | **E2 — canon** | fixed vocabulary / contracts | `docs/CANON.md`, `eidos/TSC.md` |
 | **E3 — decisions / RFC** | why a thing is built this way | `docs/decisions.md` + the RFC / design files |
-| **E4 — guides** | how to do a thing | `soma/COMPONENT_GUIDE.md`, `eidos/THEMING_GUIDE.md` |
+| **E4 — guides** | how to do a thing | `guides/component-guide.md`, `theming/guide.md` |
 | **E5 — module reference** | per-artifact docs | `src/arts/{name}/README.md` (in-place) |
 | **process** | hand-offs, snapshots, audits | `docs/process/` — ephemeral, never a source of truth |
 

docs/building-a-component.md

@@ -27,9 +27,9 @@ this doc wins on *order*; the phase doc wins on *content*.
 
 | Phase | You produce | Read THIS | Verified by |
 | --- | --- | --- | --- |
-| **0 · Decide** | comparison table vs ark/bits/radix (+ react-aria), membership call (soma or eidos-native), compose-first check | [`soma/COMPONENT_GUIDE.md`](../src/uix/soma/COMPONENT_GUIDE.md) §Before You Start (1–4) · membership: [`architecture/soma.md`](./architecture/soma.md) §2 | reviewer — the table goes in the component README (phase 7) |
+| **0 · Decide** | comparison table vs ark/bits/radix (+ react-aria), membership call (soma or eidos-native), compose-first check | [`component-guide.md`](./guides/component-guide.md) §Before You Start (1–4) · membership: [`architecture/soma.md`](./architecture/soma.md) §2 | reviewer — the table goes in the component README (phase 7) |
 | **1 · Morfo** | `src/uix/morfo/components/{kebab}.ts` — parts, data/aria, keyboard, events (family/verb/intent/sequence), `texts`, `expression` | [`morfo/README.md`](./architecture/morfo.md) §Authoring a new morfo · vocabulary: [`CANON.md`](./CANON.md) | `validateMorfo` + `npm run morfo:vocabulary` + audit `A-*` |
-| **2 · Soma** | `{kebab}-provider.svelte.ts` + thin wrappers + `types.ts` + provider test | [`soma/COMPONENT_GUIDE.md`](../src/uix/soma/COMPONENT_GUIDE.md) (patterns + rules A1–A37) | provider test + `npm run check` |
+| **2 · Soma** | `{kebab}-provider.svelte.ts` + thin wrappers + `types.ts` + provider test | [`component-guide.md`](./guides/component-guide.md) (patterns + rules A1–A37) | provider test + `npm run check` |
 | **3 · Sema** | pack `src/uix/sema/components/{kebab}.ts` (or explicit `expression: 'family-default'`) — selectors via `semaSelector` ONLY | [`architecture/sema.md`](./architecture/sema.md) §packs + §typed builder · pack-vs-default criteria: [`LIBRO_VARIACIONES`](../src/docs/LIBRO_VARIACIONES_Y_EXTENSIONES.md) D.4 | `npm run morfo:vocabulary` (expression coverage) |
 | **4 · Eidos wrapper** | `eidos/components/{kebab}/` — root + attached parts (option C), visual props | [`eidos/components/README.md`](../src/uix/eidos/components/README.md) (the 7 hard rules) | `component-api-contract` test + audit `E-*` |
 | **5 · Recipe + theming** | recipe tokens in `lib/recipes/base.ts` + `{kebab}.css` | [`theming/guide.md`](./theming/guide.md) pasos 1–6 · **mandatory contract**: [`canon/recipe-contract.md`](./canon/recipe-contract.md) · scope (if `data-color`): [`canon/tsc.md`](./canon/tsc.md) | `npm run generate:eidos-css` + `recipe-css-contract` test + audit `R-*` (R-4.x = the contract) |