Pokémon TCG — Orchestration and Handoff Artifact Ledger
Provenance map for the repository .agents topology, milestone sub-orchestrators, explorer handoffs and pending acceptance gates.
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.mdmaps 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.mdreports 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.mdidentifies 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.mdidentifies the auxiliary target columns,would_kosearch controls and source-reported test counts. It does not by itself establish a full ETL acceptance run..agents/sub_orch_m3/explorer_1/handoff.mdand.agents/sub_orch_m3/explorer_2/handoff.mdcontain 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/:
- record the artifact path and commit snapshot;
- classify it as instruction, plan, source-reported result, interpretation or acceptance evidence;
- check the live source tree, database or runnable artifact;
- retain contradictions and missing files as explicit status;
- 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_*/andexplorer_m2_*— survey handoffs and evidence classes.AGENTS.md,PROJECT.mdandTEST_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.