chore: seed BuildPulse v0.1 documentation package

2026-05-06 23:59:31 +02:00
commit 8f0ba43728
14 changed files with 2427 additions and 0 deletions
@@ -0,0 +1,135 @@
+# 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:
+
+```text
+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