Initial commit — design docs + Phase 0 validation harness

Sets up the Socrata project repo with:

docs/ — strategy and design documents
  - idea.md: full product vision
  - implementation-plan.md: Phase 0 + Phase 1 MVP plan
  - phase-0-validation.md: 2-week validation experiment strategy
  - phase-0-plan.md: concrete Phase 0 build plan
  - phase-0-results.md: Phase 0 gate outcome — GO for MVP
  - sysml-modeling.md: metamodel + SE discipline + validation rules
  - socrates.md: agent character, surfaces, modes, prompts, lifecycle
  - sync.md: bidirectional text↔diagram sync engineering
  - design-source/: HTML/CSS/JS handoff bundle from Claude Design

phase-0/ — validated harness (CLI, no UI, no DB)
  - LM Studio (local OpenAI-compatible) generation + detection + judge
  - PlantUML rendering for SysML model visualization
  - 10-seed corpus (8 working + 2 holdouts)
  - 5 corpus runs with iteration history in reports/
  - Final gate: 10/10 pass, mean 4.32/5, holdouts validated

Phase 1 MVP scope and milestones documented in implementation-plan.md.
This commit is contained in:
2026-04-28 22:07:38 +02:00
commit f1c4566576
75 changed files with 14501 additions and 0 deletions

View File

@@ -0,0 +1,18 @@
{
"id": "10-telemetry-lite",
"title": "Telemetry Lite",
"problem": "PostHog has won the product-analytics-with-session-replay category but its self-hosted footprint is too heavy for small teams (Postgres, Kafka, ClickHouse, Redis, multiple workers). Privacy-conscious teams who want to self-host are stuck either running PostHog at $200/month of infra OR using nothing and getting blind product decisions.",
"targetUser": "Engineering teams at 530 person companies (or solo founders) who want product analytics + session replay but refuse to send user data to a third-party SaaS, and don't have an infra engineer to run PostHog.",
"desiredOutcome": "A single Docker container, single SQLite file, that delivers 80% of PostHog's value — events, funnels, session replay — at 5% of the operational complexity.",
"initialHypothesis": "There's a self-host segment that won't pay for SaaS analytics OR run a PostHog cluster. They'll accept a smaller feature set in exchange for trivial ops.",
"constraints": [
"Single binary or single Docker container, SQLite-only storage option",
"Apache 2.0 license, hosted version is a separate commercial play",
"GDPR-compliant data export and deletion built in"
],
"meta": {
"isHoldout": true,
"expectedDifficulty": "hard",
"testsFor": ["technical", "oss", "competitive-positioning"]
}
}