buildpulse/docs/ROADMAP.md

BuildPulse Roadmap

Philosophy

Each version must be useful on its own. Do not build future architecture before the current manual workflow is proven.

v0.1 — Single-Project Planning Cockpit

Goal: Create the smallest useful cockpit for one project.

Includes:

• Single project summary
• Feature Plan
• Parking Lot
• Manual Pulse Log
• Markdown/JSON/JSONL export
• Local persistence

Does not include:

• AI
• Phases
• Releases
• Multiple projects
• Real agent integration

v0.2 — AI Idea Placement

Goal: Use AI to help classify new ideas.

Potential features:

• AI classify idea as Now / Next / Later / Parking Lot / Reject
• AI suggest reason for placement
• AI suggest smallest safe version
• AI detect scope creep
• AI generate acceptance criteria draft

Build only one or two AI actions first.

Highest-value first AI action:

Classify new idea and suggest placement.

v0.3 — Phases and Releases

Goal: Add structured implementation planning.

Potential features:

• Phases
• Releases
• Definition of done
• Forbidden features per release
• Required vs optional features
• Release readiness view

v0.4 — Session Prompt Generator

Goal: Generate clean prompts for AI coding agents.

Potential features:

• Start 30-minute session from feature
• Generate Claude Code/Codex prompt
• Include do-not-touch list
• Include acceptance criteria
• Include recent pulse context
• End-session summary template

v0.5 — Local/Cloud AI Assistant

Goal: Start learning where local LLMs are good enough.

Potential features:

• Configure local endpoint manually
• Use local LLM for summaries
• Use local LLM for feature classification
• Track model usefulness
• Manual cloud fallback

v1.0 — Agent Pulse Ingestion MVP

Goal: Allow real agents/tools to submit Pulse events.

Potential features:

• Simple HTTP API for Pulse events
• Append-only pulse event store
• Real-time or refresh-based timeline
• Feature state updated from events
• Basic progress computation
• Safety/event validation

v1.5 — Agent Observability

Goal: Show real live-ish agent activity.

Potential features:

• Agent activity view
• Blocker/risk view
• Handoff events
• Evidence refs
• Test result parsing
• Git commit refs

v2.0 — Agent Pulse Framework

Goal: Become a real event-driven nervous system for autonomous agents.

Potential features:

• WebSocket stream
• Event subscriptions
• Agent coordination protocol
• Ownership claims
• Handoff handling
• Progress engine
• Constraints and approval gates
• Plugin system

Long-Term Vision

BuildPulse becomes the human cockpit for:

• Feature planning
• Idea maturation
• Scope control
• AI agent work visibility
• Local/cloud AI routing
• Autonomous agent observability