Initial skills documentation — 25 categories, all SKILL.md + references + scripts

This commit is contained in:
root
2026-07-15 17:42:20 -04:00
commit 1b4fcd4427
976 changed files with 188344 additions and 0 deletions
@@ -0,0 +1,103 @@
# Credit Bureau Reporting for DRE — Quick Reference
## Authority: FCRA (15 U.S.C. §§ 16811681x) + Texas Fin. Code Ch. 392
## Can DRE Report to Consumer Credit Bureaus?
| Debt Type | Report to Equifax/Experian/TransUnion? | Rules |
|-----------|---------------------------------------|-------|
| **Consumer debt** (individual, personal/family/household) | ✅ Yes | FCRA furnisher duties + FDCPA pre-reporting contact + TX Ch. 392 |
| **Corporate B2B debt** | ❌ No | "Consumer" = individual (§ 1681a(c)); no consumer file for business entities |
| **Sole proprietor debt** | ✅ Yes | Individual = consumer. Report against individual's personal file |
| **Personal guarantor** | ✅ Yes | FTC Tatelbaum (2001): personal guarantor = consumer with permissible purpose |
| **B2B + personal guarantee** | ✅ Yes on guarantor, ❌ on entity | Report against guarantor individually; use business bureaus for the entity |
## FCRA Furnisher Duties (§ 1681s-2)
### § 1681s-2(a) — Duty of Accuracy (Gov't enforcement only — NO private right of action)
- Don't furnish info you know or have reason to believe is inaccurate
- Upon consumer's written notice of error, stop furnishing until confirmation
- Notify CRAs of corrections
- Note dispute status during investigation
### § 1681s-2(b) — Duty to Investigate (Private right of action EXISTS)
Triggered when a CRA notifies DRE of a consumer dispute:
1. Investigate within **30 days** (45 if free annual report dispute)
2. Review all relevant info from CRA
3. Report results to CRA
4. If inaccurate → correct with ALL nationwide CRAs
5. Don't re-report inaccurate info
**Liability:** Actual damages, statutory ($100$1,000), punitive, attorney's fees.
## Pre-Reporting Steps (FDCPA + CFPB Debt Collection Rule)
Before reporting a consumer debt to a CRA, DRE must:
1. **Contact the consumer** — in person, by phone, mail (~14 day wait), or electronic (~14 day wait)
2. **Send validation notice** — amount, creditor, 30-day dispute right. Sending this satisfies the contact requirement
3. **Wait through the 30-day dispute window** — if consumer disputes in writing within 30 days of validation notice, DRE cannot report until obtaining verification
## Texas Finance Code Requirements
### Scope: Consumer Debts Only
- § 392.001: "Consumer" = individual with consumer debt; "consumer debt" = primarily personal/family/household
- **Not applicable to B2B debts** (corporate debtors)
### § 392.101 — Surety Bond
- $10,000 bond on file with Texas SOS **before** engaging in debt collection
- Verify at: https://texas-sos.appianportalsgov.com/tpdc-public-search-portal
### § 392.202 — Dispute & Correction
When an individual disputes an item in DRE's files:
| Trigger | DRE's Obligation |
|---------|-----------------|
| Dispute received, DRE does NOT report to CRA | Cease collection until investigation done |
| Dispute received, DRE DOES report to CRA | Investigate + cease collection until investigation done |
**Response deadline:** Within 30 days → deny, admit, or request more time
**If more time needed:** Provisionally correct the file + send corrected reports + cease collection
**If admitting inaccuracy:** Correct within 5 business days + cease collection + notify prior recipients
### Penalties
| Violation | Penalty |
|-----------|---------|
| Ch. 392 violation | Misdemeanor ($100$500); actual damages + $100 minimum per viol. + attorney's fees |
| Ch. 392 violation = DTPA violation | Treble damages available under TX Bus. & Com. Code § 17 |
| No surety bond | Criminal offense (§ 392.402) + bond claim from consumer |
## Business Credit Bureaus (for B2B debts)
| Bureau | Key Product | How to Submit |
|--------|------------|--------------|
| **Dun & Bradstreet** | PAYDEX® Score (1100) | Global Trade Exchange — free to join, requires D-U-N-S Number |
| **Experian Business** | Intelliscore Plus (1100) | Data Furnisher Agreement |
| **Equifax Business** | Business Credit Risk Score | Data Furnisher Agreement |
**Benefits:** No FCRA/FDCPA restrictions, no 7-year limit, industry standard for B2B.
## Key Risk Areas
1. **Pre-reporting contact failure** — FDCPA violation (consumer debts only)
2. **Reporting before dispute resolved** — FDCPA "cease collection" includes credit reporting (CFPB interpretation)
3. **Inaccurate data without investigation** — FCRA § 1681s-2(b) private right of action
4. **Dispute investigation timeout** — 30 days from CRA notice; failure to investigate = lawsuit
5. **Texas Ch. 392 mismatch** — must follow both FCRA AND Texas parallel procedures. Texas has shorter timelines for correction (5 business days vs. 30 days under FCRA)
6. **Personal guarantee not documented** — no written guarantee = no permissible purpose to report against individual
7. **B2B debt reported to consumer CRA** — violates CRA contract + possible FCRA claim if individual's PII is attached without basis
## Citations
- 15 U.S.C. § 1681a(c) — "consumer" defined as individual
- 15 U.S.C. § 1681a(d) — "consumer report" defined
- 15 U.S.C. § 1681s-2 — Furnisher responsibilities
- 15 U.S.C. § 1692g — FDCPA validation notice
- 12 CFR Part 1006 — CFPB Debt Collection Rule
- Tex. Fin. Code § 392.001 — Definitions
- Tex. Fin. Code § 392.101 — Surety bond
- Tex. Fin. Code § 392.202 — File correction
- Tex. Fin. Code § 392.403 — Civil remedies
- Tex. Fin. Code § 392.404 — DTPA remedy
- FTC Advisory Opinion to Tatelbaum (2001) — Personal guarantor = permissible purpose
**Full report:** `/root/.hermes/references/dre-credit-reporting.md` (25.7KB, 10 sections)
@@ -0,0 +1,116 @@
# DRE Portal Technical Specifications
## Claim Numbering & Client IDs
| Type | Format | Example |
|---|---|---|
| Claim number | `DRE-YYYY-NNNN` | DRE-2026-0001 |
| Client ID | `CLT-YYYY-NNNN` | CLT-2026-0001 |
Both auto-generated on claim submission / account creation.
## Closed Case Binders
On case close, two PDF binders are auto-generated:
**Binder 1 — DRE Internal:** `DRE-YYYY-NNNN_CLOSED_DRE.pdf`
- Intake, evidence, AI claim analysis, AI debtor research, AI weakness analysis, internal notes, signed/notarized LPOA, certified mail receipts, communication log, settlement, fee disclosure, payment confirmation
**Binder 2 — Client Package:** `DRE-YYYY-NNNN_CLOSED_Client.pdf`
- Claim summary, signed/notarized LPOA, settlement/payment confirmation, fee statement
- **EXCLUDES:** AI analysis, debtor research, internal notes
**Evidence Archive:** `DRE-YYYY-NNNN_evidence.zip` — original uploaded documents
On case close, PDF text is extracted and stored in the database for full-text search. Future: Paperless-ngx if volume exceeds 500+ cases.
## Full 5-Phase Workflow
### Phase 1 — Intake
- Client submits claim at debtrecoveryexperts.com
- Form order: Your Info → Debtor Info → Claim Details → Documents
- reCAPTCHA verification before submit
- Terms of Service signed via DocuSeal
- Auto-generated claim number assigned
- Claim enters DRE queue
### Phase 2 — AI Review
- AI Claim Analysis (Claude Opus 4.7) → score + weakness report
- AI Debtor Research (ScrapingAnt + Sherlock) → skip tracing, LinkedIn, property records
- Texas Secretary of State business search (if debtor is a registered TX business) — scraped via ScrapingAnt
- Team reviews in DRE dashboard → Approve / Request More Docs / Reject
### Phase 3 — Legal Setup
- LPOA sent to client via DocuSeal
- Client signs → notarized via Proof (online RON)
- DRE now authorized to collect on client's behalf
### Phase 4 — Tiered Recovery
| Tier | Action | Timeline | DRE-led? |
|---|---|---|---|
| 1 | Soft Touch — email + ACH link | Day 1-5 | ✅ Yes |
| 2 | Formal Demand — certified mail via LetterStream | Day 7-14 | ✅ Yes |
| 2.5 | Lien Threat — pre-lien notice (construction claims) | Day 15-21 | ⚠️ Notice only; filing needs attorney |
| 3 | Escalation — final notice | Day 21-30 | ✅ Yes |
| 4 | Legal Action — referral to partner law firm | Day 30+ | ❌ Referral |
### Phase 5 — Settlement
- Payment collected via Stripe ACH
- DRE fee deducted per tier schedule
- Costs deducted (notary, certified mail, filing fees)
- Balance disbursed to client
- Case closed → two binders auto-generated
## Fee Structure
| Tier | DRE Fee | Client Gets |
|---|---|---|
| 1 — Soft Touch | 20-25% | 75-80% |
| 2 — Formal Demand | 30% | 70% |
| 2.5 — Lien Threat | 30% (+ attorney if filed) | 70% |
| 3 — Escalation | 33% | 67% |
| 4 — Legal Action | 10% DRE + 25% law firm | 65% |
Example for $15,000 claim:
- Tier 1: DRE $3,300 (22%) · Client $11,700
- Tier 2: DRE $4,500 (30%) · Client $10,500
- Tier 3: DRE $4,950 (33%) · Client $10,050
- Tier 4: DRE $1,500 + Firm $3,750 · Client $9,750
## Repeat Clients
- Account-based system with login
- ToS signed once, pre-filled info on new claims
- Dashboard: active cases (with tier progress indicator), past cases with outcomes, payment history
- Client can download their own case binders
- Optional loyalty pricing after 3+ claims
## Client Portal — Tier Progress Indicator
Visual 4-step progress bar in the active claim card:
- Each tier: numbered circle (green=complete, blue=current, gray=pending)
- Connecting lines between circles
- Label centered under each circle
- Text summary below: "✓ Tier 1 complete · Tier 2 in progress · Tier 3 pending · Tier 4 pending"
## Required Services (not yet configured)
| Service | Purpose | Status |
|---|---|---|
| Proof.com | Online notarization (LPOA) | ❌ Need account |
| LetterStream | Certified mail to debtor | ❌ Need account |
| Stripe Connect | ACH payments + disbursement | ❌ Need keys |
| Partner law firm | Litigation (Tier 4) | ❌ Need referral agreement |
| Google reCAPTCHA | Anti-spam on intake form | ❌ Need site key |
## Texas Secretary of State Integration
For debtor businesses registered in Texas, the AI Debtor Research step should scrape the TX SoS business search to retrieve:
- Business status (active/forfeited/dissolved)
- Registered agent name and address
- Filing date
- Annual report compliance status
- Officers/directors
This is an additional skip tracing layer that informs the debtor profile score.
@@ -0,0 +1,70 @@
# Texas Mechanic's Lien — Quick Reference
## Authority: Texas Property Code Chapter 53
## Who Can File
- **Original Contractor (GC):** Direct contract with owner — no pre-lien notice required
- **Subcontractor:** Hired by GC — must send pre-lien notice within 15 days
- **Material Supplier:** Must send notice if not under direct contract with owner
- **Laborer:** Eligible with simplified notice
- **Design Professional:** Architect/engineer — written notice required if not under direct contract
## Who CANNOT File
- Unlicensed contractors (Texas Occupations Code Ch. 1301/1305/1306)
- Remote suppliers (suppliers to suppliers — too far from the project)
- Finance-only parties (lenders, banks with no construction involvement)
## Critical Deadlines
| Role | File Lien By | Statute |
|------|-------------|---------|
| **GC** | 15th day of 4th month after month of completion | § 53.052 |
| **Sub/Supplier** | 15th day of 3rd month after month of completion | § 53.052 |
| **Foreclosure suit** | Within 1 year of last day to file | § 53.158 |
All deadlines count from MONTH of project completion, not day. Example: completion in March → GC deadline is July 15.
## Pre-Lien Notices
| Scenario | Deadline | Consequence if Missed |
|----------|----------|----------------------|
| Sub notice to owner (commercial) | Within 15 days of first furnishing | Lien limited to retainage |
| Sub monthly notice (residential) | By 15th of 2nd month after work month | Complete loss of lien rights |
| Notice of filed affidavit | Within 5 days of filing | Lien invalid against owner |
| Homestead written contract | Before work, signed by both spouses | Lien void |
## Homestead
- Art. XVI § 50 of Texas Constitution
- Written contract required, signed by both spouses
- Lien must state: "This is a lien on homestead"
- 3-year redemption period after foreclosure sale
- Avoid for claims under $25K
## No Lien on Public Projects
Use bond claims instead:
- **McGarr Act** (TX Gov't Code Ch. 2253): 90-day notice, 1-year suit
- **Miller Act** (40 USC §§ 31313134): federal projects
## FDCPA / DRE Restrictions
- **DRE cannot file liens directly** — UPL + FDCPA violation
- DRE can send pre-lien notices (factual, template-based, with Mini-Miranda)
- Actual lien filing requires licensed Texas construction attorney
- Wrongful lien damages: TX Prop. Code § 53.152 — actual + fees + up to $10K exemplary
## Tier 2.5 Workflow (DRE Recovery Progression)
1. **Phase A (DRE-led):** Pre-lien notice via certified mail to owner + GC + lender
2. **Phase B (Attorney-led):** Refer to construction attorney for lien affidavit filing
3. **Phase C (Monitor):** If no payment, escalate to foreclosure if claim ≥ $10K
## Minimum Thresholds
- Pre-lien notice: **$1,000**
- Lien filing: **$2,500**
- Foreclosure: **$10,000**
## Key Cases
| Case | Holding |
|------|---------|
| *First Nat'l Bank v. Whirlpool Corp.*, 517 S.W.2d 262 | Relation-back: lien priority dates to visible commencement of work |
| *McCollough v. Johnson, Rodenburg & Lauinger*, 637 F.3d 939 | FDCPA applies to time-barred debt threats |
| *H&M Steel, LLC v. HRR Asset Mgmt*, 2015 | Strict enforcement of lien deadlines |
**Full report:** `/root/Texas_Mechanics_Lien_Research_Report.md`
**Compliance manual section:** `DRE_Compliance_Manual.md` § 22 — Mechanic's Lien & Bond Claims (Tier 2.5)