---
type: reference
title: "Pokémon TCG — Orchestration and Handoff Artifact Ledger"
description: "Provenance map for the repository .agents topology, milestone sub-orchestrators, explorer handoffs and pending acceptance gates."
tags: [pokemon-tcg, provenance, handoff, orchestration, agents, ropend, moe, etl, metanoia, tests]
timestamp: "2026-08-15T18:10:00-03:00"
---

# Pokémon TCG — Orchestration and Handoff Artifact Ledger

## Purpose

The repository's `.agents/` directory is a handoff and orchestration record.
It is not the live implementation tree and it is not a test report. Its value
is historical and operational: it shows which research questions were
dispatched, which explorers returned evidence, which workers or reviewers were
still pending, and where an acceptance gate stopped.

This ledger preserves that topology so a future reader does not confuse an
agent briefing, a progress checkbox or a proposed target path with a shipped
module. The current code, database and runnable artifacts remain the authority
for implementation and numerical claims.

## Artifact topology at the handoff snapshot

| Layer | Artifact family | Function | Safe interpretation |
|---|---|---|---|
| Mission | `.agents/ORIGINAL_REQUEST.md` | User mission and acceptance contract | Normative target; unchecked criteria remain open |
| Root orchestration | `.agents/orchestrator_1/` | Survey roster, milestone dependencies and final handoff plan | Coordination state, not delivery proof |
| M1 sub-orchestrator | `.agents/sub_orch_m1/` | RoPEND, MoE, vehicle draft, policy and test scopes | Forward architecture plus gate state |
| M2 sub-orchestrator | `.agents/sub_orch_m2/` | Elite data, C++ oracle, database parity and auxiliary targets | ETL/data work plan plus evidence handoffs |
| M3 sub-orchestrator | `.agents/sub_orch_m3/` | Monograph, RFC and Metanoia synthesis | Research/documentation plan plus theorem gate |
| E2E orchestrator | `.agents/orch_e2e/` | Tier 1–4 test-writing and verification plan | Declared test topology; not a passing test suite |
| Explorers | `survey_explorer_*`, `explorer_m2_*`, `m1_exp_*` and M3 explorers | Repository, data, oracle and architecture surveys | Source-reported findings that require reconciliation |
| Workers and writers | `m1_worker_1/`, `test_writer_tier*/` | Proposed implementation/test work | Status depends on the progress and gate files |
| Rules | `.agents/rules/` | Channel isolation, follow-me and SQLite-schema constraints | Operating instructions for the handoff harness |

## Milestone status recorded by the artifacts

The following is a source-reported snapshot from the briefing, progress and
gate files. It is deliberately not merged into the live project status without
the reconciliation in [[pokemon_tcg_handoff_acceptance_reconciliation]].

The root handoff also names an August 16–31 “Locked Meta” evaluation horizon,
but that date window is a roadmap constraint, not evidence that a submission
or Apex runtime was delivered. Its database panel says “100% disk parity” and
its knowledge panel says “PageRank Isomorphism”; the direct audit and current
source reconciliation retain those as handoff claims because they conflict
with the observed FK violations and the unverified implementation bridge.

| Milestone | Artifact evidence | Gate interpretation |
|---|---|---|
| M1 RoPEND/MoE | Three explorers completed; `m1_worker_1` still in progress; reviewer, challenger and auditor verdicts pending | No implementation or acceptance gate passed |
| M2 elite dataset/DB parity | Database and dataset explorers were still surveying; the oracle explorer had returned a handoff; worker, reviews and audit had not started | Oracle findings are useful provenance, not proof of zero FK errors or a compiled elite corpus |
| M3 monograph/RFC/Metanoia | Explorer 1 and 2 handoffs were present; Explorer 3 was still reported as running; worker, review, challenge and audit remained pending | Research documents exist, but the stronger theorem/implementation gate remains open |
| E2E hardening | Tier writer directories and a verification plan existed; initialization/spec inspection was the last recorded progress | Declared test count is not evidence that the planned suite ran against live modules |
| M4 Wikifita sync | The root plan marked it pending or dependent on M3 | This current editorial work is observable documentation progress, not a claim that the original milestone acceptance was reached |

