These are the kinds of artifacts I produce. Business cases, architecture decisions, compliance frameworks, process maps, root cause analyses. Each example is drawn from real work across healthcare, payments, and behavioral health.
Behavioral health facilities operate on EHR systems built in the 2000s-2010s. Clinicians spend 40-60% of their time on documentation instead of patient care. Revenue leaks through undocumented services. Compliance is manual and error-prone.
| Pain Point | Impact | Proposed Solution |
|---|---|---|
| Documentation takes 20-30 min per note | Clinician burnout, lost billable hours | Voice-to-BIRP: 2-3 min per note |
| Services delivered but never documented | ~20% revenue gap (billed vs reimbursable) | AI note generation captures every service |
| Triple data entry (Excel + email + EHR) | Wasted admin time, data inconsistency | Single entry, auto-generated reports |
| Compliance is manual spreadsheets | Audit risk, missed deadlines | Automated alerts, policy library |
| No residential-specific features | Census, bed management all manual | Purpose-built residential module |
| Segment | US Facilities | Price Range | Market |
|---|---|---|---|
| PRTF | 341 | $36-60K/yr | $12-20M |
| SUD Residential | ~2,000 | $24-48K/yr | $48-96M |
| SUD Outpatient | ~14,000 | $6-18K/yr | $84-252M |
| Community BH | ~10,000 | $12-36K/yr | $120-360M |
| Total Addressable | ~26,000 | $264-728M |
| Risk | Likelihood | Impact | Mitigation |
|---|---|---|---|
| Regulatory changes (state-level) | Medium | High | Rules engine is state-configurable, not hardcoded |
| Incumbent EHR lock-in | High | Medium | Data migration tooling, parallel-run capability |
| Clinical adoption resistance | Medium | High | Built with practitioners, voice-first workflow |
| HIPAA breach | Low | Critical | Encryption at rest/transit, RBAC, audit logging, BAAs |
Activity is not productivity. Tracking commits-per-day or hours creates perverse incentives. Developers make small, frequent commits to inflate velocity. Large refactors get split into artificial chunks. Code quality suffers when optimizing for commit count.
Use story points (1, 2, 3, 5, 8) as the primary unit for measuring task complexity. Story points measure complexity, scope, uncertainty, and risk. They are independent of who does the work or how long it takes.
| SP | Category | Example |
|---|---|---|
| 1 | Trivial | Fix typo, update constant, simple config change |
| 2 | Small | Add simple component, single API endpoint |
| 3 | Medium | New UI component with state, API endpoint with validation |
| 5 | Large | New page/feature, auth flow, complex integration |
| 8 | Very Large | Major feature, architectural refactor, multi-system change |
| Policy ID | Title | Status | HIPAA | SOC 2 | NIST | Next Review |
|---|---|---|---|---|---|---|
| SEC-001 | Acceptable Use Policy | Active | Yes | Yes | Yes | 2026-11-08 |
| SEC-002 | Access Control & Authorization | Draft | Yes | Yes | Yes | Pending |
| SEC-003 | Password & Authentication | Active | Yes | Yes | Yes | 2026-11-08 |
| SEC-004 | Incident Response & Reporting | Active | Yes | Yes | Yes | 2026-11-08 |
| SEC-005 | Remote Work & MDM | Active | Yes | Yes | - | 2026-11-08 |
| PRIV-001 | Data Privacy & Security | Active | Yes | Yes | Yes | 2026-11-08 |
| COMP-001 | IT Governance & Compliance | Active | Yes | Yes | Yes | 2026-11-08 |
| HR-001 | Employee Training & Awareness | Active | Yes | - | - | 2026-11-08 |
Each policy follows a standard template: Purpose, Scope, Policy Statement, Roles & Responsibilities, Procedures, Exceptions, Compliance & Enforcement, References, and Revision History. Frontmatter includes policy ID, version, status, category, owner, approvers, effective date, review dates, and mapped compliance frameworks.
| Safeguard Type | Controls |
|---|---|
| Administrative | Security management policies, workforce training, incident response procedures |
| Physical | SOC 2 Type II certified data centers, endpoint security controls |
| Technical | Encryption at rest/transit (TLS 1.3), RBAC, comprehensive audit logging, SSO + MFA |
| Organizational | Business Associate Agreements with all third-party providers |
| Time | Event |
|---|---|
| 14:22 | First timeout alerts from monitoring |
| 14:28 | Investigation started, identified database connection pool exhaustion |
| 14:45 | Root cause identified: unindexed query on settlement table |
| 15:10 | Index deployed, connection pool drained |
| 16:52 | All queued transactions processed, incident resolved |
| # | Question | Answer |
|---|---|---|
| 1 | Why did transactions time out? | Database connection pool was exhausted |
| 2 | Why was the pool exhausted? | Queries were taking 8-12 seconds instead of <100ms |
| 3 | Why were queries slow? | Settlement reconciliation query lacked an index on created_date |
| 4 | Why was the index missing? | Table grew from 50K to 2M rows; no performance testing at scale |
| 5 | Why no performance testing? | No load testing in CI/CD pipeline for database-heavy operations |
| Control | Type | Status |
|---|---|---|
| Add composite index on settlement(created_date, merchant_id) | Immediate fix | Implemented |
| Connection pool monitoring + alerting at 80% threshold | Automated | Implemented |
| Query performance regression tests in CI | Automated | Planned |
| Monthly slow query log review | Manual | Planned |
| Capability | Current State | Target State | Gap | Effort |
|---|---|---|---|---|
| Clinical Documentation | Paper forms, scanned PDFs | Voice-to-BIRP, AI-generated notes | Critical | 8 SP |
| Assessment Instruments | Paper ASAM, manual scoring | Digital ASAM, C-SSRS, SA with auto-scoring | Critical | 5 SP |
| Treatment Plans | Word templates, copy-paste | Generated from intake data, cascading updates | Major | 8 SP |
| Census / Bed Management | Excel spreadsheet | Real-time dashboard, admission/discharge workflow | Major | 5 SP |
| Insurance Verification | Phone calls, manual entry | Payer API integration, auto-eligibility check | Major | 5 SP |
| Billing / RCM | Separate billing system | Integrated claims, denial tracking, reporting | Major | 8 SP |
| State Compliance (DBHDD) | Manual tracking, audit scramble | 131 rules encoded, automated alerts | Critical | 5 SP |
| Patient Portal | None | Secure access to records, appointment scheduling | Moderate | 5 SP |
| Reporting / Analytics | Ad-hoc Excel reports | Real-time dashboards, outcome tracking | Moderate | 3 SP |
| Decision | Capability | Rationale |
|---|---|---|
| Build Custom | Clinical Documentation | Core differentiator. Voice-first workflow doesn't exist in market. |
| Build Custom | Treatment Plans | Must cascade from intake data. Tight integration with assessments. |
| Build Custom | State Compliance (DBHDD) | Highest strategic value. No off-the-shelf state rules engine. |
| Evaluate | Billing / RCM | High complexity. Consider integration with existing clearinghouse. |
| Evaluate | Insurance Verification | Payer APIs exist but integration is non-trivial. |
| Integrate / API | Assessment Instruments | Standard instruments (ASAM, C-SSRS). Build forms, not the science. |
| Integrate / API | Census / Bed Mgmt | Moderate complexity. Standard CRUD with real-time dashboard. |
| Buy / SaaS | Patient Portal | Low strategic value. Many white-label options available. |
| Buy / SaaS | Reporting / Analytics | Standard BI tooling. Embed Metabase or similar. |
| Capability | Description | Complexity | Revenue Potential |
|---|---|---|---|
| Daily Content Delivery | Morning reading, midday reflection prompt, evening action item from book content | Medium | Per-facility license |
| Progress Tracking | Completion rates, engagement scores, streak tracking for individuals | Low | Included in license |
| Facilitator Dashboard | Group progress, discussion prompts, individual engagement flags | Medium | Premium tier |
| Assessment Integration | Pre/post program outcome measurement tied to book curriculum | High | Research/grant funding |
| Multi-Stakeholder Access | Individual, counselor, family member, and probation officer views | Medium | Per-seat add-on |
The transcript isn't just meeting notes. It's a record of who asked for what, and when. Every request, decision, and commitment is traceable back to the original conversation. This becomes a living register I work against to confirm whether assignments are complete.
| Source | Request / Decision | Owner | Status |
|---|---|---|---|
| Discovery Call (Mar 5) | Explore daily content delivery model for trilogy | Platform CTO | In Progress |
| Discovery Call (Mar 5) | Draft facility licensing pricing tiers | Platform CEO | Pending |
| Discovery Call (Mar 5) | Send facilitator guide outline for content mapping | Author | Pending |
| Discovery Call (Mar 5) | Identify 2-3 pilot facilities for beta | Author | Pending |
| Follow-up Email (Mar 7) | Schedule technical walkthrough of platform | Platform CTO | Complete |
Most meetings end with "I'll send you a summary." That summary arrives 3-5 days later as a bullet-point email that gets buried. This pipeline delivers a structured, branded, interactive deliverable the same day. But more importantly, every recorded meeting creates an auditable trail: who asked for what, when they asked, and whether it got done. No "I thought you said..." No lost commitments. The transcript is the source of truth, and the register is the accountability layer on top of it.
| Entity | Description | Key Relationships |
|---|---|---|
| Organization | Top-level tenant. Single billing entity, multiple regions. | Parent of all data. Isolation boundary for HIPAA. |
| Region | Geographic or administrative grouping of clinics. | Reporting rollup. Regional directors see aggregated data. |
| Clinic | Physical or virtual care location. Has census capacity. | Admits patients, employs staff, generates billing. |
| Patient | Individual receiving services. PHI-protected. | Central entity. All clinical data traces back here. |
| Assessment | Standardized instrument completion (ASAM, C-SSRS, etc.) | Scores feed treatment plan generation pipeline. |
| TreatmentPlan | Clinical plan with goals and measurable objectives. | Generated from assessment data. Cascading updates. |
| ClinicalNote | BIRP, DAP, or SOAP note documenting a service. | Authored by staff, linked to patient. Drives billing. |
| Engagement | Patient interaction outside clinical encounters. | SMS responses, content completions, check-ins. |
| Consent | HIPAA authorization, TCPA opt-in, information sharing. | Required before any PHI transmission or SMS contact. |
| Term | Business Definition | System Representation | Source of Truth |
|---|---|---|---|
| BIRP Note | Clinical documentation format: Behavior, Intervention, Response, Plan | ClinicalNote where note_type = 'BIRP' | Clinician (author) |
| SOBER Score | Composite engagement risk score (0-100). Higher = more engaged in recovery. | Patient.sober_score (recalculated daily) | System-generated |
| Census | Current count of admitted patients in a residential facility. | COUNT(Patient) WHERE status = 'admitted' AND clinic_id = X | Admissions system |
| Face Sheet | One-page patient summary: demographics, insurance, diagnoses, emergency contacts. | Auto-generated PDF from Patient + InsurancePolicy + Diagnosis | Intake coordinator |
| LOC | Level of Care. Clinical designation (e.g., 3.5 = Residential, 2.1 = IOP) per ASAM criteria. | Assessment.recommended_loc | ASAM assessment |
| Prior Auth | Insurance company pre-approval for services. Has expiration date and approved unit count. | InsurancePolicy.prior_auth_* fields | Insurance payer |
| Touchpoint | Any platform-initiated contact with a patient (SMS, content delivery, check-in prompt). | Engagement record with type and channel | System-generated |
| TCPA Consent | Patient's explicit opt-in to receive SMS communications per federal law. | Consent where consent_type = 'TCPA' and status = 'active' | Patient (signed) |
| Spaced Repetition | Learning methodology delivering content at increasing intervals to improve retention. | Fibonacci sequence scheduling in ContentDelivery service | Platform algorithm |
| White-Label | Platform deployed under the client facility's branding, not the platform's. | Organization.branding config (logo, colors, domain) | Organization admin |
When a clinician says "census" and a developer hears "user count," you get the wrong feature. When a project manager says "prior auth" and the offshore team builds a login screen, you lose a sprint. The glossary is the contract between business language and system implementation. It's referenced in every requirements doc, every ADR, and every sprint planning session.