telivityai/haip/haip-spec-writer

module:
  name: [Module Name]
  phase: [Phase number from build plan]
  version: 0.1.0
  status: DRAFT | REVIEW | APPROVED
 
purpose: |
  [What this module does and why it exists]
 
domain_knowledge_source: |
  [Which KB sections this module draws from]
 
inputs:
  - name: [input name]
    type: [TypeScript type]
    required: true/false
    description: [what this is]
 
outputs:
  - name: [output name]
    type: [TypeScript type]
    description: [what this returns]
 
api_endpoints:
  - method: GET/POST/PUT/DELETE
    path: /api/v1/[resource]
    description: [what it does]
    auth: required/optional
    request_body: [schema reference]
    response: [schema reference]
 
database_tables:
  - name: [table name]
    columns:
      - name: [column]
        type: [pg type]
        nullable: true/false
        description: [what this stores]
 
events_emitted:
  - name: [event.name]
    payload: [TypeScript type]
    description: [when this fires]
 
dependencies:
  - [other HAIP modules this depends on]
 
compliance_requirements:
  - [PCI/GDPR/tax/registration requirements for this module]
 
acceptance_criteria:
  - [specific, testable criteria]
 
open_questions:
  - [anything the KB doesn't answer]