docs: Improve clarity and correct markdown in agents-master.md

templates/agents-master.md

@@ -89,7 +89,7 @@ Cross-genome knowledge moves by **pull, never push**: the genome you are working
 Three actors, mirroring the ingest two-phase split:
 
 1. **Collector** (`collect-crossgen.sh`, deterministic, agent-free). Clones each genome flagged `cross_source: yes` **read-only at its remote HEAD** — a disposable checkout, for freshness; never the pinned submodule state. Reads each `wiki/index.md` plus the relevant pages and assembles a **dossier of excerpts with provenance** (source genome, page, date/commit). Writes nothing to any source genome.
-2. **Synthesis** (agent, navigation skill, `read`/`edit` only). Reads **only the dossier** — a single artifact inside the working genome's context — then the skill deposits **one** abstract, non-private raw into the working genome at `raw/articles/crossgen-<topic>-<<YYYY-MM-DD>.md`, and STOPS.
+2. **Synthesis** (agent, navigation skill, `read`/`edit` only). Reads **only the dossier** — a single artifact inside the working genome's context — then the skill deposits **one** abstract, non-private raw into the working genome at `raw/articles/crossgen-<topic>-<YYYY-MM-DD>.md`, and STOPS.
 3. **Target ingest.** The working genome's own standard pipeline processes that raw → PR → human gate. Same gate as any other source.
 
 ### When to pull
@@ -98,7 +98,7 @@ Pull is initiated deliberately (operator- or context-driven, never on a timer).
 
 1. **Ownership elsewhere.** The concept, entity, or pattern is defined and maintained in another genome, and you need it framed for the working domain.
 2. **Structural relevance.** It influences decisions, patterns, or entities here — not a casual mention.
-3. **No fresh local coverage.** `qmd search "&lt;concept&gt;"` in the working genome returns nothing, or only a stub that needs enrichment.
+3. **No fresh local coverage.** `qmd search "<concept>"` in the working genome returns nothing, or only a stub that needs enrichment.
 
 If in doubt, do NOT pull. A missed cross-reference is cheaper than crossgen spam.
 
@@ -112,14 +112,13 @@ If in doubt, do NOT pull. A missed cross-reference is cheaper than crossgen spam
 
 ### Output raw (the only artifact written)
 
-**Path (in the working genome):** `raw/articles/crossgen-&lt;topic&gt;-&lt;&lt;YYYY-MM-DD&gt;.md`
+**Path (in the working genome):** `raw/articles/crossgen-<topic>-<YYYY-MM-DD>.md`
 Plain text. No YAML frontmatter (raw is immutable input). **No wikilinks of any kind** — never a `[[../genome-*/...]]` path.
 
 ```markdown
-&gt; Cross-genome pull | Into: genome-&lt;working&gt; | Sources: genome-&lt;a&gt; (wiki/concepts/x.md), genome-&lt;b&gt; (wiki/entities/y.md) | HEAD: &lt;short-sha…&gt; | Date: YYYY-MM-DD
-```
+> Cross-genome pull | Into: genome-<working> | Sources: genome-<a> (wiki/concepts/x.md), genome-<b> (wiki/entities/y.md) | HEAD: <short-sha…> | Date: YYYY-MM-DD
 
-# &lt;Topic&gt; (synthesized from other genomes)
+# <Topic> (synthesized from other genomes)
 
 ## What the source genomes say
 [Abstract, faithful synthesis of the relevant material. Plain text, no private data, no wikilinks.]
@@ -128,16 +127,11 @@ Plain text. No YAML frontmatter (raw is immutable input). **No wikilinks of any
 [Why it matters in the working domain; textual references to existing local entities, if any.]
 
 ## Suggested local action
-[Semantic hint for this genome's ingest: e.g., create/update wiki/concepts/&lt;concept&gt;.md, map local relationships.]
+[Semantic hint for this genome's ingest: e.g., create/update wiki/concepts/<concept>.md, map local relationships.]
+```
 
----
+**Rules:**
 
 - Each pull writes a **new, dated** crossgen file — never overwrite or edit an existing raw (raw is immutable). Deduplication happens later, at the **wiki** level: the working genome's normal ingest reconciles against existing pages via its §Conflict procedure.
-
 - The raw is processed by the working genome's standard ingest as an ordinary `raw/articles/` source — no special path.
-
 - The collector and the raw deposit are the **deterministic** side of the skill; the agent only synthesizes content. Agents never create, modify, or delete files in any `raw/` directly.
-
----
-
-That closes the remaining audit items for `agents-master.md`. The file is now fully pull-oriented and consistent with the dossier.