Anaya Healing Ally

Part of the Anaya Care Handbook — the source of truth for how the product must behave. When the product needs to change, change this document first, then make the system match it.

Implementation status — this module is specified but not yet built. Every rule below is 🚧 Spec only until the feature ships and this page is audited against the code. Legend: ✅ In code · ⚠️ Partial · 🚧 Spec only (not yet built).

What this covers

This page governs Anaya Healing Ally: a future capability that helps a care provider document a client's wound from the mobile app and route that documentation to the people who treat it. It captures an in-app wound photo, estimates the wound's size from that photo, drafts a plain-language description with AI, tracks the wound's progress over time, sends the photos and descriptions to the client's home health team, links the wound to the care plan, and raises an alert when the wound appears to be worsening.

Healing Ally is non-skilled documentation and coordination support only. It does not treat, dress, debride, or otherwise manage a wound, and it does not replace a healthcare provider's judgment. The actual wound treatment stays entirely with the client's own healthcare providers; this feature only helps a care provider record what they see and get it in front of the right professional quickly. It is distinct from Health Monitoring, which already holds the basic wound record and its repeat assessments — Healing Ally is the future, AI-assisted documentation-and-routing layer that sits on top of that record and feeds it onward to external professionals via Care Coordination & Provider Integration.

Key terms

• Healing Ally entry — one dated wound observation captured through Healing Ally: a photo, an estimated size, an AI-drafted description, and the care provider's notes, attached to a wound on one client.
• In-app wound photo — a wound photo taken inside the Anaya app (not imported from the device gallery), so the source and timing of the image are known.
• Wound size measurement — an estimated length, width, and area derived from a photo, presented as documentation support and never as a clinical measurement.
• AI wound description — a plain-language draft description of the wound's appearance generated from the photo, which the care provider reviews and can edit before saving.
• Progress timeline — the chronological series of Healing Ally entries for one wound, shown side by side so anyone can see whether it is improving or worsening over time.
• Professional coordination — sending a wound's photos and descriptions to the client's authorized home health team for their review and action.
• Worsening alert — an automatic notification raised when successive entries suggest a wound is getting worse, so the care team and home health are prompted to act.

How it works

Capturing a wound entry

A care provider opens Healing Ally for a specific client and a specific wound, then takes an in-app photo of the wound. From that photo the feature estimates the wound's size and drafts a plain-language description of what it shows. The care provider reviews both, corrects anything that looks wrong, adds their own notes, and saves the entry. Each saved entry is stamped with who took it, when, and which wound it belongs to, and is attached to the client's wound record in Health Monitoring.

Every entry is documentation, not diagnosis. The estimated size and the AI description are starting points for the professionals who treat the wound; the feature never tells the care provider how to treat the wound, and it never decides on its own that a wound is fine.

Tracking progress over time

Saved entries build a chronological progress timeline for each wound. Anyone with access to the client's wound record can scroll the timeline and compare entries — photos and estimated sizes side by side — to see at a glance whether the wound is improving or worsening. The timeline is the shared picture the care team and the client's professionals work from; it never overwrites or deletes an earlier entry.

Coordinating with home health

Wound photos and descriptions can be sent to the client's authorized home health team for their review. Healing Ally does not create that authorization itself: the representative (or responsible party) authorizes who may receive the client's health information through Care Coordination & Provider Integration, and the agency may never reach out to an outside professional on its own. Healing Ally only packages the wound documentation and routes it to a professional who is already authorized.

Care-plan integration and worsening alerts

Each wound and its Healing Ally entries link back to the client's care plan, so wound documentation sits alongside the rest of the client's care rather than off to one side. When successive entries suggest a wound is getting worse, the feature raises a worsening alert that notifies the care manager and prompts the wound to be coordinated with the home health team. The alert is a prompt for human follow-up — it does not change the care plan or initiate treatment by itself.

Rules

1. HEAL-1 — Healing Ally is non-skilled documentation and coordination support only; it never treats, dresses, or manages a wound, and it never replaces a healthcare provider's judgment. (🚧 Spec only)
2. HEAL-2 — A Healing Ally entry can only be created against an existing wound record for a specific client of the care provider's agency, and every entry belongs to exactly one agency and one client. (🚧 Spec only)
3. HEAL-3 — A wound photo must be taken in-app, not imported from the device gallery, so the source and timing of the image are known. (🚧 Spec only)
4. HEAL-4 — The feature must estimate the wound's size (length, width, and area) from the photo and present it explicitly as documentation support, never as a clinical measurement. (🚧 Spec only)
5. HEAL-5 — The feature must draft a plain-language description of the wound from the photo, and the care provider must be able to review and edit that description before the entry is saved. (🚧 Spec only)
6. HEAL-6 — Every saved entry must record who took it, when, the photo, the estimated size, the description, and any care-provider notes, and must attach to the client's wound record. (🚧 Spec only)
7. HEAL-7 — Saved entries must form a chronological progress timeline per wound, shown so entries can be compared; an earlier entry must never be overwritten or deleted. (🚧 Spec only)
8. HEAL-8 — Wound photos and descriptions may be sent only to a home health team the representative (or responsible party) has already authorized; the agency may never contact an outside professional on its own. (🚧 Spec only)
9. HEAL-9 — Each wound and its entries must link to the client's care plan so wound documentation sits alongside the rest of the client's care. (🚧 Spec only)
10. HEAL-10 — When successive entries suggest a wound is worsening, the feature must raise a worsening alert that notifies the care manager and prompts professional coordination; the alert never changes the care plan or starts treatment on its own. (🚧 Spec only)
11. HEAL-11 — Wound photos and descriptions are client health information and must be protected accordingly: never publicly accessible, and every view, send, and worsening alert recorded in the audit trail. (🚧 Spec only)
12. HEAL-12 — Every AI-generated size estimate and description must carry a disclaimer that it is documentation, not a clinical measurement or interpretation. (🚧 Spec only)

Who can do what

Decisions needed

• How does Healing Ally relate to the existing wound assessment in Health Monitoring? Health Monitoring already defines a wound record, dated wound assessments, a trajectory, and on-demand AI wound analysis. Options: build Healing Ally as the mobile, AI-first capture flow that writes into those same wound assessments; or keep it a separate entry type with its own timeline that references the wound record. The two must not produce competing histories for the same wound.
• How accurate must the size estimate be, and what reference does it need? Photo-based size estimates vary with distance and angle. Options: require an in-frame reference marker (e.g., a sticker or ruler) for any size estimate; allow markerless estimates with a wider stated margin; or present size as a relative trend only rather than absolute measurements.
• What triggers a worsening alert? Options: a size increase beyond a threshold across entries; AI judgment from comparing photos; specific warning signs in the description (e.g., signs of infection); or a combination, with the care manager able to tune the sensitivity.
• Should the worsening alert ever reach the representative or home health directly, or only the care manager first? Options: notify the care manager only and let them decide to coordinate; auto-route the alert to the authorized home health team; or notify the representative as well for the most serious changes.
• Can a Healing Ally entry be corrected after saving, and by whom? Options: a short reporter-only edit window like incident reports; append-only with corrections added as new entries; or care-manager correction with a visible change history. Photos and history must never be silently altered.
• Does sending to home health require a fresh confirmation each time, or a standing authorization? Options: send automatically to any already-authorized provider; require the care manager to confirm each send; or let the representative pre-approve standing wound-documentation sharing for a named provider.