devsofttech_hms_ci4/AGENTS.md

Developer & Agent Guidelines

ABDM Standards

For all ABDM (Ayushman Bharat Digital Mission) development, linking, Care Context management, and FHIR generation:

• Strictly follow the standards defined in .agents/rules/abdm_standards.md
• Full documentation and API contract explanations: docs/abdm/CARE_CONTEXT_AND_FHIR_STANDARDS.md

Key Rules at a Glance:

1. Never set patient[].referenceNumber to internal hospital UHID (e.g. P26081015350).
   The ABDM PHR app displays this field under its "Patient reference" table column. It MUST always be set to the specific care context reference (PRESC-{patient_id}-S{session_id}-{YYYYMMDD}, OPD-{patient_id}-S{session_id}-{YYYYMMDD}, etc.).
2. Never overwrite structured references with p_code in AbdmGateway.php.
3. All FHIR bundles must conform to NRCeS FHIR R4 document bundle specifications.