## High-signal explorer handoffs

The explorer reports contribute distinct evidence classes:

- `survey_explorer_1/handoff.md` maps strict FP32 conversion, package names,
  sentinel values and future RoPEND/MoE axes. Its “foundation sound” language
  is source-reported; current imports and runtime paths control the status.
- `survey_explorer_2/handoff.md` reports archive, match, Parquet and FK
  figures, plus a proposed explanation for dropped episodes. The figures are
  retained as survey observations; the proposed purge/rebuild interpretation
  is not elevated over the direct read-only audit.
- `survey_explorer_3/handoff.md` identifies stale rating-page targets and
  describes the PageRank/Abelian result as complete. The target identification
  was useful; the completion language is downgraded by the current-state and
  acceptance reconciliations.
- `explorer_m2_oracle/handoff.md` identifies the auxiliary target columns,
  `would_ko` search controls and source-reported test counts. It does not by
  itself establish a full ETL acceptance run.
- `.agents/sub_orch_m3/explorer_1/handoff.md` and
  `.agents/sub_orch_m3/explorer_2/handoff.md` contain the detailed PageRank,
  Bradley-Terry and invariant-Elo derivations. Their proof language is kept as
  research provenance, while the implementation-level isomorphism remains
  unverified.

The expected `.agents/sub_orch_m3/explorer_3/handoff.md` file was not present
in the inspected tree. That absence is part of the negative-space record; it
must not be filled by reconstructing an assumed report from a briefing.

## Provenance identifiers

The artifact tree names the orchestration lineage with stable session IDs,
including:

| Role | Identifier |
|---|---|
| Root orchestrator | `cd851a4f-6875-4819-9f25-1b23dd14cc1b` |
| Sentinel | `da74ca6c-c155-4353-82d1-5c5695a60da1` |
| M1 orchestrator | `9a189410-43b1-4cdc-bc2a-7a942180e59c` |
| M2 orchestrator | `f5143692-4dba-4e8a-aa34-f7465d296f9b` |
| M3 orchestrator | `4877bc7d-bfc2-44d3-bc55-1a9dd628ba39` |
| M2 oracle explorer | `4f2002e7-7972-4adb-a21f-95806599d6c4` |

The full M2 oracle identifier is resolved from the corresponding Antigravity
brain transcript directory. The earlier Wikifita entry used only the prefix
because the first inspected briefing excerpt was truncated.

## Reading protocol

For any claim recovered from `.agents/`:

1. record the artifact path and commit snapshot;
2. classify it as instruction, plan, source-reported result, interpretation or
   acceptance evidence;
3. check the live source tree, database or runnable artifact;
4. retain contradictions and missing files as explicit status;
5. link the resulting page to the timeline and handoff reconciliation.

This is the same boundary used for the Antigravity brain transcripts. Portable
transcript roots and report IDs are documented in
[[pokemon_tcg_cross_harness_provenance]].

## Primary sources

- `.agents/ORIGINAL_REQUEST.md` — mission and acceptance contract.
- `.agents/orchestrator_1/` — root roster and dependency state.
- `.agents/sub_orch_m1/`, `.agents/sub_orch_m2/`, `.agents/sub_orch_m3/` — milestone scopes, progress and gate files.
- `.agents/orch_e2e/` — E2E test orchestration state.
- `.agents/survey_explorer_*/` and `explorer_m2_*` — survey handoffs and evidence classes.
- `AGENTS.md`, `PROJECT.md` and `TEST_INFRA.md` — repository instructions, plan and declared test architecture.

## Cross-references

- [[pokemon_tcg_handoff_acceptance_reconciliation]] — claims reconciled against live paths and acceptance evidence.
- [[pokemon_tcg_cross_harness_provenance]] — Antigravity transcript/report lineage and cross-harness boundary.
- [[pokemon_tcg_current_state_reconciliation]] — current implementation, database and contradiction ledger.
- [[pokemon_tcg_repository_timeline]] — Git chronology for the handoff and research wave.
- [[pokemon_tcg_docs_corpus_provenance]] — complete `docs/` inventory and source-to-page map.
- [[pokemon_tcg_ropend_moe_blueprint]] — preserved future architecture and vehicle-draft direction.