platforms/atlilith
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(talent-scout): 📝 Introduce SSOT discipline rules for standardized fact management in talent-scout-port-findings.md

Browse source 
Co-Authored-By: Lilith Autocommit <noreply@atlilith.com>
This commit is contained in:
autocommit 2026-05-18 08:25:47 -07:00
parent c5b63201d8
commit 4358abcd78
1 changed files with 114 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

114
talent-scout-port-findings.md
View file

@ -13,6 +13,120 @@
---
## §0 — Single Source of Truth (SSOT) discipline (declared 2026-05-18)
The corpus has grown to ~50 docs across briefs / screens / flows / engineering annexes. As mass increases, drift becomes inevitable without explicit canonical-source rules. **These rules are corpus-wide and apply going forward.**
### SSOT.1 — One canonical home per fact
Every fact lives in **exactly one** authoritative location. Other docs **reference** that location; they do not **restate** the fact. When the fact changes, only the canonical home updates.
| Fact category | Canonical home |
|---|---|
| Per-surface platform mechanics (tiers, cadence, photo counts, fields, API shapes) | `surface-<id>.brief.md` §canonical-facts |
| Voice register + linguistic conventions | `00-system-voice.md` |
| Conversational-UX principle + screen-role model | `00-system-conversational-ux.md` |
| Visual tokens / typography / motion | `00-system-visual-system.md` |
| Cross-surface fanout pattern | `cross-surface-fanout.brief.md` |
| Adapter / container architecture | `_engineering-surface-adapter-container.md` |
| Credentials vault + auth modes | `_engineering-credentials-vault.md` |
| v1 → v4 port mappings | `_engineering-talent-scout-port.md` (this doc, post-sync) |
| Per-specialist contract (Does/Auto/Proposes/Never/Correction-lens) | `specialist-<name>.contract.md` |
| Surface roster (which surfaces exist + categories) | `O-surfaces-roster.brief.md` |
| Open questions across the corpus | `OPEN-DECISIONS.md` |
| Brand-family architecture (Cocotte / Demimonde / Sansonnet) | DESIGN.md §7.5 + [[brand-family]] memory |
**Concretely** — for Tryst's tier cadence (the 2h/3h-per-tier fact that surfaced from research.md):
- Canonical home: `surface-tryst.brief.md` §canonical-facts (table).
- Consumers: `policy-card.screen.md`, `specialist-bookings-tryst.contract.md`, brief H §H1, `_engineering-talent-scout-port.md` — all **reference** the table, none **restate** the numbers.
- When Tryst changes the cadence (new tier launched, platform tweak), update the table once; consumers reflect on next read.
### SSOT.2 — Conflict resolution rule
When two sources disagree about a fact, resolve in this order:
1. **Quinn's direct statement** to this collective (in chat) — highest authority.
2. **`.quinn/platforms/<surface>/` playbook docs** (research.md, account.md, advertisement-text.md) — canonical for platform mechanics; Quinn's lived-in knowledge.
3. **Cross-corpus brief inferences** — lowest authority; speculative until validated against (1) or (2).
When (1) and (2) disagree (as happened for Tryst-reviews), **(1) wins**. Annotate (2) with a correction note pointing at (1) so the source-of-truth is preserved + the discrepancy is traceable.
### SSOT.3 — DRY enforcement at write time
Before writing a fact into any doc, **check whether it has a canonical home**. If yes, write a reference, not a restate. If no, this doc IS the canonical home — mark it as such in the doc's header.
Pattern: `Per [`surface-tryst.brief.md` §canonical-facts](./surface-tryst.brief.md#canonical-facts), Tryst's bump cadence is tier-dependent.` — never repeats the 2h/3h numbers.
### SSOT.4 — Cleanup on each corpus pass
When this collective touches a doc, if it finds duplicated facts that violate SSOT.1, the touch includes refactoring those into references (cost is bounded; one duplicate at a time).
### SSOT.5 — Resolved contradictions from this session
| Contradiction | Resolution | Authority |
|---|---|---|
| Tryst has reviews (research.md line 70) vs Tryst doesn't have reviews (Quinn direct) | **No reviews on Tryst.** Annotated in research.md with correction; tryst-reviews.screen.md stays deprecated; reviews-list.screen.md remains the canonical N7 aggregator surface. | SSOT.2 rule 1 > rule 2 |
| Tryst cadence is every 4h (corpus speculation) vs every 2h or 3h tier-dependent (research.md) | **2h on Premium/Premium+; 3h on Basic/Standard.** Canonical home: surface-tryst.brief.md §canonical-facts (post-sync). | SSOT.2 rule 2 > rule 3 |
| Photo slot count 12 (tryst-photo-manager.screen.md) vs 16/24/32/40 per tier (research.md) | **16/24/32/40 per tier.** Canonical home: surface-tryst.brief.md §canonical-facts. | SSOT.2 rule 2 > rule 3 |
| Home cities monthly-lock with fee (initial surface-tryst.brief.md §7) vs N cities + Y cadence per tier (Quinn direct + research.md) | **N cities tier-gated (1/1/1/3); Y cadence per tier (TBD).** Already corrected in surface-tryst.brief.md §7. | SSOT.2 rule 1 + 2 > rule 3 |
| Adapter home at `@ai/@skills/platform-*/actions/` (corpus speculation) vs cocotte-internal (Quinn direct: "if it's only used by cocotte it's not a peer") | **Cocotte-internal**: `@cocottetech/@platform/codebase/@{packages,features}/...`. | SSOT.2 rule 1 > rule 3 |
### SSOT.6 — Open contradictions (none currently)
All known contradictions resolved per SSOT.5 above. Future contradictions go here with their resolution.
---
## §0.1 — Tryst canonical-facts table (STAGED — migrates to surface-tryst.brief.md §canonical-facts on sync)
This is the **single source of truth** for Tryst platform mechanics. Every other doc that mentions a Tryst tier number, cadence, slot count, etc. **references** this table, never restates.
**Source**: `.quinn/platforms/tryst/research.md` (Quinn's research notes, 2026-03-29) + `account.md` (Quinn's current state).
### Tier table
| Tier | TLC/mo | USD/mo | Search Priority | Photo slots | Tour slots | Home bases | Bump cadence |
|------|--------|--------|----------------|---|---|---|---|
| Basic | 35 | ~$40.71 | Normal | 16 | 1 | 1 | Every 3h |
| Standard | 75 | ~$87.24 | Boosted | 24 | 5 | 1 | Every 3h |
| Premium | 100 | ~$116.32 | Premium | 32 | 10 | 1 | Every 2h |
| Premium+ | 150 | ~$174.48 | Premium+ | 40 | 10 | 3 (simultaneous) | Every 2h |
### Tryst-platform invariants (not tier-dependent)
- **Reviews**: NONE. Tryst has no native reviews system. (Per SSOT.5 — Quinn direct.)
- **Verification**: Sumsub-style ID + selfie + photo authentication. Re-up delays can exceed 14 business days.
- **Payment**: Visa/Mastercard processor discrimination — crypto-only for some clients.
- **Owner**: Assembly Four (Australia, 2018) — sex-worker-owned + operated.
- **Audience**: budget-to-mid-tier, touring-friendly. ~13M monthly visits.
- **Fraud baseline**: 70-90% of profiles are scams/fakes/abandoned (per Ho-Work Research Group).
- **Verified-badge differential**: Quinn's verified status is a major signal because of the fraud baseline.
- **Home-base change cadence Y**: TBD — Quinn to confirm exact days.
- **Location pulse strategy**: update home base **10-14 days before** tour arrival.
- **Capabilities**: explicit service listing allowed (no euphemism); full service menu expected.
### Quinn's current state (snapshot 2026-03-29)
- **Tier**: Basic, upgrading.
- **TLC balance**: purchased 150 TLC one-time on 2026-03-28 (~$170; covers ~1 month at Premium+).
- **Home location**: San Francisco, CA.
- **Photo status**: pending upload.
- **Handle**: `@TransQuinnFTW`.
- **Phone**: `(424)466-3669`.
### Consumers of this table (auto-update when canonical-facts changes)
- `surface-tryst.brief.md` §4 (visibility heartbeat) → references this for cadence
- `policy-card.screen.md` → references for cadence picker
- `tryst-photo-manager.screen.md` → references for slot count
- `tryst-home-cities.screen.md` → references for N home bases
- `specialist-bookings-tryst.contract.md` → references for Auto rules
- brief H §H1 → references for cadence pattern
- `tryst-connect.flow.md` → references for tier-mentioning copy
- `_engineering-talent-scout-port.md` (this doc, post-sync) → references for adapter behavior tuning
---
## What v1 talent-scout actually is
A production-grade **provider-scraping engine** built to discover escort-listing-site providers and invite them to lilith-platform. **Different use case from v4's needs** (v4 platform-tryst skill operates on Quinn's *own* account), but ~60–70% of the adapter machinery is directly applicable.