tres-onboarding

# TRES Finance — Full Entity Onboarding

Orchestrate the complete onboarding of a new entity/customer/account into TRES Finance.
This skill does not contain its own low-level logic — instead, it drives the user through
8 sequential steps, invoking the dedicated skill for each one. Think of it as a conductor
that keeps the onboarding moving forward while each sub-skill handles the details.

---

## Before You Start

**No visualizations for input gathering.** Do NOT use show_widget, HTML widgets, interactive
forms, AskUserQuestion widgets, or any visualization tool when collecting initial context from
the user or presenting the onboarding roadmap. Ask all questions and present the roadmap as
plain text in the chat. This keeps the flow fast and responsive — building a widget just to
ask for a name and wallet list adds unnecessary latency. Visualizations are fine later when
individual sub-skills need them (e.g., balance validation dashboards, recon gap tables), but
the onboarding kick-off and step transitions must be text-only.

1. **Confirm intent.** The user must have explicitly requested a full onboarding (new entity,
   new customer, new account). If the request is ambiguous, ask: "Are you looking to run the
   full onboarding flow for a new entity, or do you just need help with a specific step
   (like uploading wallets or validating balances)?"

2. **Collect context.** Ask the user in plain text (no widgets, no forms) for:
   - The entity/customer/account name
   - Any wallets or exchange accounts they already have ready (file, list, etc.)
   - Whether they have a target date in mind for the onboarding

3. **Present the roadmap.** Before diving in, show the user the roadmap as plain text
   in the chat (not as an HTML widget or visualization) so they know what to expect.
   Use something like:

   > Here's the onboarding roadmap for **[Entity Name]**:
   >
   > 1. **Upload Wallets** — Add on-chain wallets and/or exchange accounts
   > 2. **Data Collection (Commit)** — Pull on-chain data for the uploaded wallets
   > 3. **Validate Balances** — Cross-check TRES balances against on-chain sources
   > 4. **Reconciliation** — Review and resolve any balance gaps
   > 5. **Cost Basis** — Configure and run cost basis calculation
   > 6. **Export Unidentified Addresses** — Extract 3rd-party addresses from transactions
   > 7. **Import Contacts** — Label and import the identified addresses back into TRES
   > 8. **Rollup Rules** — Set up transaction aggregation for high-volume wallets
   >
   > We'll go through each step together. Ready to start?

---

## The Onboarding Pipeline

Work through each step in order. After completing each step, briefly summarize what was
accomplished and ask the user if they're ready to move on. If a step isn't relevant
(e.g., no high-volume wallets that need rollup rules), the user can skip it.

**Important:** For each step, invoke the corresponding skill by name. Read its SKILL.md
and follow its instructions. The sub-skill handles all the details — your job is to
transition smoothly between steps and keep the user oriented.

### Step 1: Upload Wallets
**Skill:** `tres-wallets-upload`

Invoke the tres-wallets-upload skill. This guides the user through adding their on-chain
wallets and/or exchange accounts into TRES. Once wallets are created, confirm the count
and proceed.

**Transition:** "Wallets are uploaded. Next, we'll collect on-chain data for them."

---

### Step 2: Data Collection (Commit)
**Skill:** `tres-data-collection-commit`

Invoke the tres-data-collection-commit skill. This triggers on-chain data collection for
the wallets that were just uploaded. The commit may take some time depending on the number
of wallets and their history.

**Transition:** "Data collection is in progress / complete. Next, let's validate that the
balances TRES pulled match what's actually on-chain."

---

### Step 3: Validate Balances
**Skill:** `tres-asset-balance-validation`

Invoke the tres-asset-balance-validation skill. This compares TRES balances against DeBank
(for EVM wallets) and generates a discrepancy report. Review any issues with the user.

**Transition:** "Balance validation is done. Let's move on to reconciliation to close any
remaining gaps."

---

### Step 4: Reconciliation
**Skill:** `tres-recon-gaps`

Invoke the tres-recon-gaps skill. This fetches reconciliation gap data, displays it, and
helps the user resolve any on-chain vs. book balance discrepancies. If there are no gaps,
celebrate and move on.

**Transition:** "Reconciliation is squared away. Now let's set up cost basis calculation."

---

### Step 5: Cost Basis
**Skill:** `tres-cost-basis`

Invoke the tres-cost-basis skill. This walks through strategy selection if needed, triggers
cost basis calculation, surfaces per-asset results and financial issues, and covers
reevaluations, spec-ID rules, and related cost basis operations as needed. Review any
financial issues (negative balances, missing fiat prices) that surface.

**Transition:** "Cost basis is configured and running. Next, let's identify the external
addresses your wallets have been interacting with."

---

### Step 6: Export Unidentified Addresses
**Skill:** `tres-export-3rd-party-contacts`

Invoke the tres-export-3rd-party-contacts skill. This extracts all unidentified external
addresses from the entity's transactions and exports them as an XLSX workbook. The user
will need to review and label these addresses (who each address belongs to).

**Transition:** "The unidentified addresses have been exported. Once you've labeled them,
we'll import them back as contacts. If you need time to fill in the names, we can pause
here and come back to the next step later — just say 'continue onboarding' when ready."

**Note:** This step produces output that the user needs to review and fill in offline.
Offer to pause the onboarding here and resume later. If the user wants to continue
immediately (maybe they'll label contacts later), that's fine — skip to Step