diff --git a/templates/agents-master.md b/templates/agents-master.md index 127a5ef..3cf2c52 100644 --- a/templates/agents-master.md +++ b/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--.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 "<concept>"` in the working genome returns nothing, or only a stub that needs enrichment. +3. **No fresh local coverage.** `qmd search ""` 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-<topic>-<<YYYY-MM-DD>.md` +**Path (in the working genome):** `raw/articles/crossgen--.md` Plain text. No YAML frontmatter (raw is immutable input). **No wikilinks of any kind** — never a `[[../genome-*/...]]` path. ```markdown -> 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 -``` +> Cross-genome pull | Into: genome- | Sources: genome- (wiki/concepts/x.md), genome- (wiki/entities/y.md) | HEAD: | Date: YYYY-MM-DD -# <Topic> (synthesized from other genomes) +# (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/<concept>.md, map local relationships.] +[Semantic hint for this genome's ingest: e.g., create/update wiki/concepts/.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.