Skip to content

Evidence Intake

Mandatory rules

  • Allowed sources: (1) meeting recording with screen share, (2) email thread. Nothing else.
  • Transcript: every meeting has a transcript with timestamps and a link to the video; every email stores the message-id. Recommended location: openspec/evidence/ or a reference link in the source field in the spec.
  • Traceability: every requirement in openspec/specs and openspec/changes must include source: meeting:<date>#<timestamp> or source: email:<message-id>.
  • Validation: no work starts without attached evidence. If evidence is missing, the request returns to intake.

Intake outputs

  • Processed transcript with links to screen/timestamp.
  • Structured list of requirements (Gap Analysis, Solution Proposal) with source reference.
  • Split into first version (architect design) and iterative backlog (later changes).

Example source reference

requirements:
  - id: "REQ-001"
    title: "Automatic numbering of receipts"
    source: "meeting:2025-01-15#32:10"
    description: |
      The system must automatically generate a unique receipt number.

  - id: "REQ-002"
    title: "Export to Pohoda"
    source: "email:CAG1234567890@mail.example.com"
    description: |
      Export invoices to XML format for Pohoda.

Intake checklist

  • [ ] Meeting is recorded (video + audio)
  • [ ] Transcript is created with timestamps
  • [ ] Emails are saved with message-id
  • [ ] Every requirement has a source reference
  • [ ] Evidence is stored in openspec/evidence/

➡️ Continue to Architect & Specification.