--- name: timeback-platform3 description: Use when an agent needs to build, audit, QA, migrate, or integrate against TimeBack Platform3 across multiple modules, standards surfaces, or producer surfaces. This is the global router skill: it chooses the correct Platform3 module skill pack or producer-surface API, keeps module-specific semantics in module contracts, and prevents local business-rule copies. Do not use it as a replacement for a module skill pack when making module-specific claims. --- # TimeBack Platform3 Use this skill first when the task is about Platform3 as a whole: choosing a surface, orienting a customer, finding the right module, installing a skill pack, checking whether a product should call Alpha, 1EdTech, or a producer-surface API, or deciding whether a missing capability belongs on the platform. This pack is a router. It does not define Results, Analytics, People, Curriculum, Content, Events, CASE, QTI, OneRoster, Caliper, NWEA MAP, Ed-Fi, or Incept semantics. Load the relevant module skill pack before building module behavior or making module-specific claims. For first-class producer surfaces such as Incept, use the governed Platform producer-surface API listed in the manifest and surface map. ## Ownership This is the only global Platform3 skill-pack entry point. Its canonical path is `/skill_pack/` and its tracked source root is `site/skill_pack/`. No `///skill_pack/` deliverable owns or regenerates this pack. Those URLs are module-specific executable contracts; `/platform/1edtech/skill_pack/` is only the Platform Admin/shared-conventions module pack. ## Contract Sources Start with: - Platform3 root: https://platform3-andymontgomery-9773s-projects.vercel.app/ - Build status: https://platform3-andymontgomery-9773s-projects.vercel.app/status - Global manifest: https://platform3-andymontgomery-9773s-projects.vercel.app/skill_pack/skill-pack.json - Surface map reference: `references/surface-map.md` - XP policy ownership map: `references/xp-policy-map.md` The module skill packs are the executable contracts for module work. For example, Results owns settled outcomes and student state; Analytics owns derived report facts; People & Orgs owns roster and age-grade facts; Curriculum owns the shared learning graph. Producer surfaces are not product modules and do not get invented `/incept/alpha` routes; Platform exposes them through the Platform producer-surface API. ## First Actions 1. Identify the customer's job and the facts it needs. 2. Choose the smallest owning module: - Use Results Alpha for durable student outcomes, MAP score reads, mastery, working grade, XP ledger, report-card, and report-ready Results views. - Use Analytics Alpha for derived facts such as minutes, XP rollups, daily XP progress, streaks, accuracy, attempt counts, response latency, hint usage, completion, grade-level status, school-day calculations, RIT/grade reads, and report metrics. - Use People & Orgs Alpha for identity, roster, memberships, organization hierarchy, school periods, Alpha school calendar reads, guide rosters, and effective-dated age-grade source facts. - Use Curriculum Alpha for the learning graph, course/grade structure, standards references, expected XP, and track definitions. - Use Content Alpha for student-facing learning materials, questions, tests, media, and interactive content. - Use Events Alpha for activity moments before they become Results or Analytics facts. - Use Platform 1EdTech for module registry, tenants, audit logs, idempotency, and platform admin conventions. - Use OneRoster, QTI, Caliper, CASE, NWEA MAP, or Ed-Fi 1EdTech packs for standards-specific integration work. Use Ed-Fi for source-standard CalendarDate integration work; use People & Orgs Alpha for customer-facing school-day reads. - For an Incept Content/Curriculum handoff, first read the [producer acceptance envelope](/platform/1edtech/skill_pack/pack/references/contract-map.md#incept-producer-to-platform-acceptance-envelope). Use `/platform/producer-surfaces/incept/progress` only for operational provenance/status; Incept producer traffic uses `trafficClass` values `customer`, `goal-run`, and `self-test`, with headline Accuracy counting only `customer`. - For XP policy questions, start with `references/xp-policy-map.md`: Content owns item expected effort, Curriculum owns course/tree denominators, Analytics owns report and motivational rollups, and Results owns student-facing progress plus awarded-XP ledger behavior. 3. Load that module's skill pack and its data dictionary before making module-specific claims. 4. Use only documented Platform3 surface calls and returned fields. 5. If the platform does not expose a needed fact, file a Platform3 surface gap. Do not implement the platform's missing business rule in the customer app. ## Non-Negotiables - Do not treat `/platform/1edtech/skill_pack` as the global Platform3 pack. It is the Platform admin and 1EdTech shared-conventions pack. - Do not copy lookup tables, norms, RIT curves, calendar rules, grade semantics, progress formulas, XP logic, MAP dedupe, mastery logic, or source-precedence rules into this global pack. - Do not read Postgres, Supabase, private logs, implementation source, or producer payloads for customer-facing behavior unless the owning module pack explicitly says an operator-only diagnostic allows it. - Do not create aliases for one concept just to satisfy a consumer's guessed route name. Use the canonical route from the owning module's customer website and data dictionary. - Do not decide a business semantic in app code. The data dictionary or lower platform layer declares semantics; implementation mechanically serves them. - Do not create `/incept/alpha` module routes for Incept progress. Incept is a first-class upstream producer surface owned by Platform; its canonical customer-progress read model is exposed through `/platform/producer-surfaces/incept/progress`. - Do not submit acceptance through the Incept progress API. Content owns imported identities, item-scoped KC tags, exact-version QC receipts, trust, and release eligibility; Curriculum owns exact targets and placement. ## Install Install this folder as `timeback-platform3`, then use it to load the module pack needed for the task: ```sh export SKILL_PACK_URL="https://platform3-andymontgomery-9773s-projects.vercel.app/skill_pack" export SKILL_DIR="${CODEX_HOME:-$HOME/.codex}/skills/timeback-platform3" mkdir -p "$SKILL_DIR/references" "$SKILL_DIR/checks" curl -fsSL "$SKILL_PACK_URL/pack/SKILL.md" -o "$SKILL_DIR/SKILL.md" curl -fsSL "$SKILL_PACK_URL/pack/references/surface-map.md" -o "$SKILL_DIR/references/surface-map.md" curl -fsSL "$SKILL_PACK_URL/pack/references/xp-policy-map.md" -o "$SKILL_DIR/references/xp-policy-map.md" curl -fsSL "$SKILL_PACK_URL/pack/checks/verify-skill-pack.mjs" -o "$SKILL_DIR/checks/verify-skill-pack.mjs" curl -fsSL "$SKILL_PACK_URL/skill-pack.json" -o "$SKILL_DIR/skill-pack.json" ``` Run the verifier. By default it checks the global router plus every advertised module pack's index, `skill-pack.json`, and installable `pack/SKILL.md`: ```sh cd "$SKILL_DIR" node checks/verify-skill-pack.mjs ``` Set `PLATFORM3_SKIP_MODULE_INSTALL_PATHS=1` only for a local offline parse of the global pack. ## Output Rules - Name the owning module/surface or producer surface before recommending an endpoint. - Include the canonical module skill-pack URL when handing work to another agent. - For Incept progress/status, cite the Platform producer-surface API path and the `incept-customer-progress-v1 / generation-loop-progress-report` read model. - Say "Platform3 gap" when a consumer would otherwise need to compute a platform-owned fact locally. - Keep credentials out of generated artifacts. Use caller-provided environment variables or module-pack credential instructions. ## References - `references/surface-map.md` lists the canonical module skill packs and when to use each. - The Incept [producer acceptance envelope](/platform/1edtech/skill_pack/pack/references/contract-map.md#incept-producer-to-platform-acceptance-envelope) composes the existing Content and Curriculum handoff contracts. - `references/xp-policy-map.md` maps item/course expected effort, Analytics report/motivational rollups, and Results progress/award-formula ownership. - `checks/verify-skill-pack.mjs` confirms the global pack and each listed module pack is reachable.