Up: Session Overview | Next >

Session 1 — The Constitution

Goal: Confirm the project identity, scope boundaries, and design philosophy are still accurate and aligned. Estimated time: 30 min

Reading Order

#	File	Lines	What It Covers
1	README.md	~55	Developer entry point. Repo structure, tech stack, environments, badges.
2	PRODUCT_identity.md	~84	Vision, five pillars, design principles, brand, target segments.
3	STRATEGY_platform-vision.md	166	Execution horizons (v0.1 → H3), GTM strategy, differentiation.
4	STRATEGY_feature-subsets.md	163	The 6 modular product subsets, inter-context dependencies.
5	STRATEGIC_BLIND_SPOTS.md	40	20 tracked blind spots (SB-1 through SB-20). Status tracker.

🔍 What to Validate

• [x] Does the V0.1 scope in project-scope.md (now identity.md) still match what you are actually building right now?
• [x] Are the horizon markers ([v0.1], [v0.2], [future], [vision]) still correctly assigned in feature-subsets.md?
• [x] Blind spots SB-2 and SB-9 are marked ✅ resolved — confirm you agree.
• [x] The 10 open blind spot items — are any now resolved or escalated? (Analysed 2026-05-12: All 10 items resolved or relocated across 7 commits. SB-11–SB-14 resolved by design or closed as invalid. SB-15/SB-16 closed as covered by existing ADRs/spikes. SB-17/SB-18 resolved with ADR-033 alignment and ML feasibility confirmation. SB-19 relocated to AP28 (BSFZ). SB-20 relocated to PD-5 (Open Decisions). The Open table now reads "(None).")
• [x] The brand identity section in project-scope.md (now identity.md) is in German while the rest is English. Intentional?
• [x] ci-cd.md Production Service Map — do all endpoints and deploy triggers still match reality? (Analysed 2026-05-12: Commit 08c5dab updated deploy triggers for Grafana, Telemetry, and Traefik (added weekly cron, workflow_dispatch), fixed stale HANDBOOK path filter. getbusflow.com domain routing has a known TODO — tracked externally. Remaining endpoints match current workflows.)
• [x] README.md domain guidance table — do the skill paths still match the .agents/skills/ directory? (Analysed 2026-05-12: The original table lived in HANDBOOK.md and was dropped during the f918d5d refactor into README.md. All 7 original skill paths still exist. See findings table below.)

🗺️ Mindmap & Path Optimization

Grab your pen and paper:

• [x] Trace the Onboarding Flow: Sketch the path a new AI agent or human takes from cloning the repo to understanding the product vision. (2026-05-12: Addressed during session work — project-scope.md renamed to PRODUCT_identity.md, README gained a product link, AREAS.md gained a product routing row. Three-file consolidation deferred; current navigation is acceptable with the new entry points.)
  • Observation: Do they have to jump between too many files?
  • Optimization: Could we consolidate project-scope.md, platform-vision.md, and feature-subsets.md into a single "Product Context" document to reduce navigation?

📝 Findings & Actions

Severity	File / Topic	Issue & Optimization Potential	Action Required	Status
Medium	platform-vision.md / identity.md	Unkempt version numbers and planning	Use results from BSFZ Funding and redo the version tags at one point. Kept as is for now.	Postponed
High	platform-vision.md	Missing features: Kalkulations-Engine, Driver Hub, Customer Intelligence, CBOR/CWT offline tickets, Omnichannel Inbox, Live ETA, B2B Agency Portal, Agentic Governance, Trigger-Based Automation	Added all missing capabilities from BSFZ research, feature-subsets, and identity.md. Restructured §H2 into grouped subsections. Added Customer Intelligence section, expanded competitive differentiation table.	✅ Done
Medium	identity.md (formerly project-scope.md)	Three Pillars are outdated	Add the new 2 pillars for Communications and Customer Intelligence	✅ Done
High	identity.md (formerly project-scope.md)	Mixed concerns (identity + dead scope pointer) and misleading filename	Rename to PRODUCT_identity.md, translate brand to English, remove dead scope section	✅ Done
Medium	README.md / AREAS.md	No product routing in entry points	Add product row to AREAS routing table, add product link to README, fix dead "Docs Hub" text	✅ Done
Medium	feature-subsets.md	Two stale links to removed §V0.1 section	Repoint to platform-vision.md §H1	✅ Done
Low	BSFZ funding dossier (3 files)	Stale references to old PRODUCT_project-scope.md filename	Archival docs — leave as-is, links were already broken (wrong path prefix)	Known
Low	session-1-constitution.md	Checklist and findings table referenced deleted filename project-scope.md	Add "(now identity.md)" / "(formerly project-scope.md)" annotations for future readers	✅ Done
Low	identity.md	date_last_reviewed still showed 2026-05-02 despite active human review	Bump to 2026-05-07	✅ Done
Medium	platform-vision.md §Strategic Prototyping	n8n framing implies an open decision; project is greenfield with no n8n in production	Rewrote section to reflect greenfield status and planned validation strategy	✅ Done
Low	platform-vision.md §Timeframe	Readers may assume execution horizons map 1:1 to BSFZ Vorhaben	Added callout explaining the orthogonal relationship with link to Vorhaben-Clustering	✅ Done
Medium	platform-vision.md §TODO	Legal requirements & data gathering section misplaced in vision doc	Removed from vision. Created SB-20 in blind spots tracker. Content split into legal + sales concerns	✅ Done
Medium	platform-vision.md §Competitive	Full 6-row competitive table clutters the vision narrative	Extracted to new STRATEGY_competitive-landscape.md. Replaced with condensed positioning paragraph + link	✅ Done
Low	platform-vision.md	"The Focus is Clear…" closing line duplicates Executive Summary and feels random	Removed	✅ Done
High	future-ideas.md	Important strategic concepts hidden in archive instead of platform vision	Triaged per idea-vs-vision classification: Zero-Integration Onboarding → H1 (vision). Network Effects, Demand Intelligence, B2B Charter Portal → ideas (conditional on market). Passenger Groups → resources. App Store + Agent Procurement → archive. Added Amadeus GDS idea.	✅ Done
Medium	platform-vision.md	No explanation of relationship to feature-subsets.md	Added NOTE callout explaining vision = strategic timeline, feature-subsets = commercial packaging	✅ Done
Medium	platform-vision.md §H3	H3 structurally thin; breaks narrative flow; mixes ideas with vision	Renamed to "Ground Transportation OS." Added thesis. Moved conditional ideas (Network Effects, Demand Intelligence, B2B Charter) to future-ideas.md. Added architectural hedge callout.	✅ Done
Medium	platform-vision.md §Non-Goals	Only 3 non-goals; Amadeus should not be a non-goal; need architectural hedging	Expanded to 5 non-goals as bullet list. Removed GDS (graduated to parked idea). Added Linienverkehr, bespoke customization, multi-entity. Added architectural hedge for international/multi-entity.	✅ Done

---

Up: Session Overview | Next >