jackdaw/README.md

48 lines
2.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Jackdaw — Rental & Housing Applications
> *Part of the Circuit Forge LLC "AI for the tasks you hate most" suite.*
**Status:** Backlog — not yet started. Peregrine must prove the model first.
## What it does
Jackdaw monitors rental listings, auto-applies to matching properties, generates personalized cover letters for competitive markets, tracks application responses, and flags lease red flags before signing.
The name fits: jackdaws are urban, clever, and highly adaptive — they find shelter in the gaps of built environments (chimneys, wall cavities, building eaves) and fiercely defend their chosen spots. The same tenacity a renter needs in a competitive market.
## Why it's hard
The rental market is brutal:
- Competitive markets have listings gone in hours — you need to be first
- Landlords receive 50+ applications; a personal cover letter differentiates
- Lease agreements are long, legally dense, and full of gotchas
- Application fees ($30$75 each) make spray-and-pray expensive
## Core pipeline
```
Configure preferences (budget, location, size, pet policy, etc.)
→ Monitor listings (Zillow, Craigslist, Apartments.com, local boards)
→ Score match against profile → Human approve targets
→ AI draft rental cover letter → Submit application
→ Track responses → AI-assisted lease review before signing
```
## Key differentiators vs. Peregrine
- Listing freshness is critical — polling interval matters more than job search
- Cover letter is tenant-to-landlord vs. candidate-to-employer (different voice)
- Lease review: clause flagging (automatic renewal, landlord entry, fee escalation)
- Application fee tracking: know what you've spent per search
## Product code (license key)
`CFG-JKDW-XXXX-XXXX-XXXX`
## Tech notes
- Shared `circuitforge-core` scaffold
- Scrapers: Zillow, Apartments.com, Craigslist, Facebook Marketplace listings
- Lease review: pdfplumber + LLM clause analysis with red-flag taxonomy
- Application form auto-fill: Playwright for common application portals
- Fine-tunable cover letter model (same pipeline as Peregrine, different persona)