@kudusov.takhir/ba-toolkit 1.2.0

package/skills/references/domains/on-demand.md

@@ -0,0 +1,231 @@
+# Domain Reference: On-demand / Services Marketplace
+
+Domain-specific knowledge for on-demand and services marketplace projects: ride-hailing, food delivery, home services (cleaning, repairs, plumbing), task marketplace, beauty and wellness, pet care, freelance marketplaces, tutoring platforms.
+
+---
+
+## 1. /brief — Project Brief
+
+### Domain-specific interview questions
+- Service category: ride-hailing, home services, food delivery (logistics layer), freelance tasks, beauty/wellness, tutoring, pet care, other?
+- Supply side: vetted professionals (background-checked), open marketplace (self-registration), or employed staff?
+- Booking model: instant matching (like Uber), scheduled booking, or request/quote flow (provider proposes price)?
+- Pricing model: fixed pricing, dynamic/surge pricing, provider sets own price, auction/bidding?
+- Monetisation: commission on transaction, subscription for providers, booking fee, advertising?
+
+### Typical business goals
+- Minimise time-to-match between client request and provider acceptance.
+- Maximise provider utilisation and income (to retain supply side).
+- Build trust on both sides through reviews, verification, and dispute resolution.
+- Reduce cancellation rate and no-show incidents.
+- Expand to new service categories or cities with minimal operational overhead.
+
+### Typical risks
+- Supply-demand imbalance in specific geographies or time slots.
+- Provider quality inconsistency — reputational risk.
+- Safety incidents: background checks, insurance, liability.
+- Payment disputes and fraudulent bookings.
+- Regulatory: gig worker classification laws (employee vs. contractor), local licensing for some services (electricians, doctors).
+
+---
+
+## 2. /srs — Requirements Specification
+
+### Domain-specific interview questions
+- Roles: client (requester), service provider (executor), admin, support agent?
+- Provider onboarding: self-registration with document upload, background check, manual approval?
+- Search and matching: geo-based search radius, category/skill filter, availability calendar?
+- Booking flow: instant-book or request-and-confirm (provider must accept)?
+- Payment timing: pre-authorisation at booking, charge on completion, or subscription?
+- Cancellation policy: free cancellation window, cancellation fee after window, provider cancellation penalties?
+- Reviews: two-sided (client reviews provider, provider reviews client)?
+- Dispute resolution: automated or support-agent workflow?
+
+### Typical functional areas
+- Provider discovery (search, filter by category, location, availability, rating).
+- Provider profile (bio, services offered, pricing, portfolio, reviews, availability).
+- Booking / request flow (service selection, date/time, address, notes, payment).
+- Real-time provider tracking (ride-hailing, delivery sub-category).
+- In-app messaging between client and provider.
+- Payment processing (charge, split, payout to provider).
+- Reviews and ratings (two-sided, moderated).
+- Provider onboarding (registration, document verification, background check).
+- Provider scheduling and availability management.
+- Notifications (booking confirmed, provider en-route, service started, completed, payment receipt).
+- Cancellation and refund handling.
+- Dispute management.
+- Admin panel (provider management, booking management, payouts, reports).
+- Promotions and referral programmes.
+
+---
+
+## 3. /stories — User Stories
+
+### Domain-specific interview questions
+- Critical client flows: search provider, book service, track/await provider, pay, leave review?
+- Critical provider flows: receive and accept booking, navigate to client, complete service, receive payout?
+- Admin flows: approve provider, handle dispute, issue refund, suspend account?
+
+### Typical epics
+- Provider Discovery and Search.
+- Provider Profile.
+- Booking and Request Flow.
+- Real-time Tracking (if applicable).
+- In-app Messaging.
+- Payment, Pricing, and Payouts.
+- Reviews and Ratings.
+- Provider Onboarding and Verification.
+- Availability and Scheduling.
+- Notifications.
+- Cancellations and Refunds.
+- Dispute Resolution.
+- Promotions and Referrals.
+- Admin and Operations.
+
+---
+
+## 4. /usecases — Use Cases
+
+### Domain-specific interview questions
+- Matching failure: no provider available in area or time slot — what is the fallback?
+- Provider no-show: how is client compensated? How is provider penalised?
+- Safety incident: how does the client report a safety concern during a service?
+- Payment failure: booking confirmed but payment fails on completion — recovery flow?
+
+### Typical exceptional flows
+- No provider available in search radius — widen radius suggestion, notify client when availability opens.
+- Provider declines booking — auto-reassign to next match or return booking to pool.
+- Provider no-show — client notification, automatic refund or rebooking credit, provider penalty.
+- Client cancels after provider en-route — cancellation fee applied, provider compensated.
+- Payment fails on service completion — retry flow, provider payout held until resolution.
+- Dispute raised post-service — freeze review period, support agent reviews evidence, resolution applied.
+- Background check fails during onboarding — provider rejected, notification with appeal option.
+
+---
+
+## 5. /ac — Acceptance Criteria
+
+### Domain-specific interview questions
+- Matching SLA: maximum acceptable time from booking to provider assignment?
+- Cancellation window: exact duration of free cancellation period?
+- Review window: how long after service completion can client and provider leave reviews?
+- Payout schedule: when are funds released to provider after service completion?
+- Refund rules: full/partial refund — under what conditions?
+
+---
+
+## 6. /nfr — Non-functional Requirements
+
+### Domain-specific interview questions
+- Geographic scope: city, national, international — impacts map provider and localisation requirements.
+- Concurrent bookings at peak: expected simultaneous active bookings?
+- Matching latency requirement: how quickly must a match be made (for instant-book models)?
+- Offline-first provider app: must the provider app work with intermittent connectivity?
+
+### Mandatory NFR categories for On-demand
+- **Matching Performance:** Provider matching must return results within 3s. For instant-match models, provider assignment must complete within 5s of client confirmation.
+- **Real-time Tracking:** Location update interval ≤ 10s for active bookings. Client tracking page reflects provider position within 15s.
+- **Scalability:** System must handle 5× peak load during demand surges (events, holidays) without degradation.
+- **Payment Reliability:** Payment processing failure rate < 0.1%. All payment events idempotent — no double charges on retries.
+- **Availability:** Booking and matching service: 99.9% SLA. Provider app backend: 99.9%.
+- **Security:** Payment instrument data never stored server-side — tokenised via payment provider. Provider documents stored in private object storage.
+- **Trust & Safety:** Review moderation response within 24 hours of report. Suspicious account activity triggers automated review within 1 hour.
+- **Regulatory:** Gig worker classification compliance per jurisdiction (inform legal). Service-specific licence verification where legally required (medical, electrical, etc.).
+
+---
+
+## 7. /datadict — Data Dictionary
+
+### Domain-specific interview questions
+- User model: are client and provider the same user model (switching roles) or separate entities?
+- Booking state machine: what is the full lifecycle of a booking (requested → accepted → in-progress → completed / cancelled)?
+- Payout: is payout calculated per booking or batched weekly/monthly?
+- Location: is provider location tracked only during active bookings, or continuously while on-duty?
+
+### Mandatory entities for On-demand
+- **User** — unified account: name, contact, profile photo, role flags (isClient, isProvider), verification status.
+- **ProviderProfile** — professional profile: services offered, bio, hourly rate or price list, portfolio, average rating, onboarding status.
+- **ProviderDocument** — verification documents: type (ID, licence, certificate), upload, review status.
+- **ServiceCategory** — taxonomy of services offered on the platform.
+- **Availability** — provider schedule: recurring rules (Mon–Fri 9–18) and exceptions (holidays, blocked slots).
+- **Booking** — service request: client, provider, service, date/time, address, status lifecycle, price breakdown.
+- **BookingMessage** — in-booking chat: sender, content, timestamp.
+- **Payment** — booking payment: amount, fee breakdown (client charge, platform commission, provider earning), status.
+- **Payout** — provider payout: amount, bookings included, payout method, status, scheduled date.
+- **Review** — two-sided: reviewer, reviewee, booking reference, rating (1–5), text, response, moderation status.
+- **Dispute** — booking dispute: raised by, reason, evidence, status, resolution, support agent.
+- **Promotion** — discount or referral: type, value, conditions, usage count, expiry.
+- **Notification** — channel (push, SMS, email), event type, status.
+- **Location** — provider real-time location: lat, lon, timestamp, accuracy (stored only during active booking unless consented otherwise).
+
+---
+
+## 8. /apicontract — API Contract
+
+### Domain-specific interview questions
+- Webhooks: booking status changes to third-party integrators? Provider payout processing notification?
+- Real-time: messaging and tracking via WebSocket or long-polling?
+- Maps and geocoding: provider — which map SDK for provider navigation (Google Maps, Apple Maps, Mapbox)?
+
+### Typical endpoint groups
+- **Search & Discovery** — search providers by category, location, date/time, rating, price.
+- **Provider Profile** — get profile, get reviews, get availability, get pricing.
+- **Booking** — create booking (request or instant), confirm, start service, complete service, cancel.
+- **Tracking** — get live provider location for active booking.
+- **Messaging** — get conversation, send message (REST + WebSocket channel).
+- **Payments** — create payment intent, confirm charge, get payment breakdown.
+- **Payouts** — get payout history, trigger manual payout (admin), update payout method.
+- **Reviews** — submit review, get reviews for provider/client, report review.
+- **Provider Onboarding** — submit profile, upload document, get onboarding status.
+- **Availability** — get calendar, set recurring schedule, block slots.
+- **Disputes** — create dispute, submit evidence, get status, resolve (admin).
+- **Promotions** — apply promo code, get referral link, get eligible promotions.
+- **Notifications** — get preferences, update preferences, get history.
+- **Admin** — provider approval, account suspension, refund override, reports.
+
+---
+
+## 9. /wireframes — Wireframe Descriptions
+
+### Domain-specific interview questions
+- Home screen for client: search-first (like Uber), category browse (like UrbanClapper), or personalised feed?
+- Provider view: simple schedule and booking list, or full business management dashboard?
+- Mobile-first or web + mobile?
+
+### Typical screens
+- **Client Home** — category grid or search bar, nearby providers, recent bookings, promotions.
+- **Search Results** — provider cards (photo, rating, price, distance), filters, map toggle.
+- **Provider Profile** — hero photo, bio, services and prices, availability, reviews, book button.
+- **Booking Flow** — service selection → date/time picker → address → booking summary → payment.
+- **Active Booking / Tracking** — provider location on map, ETA, messaging button, status banner.
+- **Booking Detail** — service summary, provider info, timeline, payment receipt, review prompt.
+- **Review Screen** — star rating, text input, optional photo, submit.
+- **Client Bookings History** — upcoming and past bookings, quick rebook action.
+- **Provider — Schedule View** — day/week calendar, upcoming bookings, availability blocks.
+- **Provider — Booking Request** — client info, service details, accept/decline buttons.
+- **Provider — Earnings** — payout history, pending earnings, bank account management.
+- **Dispute Screen** — booking reference, reason selection, evidence upload, submit.
+- **Admin — Provider Management** — pending approvals, active providers, suspension controls.
+
+---
+
+## Domain Glossary
+
+| Term | Definition |
+|------|-----------|
+| Supply side | Providers, drivers, freelancers — the entities who perform services |
+| Demand side | Clients or customers — the entities who request services |
+| Matching | Algorithm that connects a demand-side request to a supply-side provider |
+| Instant booking | Booking confirmed automatically without provider manual acceptance |
+| Request flow | Client submits a request; provider explicitly accepts or declines |
+| Surge pricing | Dynamic price increase during periods of high demand |
+| Gig worker | Independent contractor who provides services via a platform |
+| Utilisation rate | Percentage of provider's available time that is booked |
+| Cancellation rate | Percentage of bookings cancelled (by either side) |
+| Commission | Platform's fee taken from each transaction (percentage of booking value) |
+| Payout | Transfer of earned funds from platform to provider |
+| Escrow | Platform holds payment from client until service completion, then releases to provider |
+| Two-sided review | Both client and provider can rate each other after a booking |
+| Background check | Third-party verification of a provider's criminal record and identity |
+| Onboarding | Process for new providers to register, verify documents, and be approved |
+| Referral | Incentive programme where existing users recruit new users |

