buildpulse/docs/EXPORT_FORMATS.md

BuildPulse Export Formats

Export Goals

Exports must support:

1. Backup/restore
2. AI coding agent handoff
3. Future Agent Pulse compatibility
4. Human-readable project review

Export Types

v0.1 supports:

• Full JSON export
• Pulse JSONL export
• Markdown context package

Full JSON Export

File name:

buildpulse-export.json

Shape:

{
  "schema_version": "0.1.0",
  "exported_at": "2026-05-06T00:00:00+02:00",
  "project": {},
  "features": [],
  "parking_lot": [],
  "pulses": [],
  "settings": {}
}

Pulse JSONL Export

File name:

pulses.jsonl

Rules:

• One JSON object per line.
• Each line is one Pulse event.
• Preserve event IDs.
• Preserve timestamps.
• Do not wrap in an array.

Example:

{"id":"pulse_001","timestamp":"2026-05-06T00:00:00+02:00","project_id":"project_buildpulse","feature_id":"feature_plan_screen","source":"manual","agent_id":"jimmi","pulse_type":"INTENT","message":"Start implementing Feature Plan.","structured_payload":{},"confidence_score":0.9,"evidence_refs":[],"trace_id":"session_001"}
{"id":"pulse_002","timestamp":"2026-05-06T00:30:00+02:00","project_id":"project_buildpulse","feature_id":"feature_plan_screen","source":"claude_code","agent_id":"claude_code","pulse_type":"RESULT","message":"Feature card creation implemented.","structured_payload":{},"confidence_score":0.8,"evidence_refs":["Manual test passed"],"trace_id":"session_001"}

Markdown Package

The Markdown export should generate these files:

• PROJECT_SUMMARY.md
• FEATURE_PLAN.md
• PARKING_LOT.md
• PULSE_LOG.md
• CLAUDE_CONTEXT.md

PROJECT_SUMMARY.md

Must include:

• Project name
• One-line pitch
• Description
• Current goal
• Notes

FEATURE_PLAN.md

Must include features grouped by:

• Now
• Next
• Later
• Done

Each feature should include:

• Title
• Description
• Priority
• Acceptance criteria
• Scope notes

PARKING_LOT.md

Must include:

• Title
• Description
• Reason parked
• Possible future placement
• Risk level

PULSE_LOG.md

Must include recent Pulse events, newest first or chronological.

Each pulse should include:

• Timestamp
• Pulse type
• Feature
• Source/agent
• Message
• Confidence
• Evidence refs

CLAUDE_CONTEXT.md

This is the most important AI handoff file.

It should include:

AI Coding Context

Project

## Current Goal ## Active Features ## Next Features ## Done Features ## Parking Lot / Do Not Implement Yet ## Recent Pulse Events ## Instructions for AI Developer - Only work on the selected feature. - Do not implement Parking Lot items. - Preserve working behavior. - Report changes and test steps.

Import Rules

When importing JSON:

• Validate schema version.
• Validate required fields.
• Show useful error if invalid.
• Preserve IDs.
• Avoid silent data loss.
• If schema version differs, warn user.

Copy-to-Clipboard

If downloading multiple files is complex in v0.1, support copying each Markdown output to clipboard.

Download can be added later.