carepath-api / docs /FEATURE_INTAKE.md
tranth3truong's picture
Deploy public Scribe-only CarePath Space
cc678b9
|
Raw
History Blame Contribute Delete
2.01 kB
# CarePath Feature Intake
Every implementation request is classified before code changes. Record the
classification with `.\scripts\bin\harness-cli.exe intake`.
## Input Types
| Type | Use when | Typical artifact |
| --- | --- | --- |
| Change request | Bounded behavior, bug, copy, or UX refinement | Direct patch or story |
| New initiative | A new product area spanning multiple stories | Initiative note and stories |
| Maintenance request | Dependency, performance, delivery, or operational work | Story or decision |
| Harness improvement | Process, proof, template, or instruction work | Harness docs and trace |
## Lanes
### Tiny
Use for narrow docs, copy, or isolated maintenance with no safety, API, data,
or multi-module impact. Record intake, patch directly, and run the relevant
quick proof. A UX or product-flow change still updates
`docs/ux-redesign-carepath.md` first.
### Normal
Use for a bounded change to one product surface or shared implementation. Create
or update one story packet, define the validation, update proof flags, and
record a standard trace.
### High-Risk
Use `docs/templates/high-risk-story/` and record a durable decision when the
work changes safety behavior, architecture, data ownership, public API shape,
or validation policy. Ask the user before implementing when the direction is
ambiguous.
## CarePath Hard Gates
The following are always high-risk:
- Consent, microphone capture, raw-audio handling, retention, or privacy.
- Interpreter risk classification, confidence display, patient display, TTS,
escalation, or fail-closed behavior.
- Medical advice boundaries, provider behavior, credentials, or external
clinical data.
- Public API or WebSocket contract changes, database migrations, or changes
that span the Scribe and Interpreter modules.
- Removing or weakening existing safety or validation requirements.
Use the existing test and eval fixtures whenever a risk-engine rule changes;
zero misses on critical fixtures remains a hard gate.