package/skills/references/domains/real-estate.md

@@ -0,0 +1,241 @@
+# Domain Reference: Real Estate
+
+Domain-specific knowledge for real estate projects: property listing portals, agency CRM systems, rental management platforms, property management tools (landlord/tenant), mortgage broker and comparison tools, short-term rental platforms (vacation), commercial real estate platforms.
+
+---
+
+## 1. /brief — Project Brief
+
+### Domain-specific interview questions
+- Product type: property listing portal (Zillow/Rightmove model), agency CRM, rental management, property management (long-term), short-term rental (Airbnb model), mortgage comparison, commercial RE?
+- Target market: residential sale, residential rental, commercial, or all?
+- Geographic scope: city, national, cross-border — impacts currency, legal documents, and property law?
+- Primary roles served: buyers/renters, sellers/landlords, agents/brokers, property managers, mortgage advisors?
+- Monetisation: agent subscription, listing fee, lead generation (pay-per-enquiry), transaction commission, SaaS for property managers?
+
+### Typical business goals
+- Increase enquiry-to-viewing conversion rate.
+- Reduce time-to-let or time-to-sale.
+- Increase agent productivity (fewer manual tasks, more managed properties per agent).
+- Build buyer/renter trust through accurate, up-to-date listings and verified information.
+- Generate qualified leads for agents or mortgage brokers.
+
+### Typical risks
+- Listing data quality: stale listings, inaccurate prices, incorrect availability.
+- Regulatory compliance: property law differs significantly by jurisdiction (deposit caps, eviction process, mandatory disclosures).
+- Data privacy: collecting financial details, tenancy references, right-to-rent checks.
+- Agent resistance to adopting new CRM if it replaces established tools.
+- Fraud: fake listings, fake buyers/tenants.
+
+---
+
+## 2. /srs — Requirements Specification
+
+### Domain-specific interview questions
+- Roles: buyer/renter, seller/landlord, agent/negotiator, property manager, mortgage advisor, admin?
+- Property data: own listings database or data feed from MLS/portals (RETS, RESO Web API)?
+- Search and filtering: location (map-based), price range, property type, bedrooms, amenities?
+- Enquiry management: contact form, in-app messaging, phone click-to-reveal?
+- Viewing management: online booking, calendar sync with agent's calendar, confirmation and reminder flow?
+- Tenancy workflow: application, referencing, tenancy agreement (digital signing), inventory, move-in, deposit, maintenance, move-out?
+- Financial features: rent collection, maintenance charge management, statement generation?
+- Valuation: instant automated valuation (AVM), request for agent valuation?
+
+### Typical functional areas
+- Property listing (creation, editing, photos, floor plan, EPC/energy rating, status management).
+- Search and discovery (geo-search with map, filters, saved searches, alerts).
+- Property detail page.
+- Enquiry / lead capture.
+- Viewing booking and management.
+- Offer management (sale): submission, negotiation history, acceptance.
+- Tenancy application and referencing.
+- Digital tenancy agreement signing.
+- Tenancy management (rent schedule, deposit, maintenance requests).
+- Agent CRM: lead pipeline, contact management, property portfolio, task management.
+- Mortgage tools: affordability calculator, lender comparison, broker enquiry.
+- Notifications (new listing matching saved search, viewing reminders, rent due).
+- Admin: user management, listing moderation, reporting.
+
+---
+
+## 3. /stories — User Stories
+
+### Domain-specific interview questions
+- Critical buyer/renter flows: search → save listing → book viewing → submit offer or application?
+- Critical agent flows: create listing → manage enquiries → confirm viewing → log offer?
+- Tenancy flows: receive application → run reference check → issue agreement → manage rent?
+
+### Typical epics
+- Property Search and Discovery.
+- Property Listing Management (agent/landlord).
+- Enquiry and Lead Management.
+- Viewing Booking and Management.
+- Offer Management (for sale).
+- Tenancy Application and Referencing.
+- Tenancy Agreement (Digital Signing).
+- Tenancy Management (Rent, Deposit, Maintenance).
+- Agent CRM and Pipeline.
+- Saved Searches and Alerts.
+- Mortgage Calculators and Broker Tools.
+- Notifications.
+- Admin and Moderation.
+
+---
+
+## 4. /usecases — Use Cases
+
+### Domain-specific interview questions
+- Listing status changes: what triggers a property to be marked "Under Offer" or "Let Agreed" automatically vs. manually?
+- Reference failure: applicant fails referencing — what are the next steps (guarantor, deposit top-up, rejection)?
+- Gazumping (UK): a higher offer is accepted after a previous offer was agreed — how is this handled?
+- Maintenance emergency: tenant reports an emergency (flooding, no heating) — escalation process?
+
+### Typical exceptional flows
+- Property listed with incorrect price — agent corrects listing, saved-search alert not sent for correction to avoid spam.
+- Viewing no-show (tenant/buyer) — slot marked as no-show, agent notified, rebook offered.
+- Applicant fails referencing — system notifies landlord/agent, applicant informed with reason category (not detailed), appeal/alternative route offered.
+- Digital signature link expires — resend triggered with new expiry, audit trail retained.
+- Rent payment missed — day-1 automatic notification to landlord/property manager, escalation workflow initiated.
+- Maintenance request not acknowledged within SLA — escalation to property manager supervisor.
+
+---
+
+## 5. /ac — Acceptance Criteria
+
+### Domain-specific interview questions
+- Search freshness: within how many minutes of a listing going live must it appear in search results?
+- Saved search alerts: maximum latency from listing match to notification delivered to user?
+- Viewing booking: what are the confirmation rules — instant confirm or pending agent approval?
+- Deposit protection: must the system record deposit protection scheme registration number and provider?
+- Digital signature: what signature standard is required (e-signature legally binding in jurisdiction)?
+
+---
+
+## 6. /nfr — Non-functional Requirements
+
+### Domain-specific interview questions
+- Listing volume: how many active properties on the platform at launch and at scale?
+- Map provider: Google Maps Platform, Mapbox, or OS Maps (UK)? Any cost sensitivity?
+- Property photo storage: volume of photos per listing, total storage estimate?
+- GDPR / data privacy: are applicant references (financial data) processed on-platform or via third-party referencing provider?
+
+### Mandatory NFR categories for Real Estate
+- **Search Performance:** Property search results returned within 1.5s including geo-filter. Map layer with property pins rendered within 2s for ≤500 visible markers.
+- **Listing Freshness:** New listings indexed and searchable within 5 minutes of publication. Status changes (let agreed, sold) reflected in search within 2 minutes.
+- **Photo and Media:** Property photos served via CDN. Listing page with 20 photos must load full page within 3s on standard broadband. Images auto-compressed and WebP-converted on upload.
+- **Availability:** Search and property detail: 99.9% SLA. Tenancy management (rent collection): 99.9%. Agent CRM: 99.5%.
+- **Security:** Applicant financial data (referencing) encrypted at rest. Right-to-rent documents stored in private object storage with access log. PII masked in exported reports.
+- **Compliance:** Tenancy deposits must record statutory protection scheme details. Mandatory property disclosure fields enforced per jurisdiction (EPC, gas safety, electrical certificate). Consent obtained for marketing communications (GDPR).
+- **Accessibility:** WCAG 2.1 AA for search, listing detail, and application forms. Map must have non-map fallback view.
+- **Mobile:** Property search and detail pages fully functional on mobile (responsive or native app). Agent CRM must be usable on tablet.
+
+---
+
+## 7. /datadict — Data Dictionary
+
+### Domain-specific interview questions
+- Property vs. listing: is a property a permanent entity (with history across multiple listings), or does each listing stand alone?
+- Offer model: is an offer a separate entity (multiple offers on one property), or a field on the property?
+- Tenancy: single entity or split into Application → Agreement → ActiveTenancy → ClosedTenancy?
+- Media: are floor plans, EPCs, and virtual tours stored as separate media types from photos?
+
+### Mandatory entities for Real Estate
+- **Property** — physical asset: address (structured), type (flat, house, land, commercial), bedrooms, bathrooms, size (m²/sqft), EPC rating, geo-coordinates.
+- **Listing** — active marketing record: property reference, type (sale or rental), asking price or rent, status (active, under offer, sold/let, withdrawn), agent, published date, description, features.
+- **Media** — asset: type (photo, floor plan, EPC certificate, virtual tour, video), URL, CDN path, display order.
+- **Agent** — individual negotiator: name, email, phone, agency, active listing count.
+- **Agency** — brokerage: name, address, logo, subscription plan, agents.
+- **Enquiry** — lead: prospective buyer/renter, listing, message, channel, status (new, contacted, viewing booked, closed).
+- **ViewingSlot** — available viewing time: listing, datetime, duration, booked flag.
+- **Viewing** — booked viewing: slot, attendee (prospective buyer/renter), status (confirmed, completed, no-show, cancelled), notes.
+- **Offer** _(sale)_ — submitted offer: listing, buyer, amount, conditions, status (submitted, under review, accepted, rejected, withdrawn).
+- **TenancyApplication** — rental application: listing, applicant(s), move-in date, tenancy term, status.
+- **ReferenceCheck** — referencing result: applicant, type (employment, landlord, credit), provider, status (pending, passed, failed), report URL.
+- **TenancyAgreement** — legal document: application, property, parties, term dates, rent amount, deposit amount, signature status, signed document URL.
+- **Tenancy** — active tenancy: agreement, status (active, ended), renewal count.
+- **RentSchedule** — rent payment plan: tenancy, amount, frequency, next due date.
+- **RentPayment** — individual rent transaction: tenancy, amount, due date, paid date, status, payment method.
+- **Deposit** — tenancy deposit: tenancy, amount, protection scheme, scheme registration number, release status.
+- **MaintenanceRequest** — repair request: tenancy, description, priority (emergency, urgent, routine), photos, status, assigned contractor.
+- **SavedSearch** — user's search criteria saved for alerts: user, filters, alert frequency.
+- **Mortgage** _(if applicable)_ — mortgage enquiry or saved calculation: applicant, property value, deposit, term, estimated monthly payment.
+
+---
+
+## 8. /apicontract — API Contract
+
+### Domain-specific interview questions
+- Data feed integration: does the platform need to ingest listings via RETS or RESO Web API from MLS or other portals?
+- Webhooks: new listing matching saved search triggers notification? Rent payment received triggers landlord notification?
+- Digital signature: integrated e-signature API (DocuSign, Adobe Sign, HelloSign)?
+- Payment processing: rent collection via direct debit (GoCardless) or card?
+
+### Typical endpoint groups
+- **Listings** — search (with geo-filter), get detail, create, update, change status.
+- **Properties** — create property, get property history, get all listings for property.
+- **Media** — get upload URL, confirm upload, reorder, delete.
+- **Enquiries** — submit enquiry, get enquiries (agent view), update status.
+- **Viewings** — get available slots, book viewing, confirm, cancel, record outcome.
+- **Offers** _(sale)_ — submit offer, counter-offer, accept, reject, withdraw.
+- **Tenancy Applications** — submit application, get status, upload document.
+- **Reference Checks** — initiate check, get status (webhook callback from provider).
+- **Tenancy Agreements** — generate draft, send for signature, get signature status, get signed document.
+- **Rent** — get schedule, record payment (webhook from payment provider), get arrears.
+- **Maintenance** — submit request, update status, assign contractor, upload photo.
+- **Saved Searches** — create, list, update, delete.
+- **Alerts** — get notification history.
+- **Mortgage** — calculate affordability, submit broker enquiry.
+- **Admin** — listing moderation, user management, agency management.
+- **Webhooks** — listing status change, saved search match, rent payment received, signature completed.
+
+---
+
+## 9. /wireframes — Wireframe Descriptions
+
+### Domain-specific interview questions
+- Search experience: map-first (like Rightmove) or list-first with map toggle?
+- Agent CRM: web-only, or must work on mobile tablet for valuations?
+- Tenancy management: tenant-facing portal separate from landlord/property manager interface?
+
+### Typical screens
+- **Property Search — List View** — filter bar, property cards (photo, price, key details, save), sort, pagination.
+- **Property Search — Map View** — interactive map with property pins, price labels, sidebar with results list.
+- **Property Detail Page** — photo gallery, key details (price, bedrooms, size, EPC), description, floor plan, virtual tour, agent contact, book viewing button, map.
+- **Viewing Booking** — available slot calendar, select slot, confirm details, confirmation screen.
+- **Saved Searches** — list of saved searches with alert settings, recent matches preview.
+- **Tenancy Application Form** — applicant details, co-applicant, employment information, references, document upload.
+- **Tenant Portal — Dashboard** — rent status, next payment date, maintenance requests, tenancy documents.
+- **Tenant Portal — Maintenance** — request form (description, priority, photo upload), request history.
+- **Landlord / Property Manager Dashboard** — properties overview, rent arrears alerts, maintenance queue, tenancy renewals.
+- **Agent CRM — Pipeline** — leads by stage (Kanban or list), follow-up tasks, today's viewings.
+- **Agent CRM — Listing Editor** — property details form, photo upload, description, pricing, publish controls.
+- **Offer Management** _(sale)_ — offer list for property, amount, status, accept/reject/counter.
+- **Tenancy Agreement** — document preview with all fields, sign button, signatory status indicators.
+- **Mortgage Calculator** _(if applicable)_ — inputs (price, deposit, term, rate type), monthly payment output, lender comparison table.
+
+---
+
+## Domain Glossary
+
+| Term | Definition |
+|------|-----------|
+| MLS | Multiple Listing Service — database of property listings shared among agents |
+| RESO | Real Estate Standards Organisation — defines data standards for property data exchange |
+| EPC | Energy Performance Certificate — mandatory energy efficiency rating in many jurisdictions |
+| Conveyancing | Legal process of transferring property ownership |
+| Gazumping | When a seller accepts a higher offer after already accepting a lower one |
+| Under Offer | Property where an offer has been made and accepted (sale not yet complete) |
+| Let Agreed | Property where a tenancy has been agreed but not yet started |
+| Stamp Duty | UK property purchase tax (equivalent: transfer tax in US) |
+| AVM | Automated Valuation Model — algorithm-based property price estimate |
+| Yield | Annual rental income as percentage of property value (used by investors) |
+| Cap Rate | Capitalisation Rate — net operating income / property value (commercial RE) |
+| LTV | Loan-to-Value ratio — mortgage amount as percentage of property value |
+| Deposit protection | Legally required scheme to protect tenant deposits (UK: TDS, DPS, myDeposits) |
+| Right to rent | UK legal requirement to verify tenant's right to reside in the country |
+| Referencing | Background check on prospective tenant (employment, credit, previous landlord) |
+| Guarantor | Third party who agrees to cover rent if tenant defaults |
+| Leasehold | Property ownership where land is owned by freeholder for a fixed term |
+| Freehold | Outright ownership of land and property |
+| Service charge | Fee paid by leaseholders for maintenance of shared building areas |
+| Ground rent | Annual payment by leaseholder to freeholder |

