Skip to main content

A docassemble extension to utilizing a multi-part interview to create either a 1) Legal, 2) Spanish, 3) FAST, or 4) BHA retainer

Project description

LAWV Retainer Agreement Interview

A Docassemble interview developed by Legal Aid of West Virginia to allow advocates to generate, sign, email, and receive signed retainer agreements from clients. This tool streamlines the process for English, Spanish, FAST, and BHA retainer workflows while ensuring compliance with Legal Aid protocols.

The interview guides advocates and clients through entering required information, reviewing the applicable retainer terms, signing electronically, and automatically distributing completed documents.


Purpose

This tool assists advocates in creating a complete and compliant retainer agreement for Legal Aid of West Virginia clients. It supports multiple program types, sends copies to all required parties, and facilitates digital signatures for both the advocate and the client.


Features

User-Facing Features

  • Advocate selects whether signing personally or preparing for another staff member
  • Guided entry of advocate, alternate advocate, client, and custodian (if applicable)
  • Client citizenship screening with Non‑Citizen Status Questionnaire prompt
  • Program‑specific retainer paths:
    • English Legal Retainer
    • Spanish Legal Retainer
    • FAST Advocate Retainer
    • BHA Advocate Retainer
  • Limited and extended scope options for English/Spanish legal retainers
  • FAST and BHA service‑level checklists
  • Client and advocate digital signatures
  • Automatic email delivery of signed forms
  • Ability for client to reject terms, generating notification back to LAWV

Technical Features

  • Uses docassemble.LAWVCommon for styling and shared utility functions
  • Multi‑party signature workflow (advocate → client)
  • Dynamic generation of the correct retainer PDF based on program type
  • Conditional logic managing:
    • Citizenship rules
    • Custodian behavior
    • Co‑representation disclosures
    • Opt‑out of “Use of Information” terms
  • Automatic notification emails using Docassemble templates
  • Separate email handling when the retainer is prepared on behalf of another advocate

File Information

This repository includes the primary Docassemble interview file:

  • retainer.yml — Full interview logic, screens, validations, signature workflow, and document assembly configuration.

The YAML references several templates that must be included in the Docassemble package:

  • lawv_retainer.pdf
  • lawv_retainer_spanish.pdf
  • fast.pdf
  • bha.pdf
  • Optional sample PDFs:
    • fast_sample.pdf
    • bha_sample.pdf
    • lawv_retainer_sample.pdf
    • lawv_retainer_spanish_sample.pdf
  • non_citizen_status_worksheet.pdf

Logic Overview

The interview performs the following key actions:

  1. Determines whether the advocate is signing personally or preparing the retainer for someone else
  2. Collects advocate, alternate advocate (if applicable), and client information
  3. Screens client for citizenship and presents the mandatory non‑citizen questionnaire when needed
  4. Prompts for retainer type:
    • English or Spanish Legal Retainer
    • FAST Retainer
    • BHA Retainer
  5. For legal retainers:
    • Captures scope: limited or extended
    • Provides detailed checklists or fields depending on scope
  6. For FAST and BHA:
    • Guides selection of service levels
    • Handles custodian rules for minors or protected persons
  7. Reviews and displays applicable terms, including required LAWV disclosures
  8. Captures advocate signature (typed or digital)
  9. Sends notification email to the client for their signature
  10. Validates client identity via birthdate challenge
  11. Presents the client with their portion of the retainer and signature options
  12. Sends completed documents to both client and advocate(s)
  13. Handles rejection pathways and notifies LAWV if terms are declined

Output

Depending on the type of retainer selected, the interview generates and emails:

  • A completed PDF retainer agreement
  • English and/or Spanish versions (for legal retainers)
  • FAST or BHA program‑specific PDF retainers
  • Copies automatically sent to the advocate, alternate advocate (if applicable), and the client

All personal information is purged once the interview is complete.


Contact

Created by Dane W. Henry, Esq. for Legal Aid of West Virginia.

More information about Legal Aid of West Virginia:
https://legalaidwv.org/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

docassemble_lawvretainer-2.0.3.tar.gz (4.2 MB view details)

Uploaded Source

File details

Details for the file docassemble_lawvretainer-2.0.3.tar.gz.

File metadata

File hashes

Hashes for docassemble_lawvretainer-2.0.3.tar.gz
Algorithm Hash digest
SHA256 cd09c64285cc45208958f8263f21fb435accea5c2e09a9918d83bbdd978b309a
MD5 9b46800e16242fb24fa95164fc47435d
BLAKE2b-256 28b143b116eb949164b3cc2da1a985082eb309daeace30bf0593e56e4cd3edb5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page