package/skills/references/domains/saas.md

@@ -0,0 +1,185 @@
+# Domain Reference: SaaS
+
+Domain-specific knowledge for SaaS projects: B2B platforms, CRM, project management tools, analytics dashboards, service marketplaces, no-code/low-code platforms, EdTech, HRTech.
+
+---
+
+## 1. /brief — Project Brief
+
+### Domain-specific interview questions
+- Product type: B2B platform, CRM, project management tool, analytics platform, marketplace, EdTech/LMS, HRTech, no-code builder?
+- Monetization model: subscription (monthly/annual), freemium, per-seat, usage-based, enterprise licensing?
+- Target segment: SMB (Small-Medium Business), mid-market, enterprise?
+
+### Typical business goals
+- Grow MRR/ARR (Monthly/Annual Recurring Revenue).
+- Reduce churn rate.
+- Increase NRR (Net Revenue Retention) through upsell.
+- Enter the enterprise segment.
+- Product-led growth through freemium.
+- Reduce CAC (Customer Acquisition Cost).
+
+### Typical risks
+- High churn in the first 90 days.
+- Competition from enterprise solutions (Salesforce, SAP, Oracle).
+- Insufficient scalability of multi-tenant architecture.
+- Data residency — data localization requirements.
+
+---
+
+## 2. /srs — Requirements Specification
+
+### Domain-specific interview questions
+- Roles: end user, team admin, workspace owner, billing admin, superadmin, guest/viewer?
+- Multi-tenancy: shared database, schema-per-tenant, database-per-tenant?
+- Integrations: SSO (SAML, OIDC), Zapier/Make, Slack, calendar (Google/Outlook), CRM, billing (Stripe, Chargebee)?
+- RBAC (Role-Based Access Control): preset roles or custom?
+- Compliance: SOC 2, GDPR, HIPAA (if healthcare), ISO 27001?
+
+### Typical functional areas
+- Onboarding (workspace creation, member invitation, guided setup).
+- Workspace/organization management (settings, billing, members).
+- Core product functionality (depends on product type).
+- Collaboration (comments, mentions, real-time editing, activity feed).
+- Integrations and API.
+- Settings and customization.
+- Billing and subscriptions.
+- Analytics and reporting.
+
+---
+
+## 3. /stories — User Stories
+
+### Domain-specific interview questions
+- Critical user flows: first launch (FTUE — First Time User Experience), team invitation, core product action, plan upgrade, integration setup?
+- Edge cases: plan limit exceeded, downgrade with data loss, concurrent editing, workspace deletion with active subscription?
+- Personas: solo founder, team lead, enterprise IT admin, invited member?
+
+### Typical epics
+- Onboarding and FTUE.
+- Workspace management.
+- Core functionality (core feature set).
+- Collaboration.
+- Integrations.
+- Billing and plans.
+- Settings and customization.
+- Administration (superadmin).
+
+---
+
+## 4. /usecases — Use Cases
+
+### Domain-specific interview questions
+- Critical alternative flows: plan limit exceeded, subscription expired, access revoked, merge conflict during concurrent editing?
+- System actors: Stripe/billing provider, SSO provider (Okta, Azure AD), email service, Zapier webhook?
+
+### Typical exceptional flows
+- Subscription payment failure (card declined).
+- SSO provider unavailable.
+- API rate limit exceeded.
+- Data conflict during concurrent editing.
+- Cannot downgrade due to new plan limits exceeded.
+
+---
+
+## 5. /ac — Acceptance Criteria
+
+### Domain-specific interview questions
+- Business rules: plan limits (member count, storage, API calls), trial period, grace period for overdue payment?
+- Boundary values: max file size, max record count, API timeout, trial length?
+
+---
+
+## 6. /nfr — Non-functional Requirements
+
+### Domain-specific interview questions
+- Multi-tenancy: data isolation between tenants, noisy neighbor protection?
+- Target metrics: TTFB (Time to First Byte), API latency (p95), uptime?
+- Scaling: expected tenant count, users per tenant, concurrent editors?
+
+### Mandatory NFR categories for SaaS
+- **Performance:** API latency < 200ms (p95), TTFB < 500ms, page load < 3s.
+- **Scalability:** horizontal scaling, tenant isolation, noisy neighbor prevention.
+- **Security:** SOC 2 Type II compliance, data encryption at-rest (AES-256) and in-transit (TLS 1.2+), SSO/SAML support.
+- **Availability:** SLA 99.9% (standard), 99.95% (enterprise), status page.
+- **Data residency:** storage region selection (EU, US, APAC).
+- **Backup:** RPO < 1 hour, RTO < 4 hours, point-in-time recovery.
+
+---
+
+## 7. /datadict — Data Dictionary
+
+### Domain-specific interview questions
+- Multi-tenancy: tenant_id as a mandatory field in all entities?
+- Soft delete: which entities support recovery (trash/archive)?
+
+### Mandatory entities for SaaS
+- **Organization / Workspace** — tenant: name, plan, settings, limits.
+- **User** — user: email, role, status, organization membership.
+- **Membership** — user ↔ organization link: role, permissions, invitation date.
+- **Subscription** — subscription: plan, status, period, billing provider ID.
+- **Plan** — pricing plan: name, limits, price, features.
+- **Invoice** — invoice: amount, status, period, PDF.
+- **AuditLog** — action log: event, actor, timestamp, tenant_id.
+- **Integration** — connected integrations: type, credentials (encrypted), status.
+- **ApiKey** — API keys: hash, scopes, last used, expiry.
+
+---
+
+## 8. /apicontract — API Contract
+
+### Domain-specific interview questions
+- Public API: needed for third-party integrations? Rate limiting policy?
+- Webhook contracts: events for API subscribers (resource created/updated/deleted)?
+- Authentication: API Key for machine-to-machine, OAuth2 for users, SAML/OIDC for SSO?
+
+### Typical endpoint groups
+- Auth (registration, login, SSO, API keys).
+- Organizations (CRUD, members, settings).
+- Core resources (depends on product).
+- Billing (plans, subscriptions, invoices).
+- Integrations (connection, configuration, webhooks).
+- Admin (superadmin: tenants, metrics, feature flags).
+- Webhooks (outgoing events for subscribers).
+
+---
+
+## 9. /wireframes — Wireframe Descriptions
+
+### Domain-specific interview questions
+- Key screens: dashboard, main workspace screen, workspace settings, billing, member invitation?
+- Specific states: trial expired, plan limit reached, account suspended, empty workspace?
+
+### Typical screens
+- Onboarding (workspace creation, guided setup, team invitation).
+- Dashboard (activity overview, key metrics, quick actions).
+- Main workspace screen (depends on product).
+- Workspace settings (general, members, roles, integrations).
+- Billing (current plan, usage, invoices, upgrade/downgrade).
+- User profile (data, security, notifications).
+- Superadmin (tenants, metrics, feature flags).
+
+---
+
+## Domain Glossary
+
+| Term | Definition |
+|------|-----------|
+| MRR | Monthly Recurring Revenue |
+| ARR | Annual Recurring Revenue |
+| NRR | Net Revenue Retention — including upsell and churn |
+| CAC | Customer Acquisition Cost |
+| LTV | Lifetime Value — total revenue from a customer |
+| Churn rate | Customer attrition rate |
+| FTUE | First Time User Experience |
+| Multi-tenancy | Architecture with data isolation between customers |
+| SSO | Single Sign-On |
+| SAML | Security Assertion Markup Language — SSO protocol |
+| OIDC | OpenID Connect — authentication protocol over OAuth2 |
+| RBAC | Role-Based Access Control |
+| SOC 2 | Service Organization Control 2 — security audit standard for SaaS |
+| TTFB | Time to First Byte |
+| Noisy neighbor | One tenant affecting another's performance |
+| Feature flag | Mechanism to enable/disable functionality without deployment |
+| Freemium | Monetization model: free base plan + paid upgrades |
+| Per-seat pricing | Pricing model: payment per user |