[{"data":1,"prerenderedAt":528},["ShallowReactive",2],{"repo-tree":3,"repo-\u002Fdevelopment-process":283},[4,7,10,13,16,19,22,25,28,31,34,37,40,43,46,49,52,55,58,61,64,67,69,72,75,78,81,84,86,88,90,93,96,99,102,105,108,111,114,117,120,123,125,127,129,131,133,135,138,141,143,146,149,152,155,158,161,164,167,169,172,175,178,180,183,186,189,192,195,198,201,203,206,209,212,215,218,221,224,227,230,233,236,239,242,245,248,251,254,257,260,263,266,269,272,275,278,281],{"path":5,"title":6},"\u002Fagents\u002Fbackend-code-style","Backend Conventions",{"path":8,"title":9},"\u002Fagents\u002Fdatabase","Database",{"path":11,"title":12},"\u002Fagents\u002Fportal-code-style","Portal Conventions",{"path":14,"title":15},"\u002Fagents\u002Ftranslation","Translation",{"path":17,"title":18},"\u002Fconventions\u002Fbackend-coding","Backend coding conventions",{"path":20,"title":21},"\u002Fconventions\u002Ffrontend-coding","Frontend coding conventions",{"path":23,"title":24},"\u002Fdevelopment-process","Development process",{"path":26,"title":27},"\u002Flearning-api-preview-hetzner-setup","Learning API Preview on Hetzner + Cloudflare",{"path":29,"title":30},"\u002Flearning-api-preview-vm-plan","Learning API Preview VM Plan",{"path":32,"title":33},"\u002Fmonorepo-structure","Monorepo structure",{"path":35,"title":36},"\u002Foperations","Operations — bugs and support",{"path":38,"title":39},"\u002Fpostmortems\u002F2026-03-16_onboarding-currency-regression","Onboarding Zod transform silently broken — web signups assigned wrong checkout currency",{"path":41,"title":42},"\u002Fpostmortems\u002Freadme","Postmortems",{"path":44,"title":45},"\u002Fpostmortems\u002F_template","TEMPLATE",{"path":47,"title":48},"\u002Fpostmortems\u002Fposthog-comparison","Postmortem practice — comparison with PostHog",{"path":50,"title":51},"\u002Fpreview-environment-plan","Preview Environment Plan",{"path":53,"title":54},"\u002Fprinciples","Engineering principles",{"path":56,"title":57},"\u002Fworking-with-ai","Working with AI",{"path":59,"title":60},"\u002F.claude\u002Fskills\u002Feval-playground\u002Fskill","Eval Playground — Co-development Skill",{"path":62,"title":63},"\u002F.claude\u002Fskills\u002Ffigma-diff-section\u002Fskill","Figma Diff Section Pipeline",{"path":65,"title":66},"\u002Fagents","AGENTS.md",{"path":68,"title":66},"\u002Fclaude",{"path":70,"title":71},"\u002Freadme","Studyflash",{"path":73,"title":74},"\u002Fapps\u002Fcore-api\u002Fagents","Core API (apps\u002Fcore-api)",{"path":76,"title":77},"\u002Fapps\u002Fcore-api\u002Freadme","README",{"path":79,"title":80},"\u002Fapps\u002Femail-previews\u002Fagents","Email Previews (apps\u002Femail-previews)",{"path":82,"title":83},"\u002Fapps\u002Flanding-page\u002Fagents","Landing Page (apps\u002Flanding-page)",{"path":85,"title":83},"\u002Fapps\u002Flanding-page\u002Fclaude",{"path":87,"title":66},"\u002Fapps\u002Flearning-api\u002Fagents",{"path":89,"title":77},"\u002Fapps\u002Flearning-api\u002Freadme",{"path":91,"title":92},"\u002Fapps\u002Flearning-api\u002Fevals-playground\u002Feval_metrics_design","Surface-Specific Eval Metrics Design",{"path":94,"title":95},"\u002Fapps\u002Flearning-api\u002Fevals-playground\u002Ftest_set","Quiz Eval Test Set",{"path":97,"title":98},"\u002Fapps\u002Flearning-api\u002Fevals-playground\u002Ffrontend\u002Freadme","React + TypeScript + Vite",{"path":100,"title":101},"\u002Fapps\u002Flearning-api\u002Fevals-playground\u002Fknown-issues\u002Fcontent-pillar-shallow-coverage\u002Freadme","Content pillar misses subtopics in dense documents",{"path":103,"title":104},"\u002Fapps\u002Flearning-api\u002Fevals-playground\u002Fknown-issues\u002Fdocling-empty-section-headers\u002Freadme","Empty section headers dropped by docling chunker",{"path":106,"title":107},"\u002Fapps\u002Flearning-api\u002Fevals-playground\u002Fknown-issues\u002Fdocling-table-reading-order\u002Freadme","Table\u002Fbox layout causes wrong reading order",{"path":109,"title":110},"\u002Fapps\u002Flearning-api\u002Fevals-playground\u002Fmetrics\u002Freadme","Quiz eval metrics — canonical rubrics",{"path":112,"title":113},"\u002Fapps\u002Flearning-api\u002Fevals-playground\u002Freports\u002F2026-04-12-quiz-summary-feedback-current-state","Quiz and Summary Feedback Current State",{"path":115,"title":116},"\u002Fapps\u002Flearning-api\u002Fevals-playground\u002Freports\u002F2026-04-24-quiz-eval-metrics","Quiz Evaluation Metrics",{"path":118,"title":119},"\u002Fapps\u002Flearning-api\u002Fevals-playground\u002Freports\u002F2026-05-01-quiz-eval-current-state","Quiz Eval Current State",{"path":121,"title":122},"\u002Fapps\u002Flearning-api\u002Fmonitoring\u002Freadme","Monitoring Stack",{"path":124,"title":77},"\u002Fapps\u002Flearning-api\u002Fshared\u002Freadme",{"path":126,"title":77},"\u002Fapps\u002Flearning-api\u002Fworkers\u002Flearning_agents\u002Fflashcard_agent\u002Freadme",{"path":128,"title":77},"\u002Fapps\u002Flearning-api\u002Fworkers\u002Flearning_agents\u002Fingestion_agent\u002Freadme",{"path":130,"title":77},"\u002Fapps\u002Flearning-api\u002Fworkers\u002Flearning_agents\u002Fquiz_agent\u002Freadme",{"path":132,"title":77},"\u002Fapps\u002Flearning-api\u002Fworkers\u002Flearning_agents\u002Fsummary_agent\u002Freadme",{"path":134,"title":77},"\u002Fapps\u002Flearning-api\u002Fworkers\u002Fparser\u002Freadme",{"path":136,"title":137},"\u002Fapps\u002Fmarketing-emails-preview\u002Fagents","Marketing Emails Preview (apps\u002Fmarketing-emails-preview)",{"path":139,"title":140},"\u002Fapps\u002Fmobile-app\u002Fagents","StudyFlash Mobile App - Claude Code Configuration",{"path":142,"title":140},"\u002Fapps\u002Fmobile-app\u002Fclaude",{"path":144,"title":145},"\u002Fapps\u002Fmountain-max\u002Fagents","Mountain Max (apps\u002Fmountain-max)",{"path":147,"title":148},"\u002Fapps\u002Fmountain-max\u002Fgame\u002Freadme","Mountain Max Game",{"path":150,"title":151},"\u002Fapps\u002Fportal\u002Fagents","Portal (apps\u002Fportal)",{"path":153,"title":154},"\u002Fapps\u002Fportal\u002Freadme","Nuxt Minimal Starter",{"path":156,"title":157},"\u002Fapps\u002Fportal\u002Fapp\u002Fcomposables\u002Ffiles\u002Freadme","File Upload Composables",{"path":159,"title":160},"\u002Fapps\u002Fportal\u002Fdocs\u002Flibrary-routing","Library Routing Documentation",{"path":162,"title":163},"\u002Fapps\u002Fsupabase\u002Fagents","Supabase (apps\u002Fsupabase)",{"path":165,"title":166},"\u002Fapps\u002Fwrapped\u002Fagents","Wrapped (apps\u002Fwrapped)",{"path":168,"title":98},"\u002Fapps\u002Fwrapped\u002Freadme",{"path":170,"title":171},"\u002Finfra\u002Freadme","infra\u002F",{"path":173,"title":174},"\u002Finfra\u002Fdns\u002Freadme","DNS Infrastructure",{"path":176,"title":177},"\u002Finfra\u002Fdokploy\u002Freadme","studyflash-dokploy",{"path":179,"title":77},"\u002Finfra\u002Fdokploy\u002Fsdk\u002Fnodejs\u002Freadme",{"path":181,"title":182},"\u002Finfra\u002Finfisical\u002Freadme","Infisical Infrastructure",{"path":184,"title":185},"\u002Finfra\u002Flearning-api\u002Freadme","Pulumi GCP TypeScript Template",{"path":187,"title":188},"\u002Finfra\u002Fopenreplay\u002Freadme","OpenReplay on Hetzner",{"path":190,"title":191},"\u002Finfra\u002Fscripts\u002Freadme","infra\u002Fscripts\u002F",{"path":193,"title":194},"\u002Finfra\u002Fturborepo-cache\u002Freadme","Turborepo Remote Cache Infrastructure",{"path":196,"title":197},"\u002Finternal\u002Fchatwoot\u002Freadme","Chatwoot Infrastructure",{"path":199,"title":200},"\u002Finternal\u002Fchatwoot\u002Fprovider\u002Freadme","studyflash-chatwoot-provider",{"path":202,"title":77},"\u002Finternal\u002Fchatwoot\u002Fprovider\u002Fsdk\u002Fnodejs\u002Freadme",{"path":204,"title":205},"\u002Finternal\u002Fdocs\u002Freadme","internal\u002Fdocs",{"path":207,"title":208},"\u002Finternal\u002Fsupport-bot\u002Fclaude","Support Bot (Maximilian)",{"path":210,"title":211},"\u002Finternal\u002Fsupport-bot\u002Freadme","Studyflash Customer Support Bot (Maximilian)",{"path":213,"title":214},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Faccount_issues","Account Issues",{"path":216,"title":217},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fbilling_invoice","Billing Invoice",{"path":219,"title":220},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fcontent_upload","Content Upload",{"path":222,"title":223},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fdata_loss","Data Loss",{"path":225,"title":226},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fflashcard_issues","Flashcard Issues",{"path":228,"title":229},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fgarbage","Garbage",{"path":231,"title":232},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fgeneral_how_to","General How To",{"path":234,"title":235},"\u002Finternal\u002Fsupport-bot\u002Fkb","Knowledge Base Index",{"path":237,"title":238},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Flanguage_issues","Language Issues",{"path":240,"title":241},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fmindmap_issues","Mindmap Issues",{"path":243,"title":244},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fmisunderstanding","Misunderstanding",{"path":246,"title":247},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fmock_exam_issues","Mock Exam Issues",{"path":249,"title":250},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fpodcast_issues","Podcast Issues",{"path":252,"title":253},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fquiz_issues","Quiz Issues",{"path":255,"title":256},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Frefund_request","Refund Request",{"path":258,"title":259},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fsubscription_cancellation","Subscription Cancellation",{"path":261,"title":262},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fsubscription_info","Subscription Info",{"path":264,"title":265},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fsummary_issues","Summary Issues",{"path":267,"title":268},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Ftechnical_errors","Technical Errors",{"path":270,"title":271},"\u002Finternal\u002Fsupport-bot\u002Fkb\u002Fvideo_issues","Video Issues",{"path":273,"title":274},"\u002Fpackages\u002Fcommon\u002Fdocs\u002Fearly-access-features","Declarative Early Access Features",{"path":276,"title":277},"\u002Fpackages\u002Fcommon\u002Fscripts\u002Freadme","Common Package Scripts",{"path":279,"title":280},"\u002Fpackages\u002Fdevtools\u002Ffigma-plugins\u002Freadme","Figma plugins",{"path":282,"title":77},"\u002Fpackages\u002Fpulumi-infisical\u002Freadme",{"id":284,"title":24,"body":285,"description":515,"extension":516,"lastReviewed":517,"meta":518,"navigation":519,"owner":520,"path":23,"seo":521,"status":522,"stem":523,"tags":524,"__hash__":527},"handbook\u002Fdevelopment-process.md",{"type":286,"value":287,"toc":498},"minimark",[288,307,312,315,331,335,338,349,353,356,361,378,382,396,400,417,421,435,439,450,454,465,469,472,486,490],[289,290,291],"blockquote",{},[292,293,294,298,299,306],"p",{},[295,296,297],"strong",{},"Status: draft scaffold."," Inspired by ",[300,301,305],"a",{"href":302,"rel":303},"https:\u002F\u002Fposthog.com\u002Fhandbook\u002Fengineering\u002Fdevelopment-process",[304],"nofollow","PH's development process handbook"," but we have a very different shape — small team, no PMs, founder-engineering. Rewrite from first principles, don't copy.",[308,309,311],"h2",{"id":310},"what-we-keep-from-ph","What we keep from PH",[292,313,314],{},"TODO. Candidates:",[316,317,318,322,325,328],"ul",{},[319,320,321],"li",{},"Small PRs, frequent merges, feature flags for risky changes.",[319,323,324],{},"Default-to-shipping bias.",[319,326,327],{},"Public-by-default knowledge (this handbook surface).",[319,329,330],{},"\"Sprints\" are just calendar weeks, not Jira ceremony.",[308,332,334],{"id":333},"what-we-explicitly-reject-from-ph","What we explicitly reject from PH",[292,336,337],{},"TODO. Probably:",[316,339,340,343,346],{},[319,341,342],{},"Multi-team coordination overhead.",[319,344,345],{},"RFC process for every change — too heavy for 5 people.",[319,347,348],{},"Quarterly OKR ritual.",[308,350,352],{"id":351},"our-actual-flow-to-be-defined","Our actual flow (to be defined)",[292,354,355],{},"TODO. Sketch the shape we want:",[357,358,360],"h3",{"id":359},"idea-capture","Idea capture",[316,362,363,375],{},[319,364,365,366,370,371,374],{},"Where: Linear backlog, \"Brain dump\" doc, Slack ",[367,368,369],"code",{},"#engineering",", this handbook (research write-ups at ",[367,372,373],{},"internal\u002Fdocs\u002Fcontent\u002F",").",[319,376,377],{},"Promotion: idea → Linear ticket when scoped.",[357,379,381],{"id":380},"spec-planning","Spec \u002F planning",[316,383,384,387,390],{},[319,385,386],{},"Default: ticket description + one comment for design notes.",[319,388,389],{},"Threshold for a write-up: TODO (e.g. anything touching >2 apps, anything user-facing with UX implications).",[319,391,392,393,395],{},"Where write-ups live: ",[367,394,373],{}," (research surface).",[357,397,399],{"id":398},"build","Build",[316,401,402,405,408,411],{},[319,403,404],{},"Branch naming: TODO.",[319,406,407],{},"PR size guidance: TODO (PH says \u003C500 LoC — what's ours?).",[319,409,410],{},"Feature flags: when required.",[319,412,413,414,374],{},"Preview environments: PR-triggered Hetzner preview VM (see ",[367,415,416],{},"infra\u002Flearning-api\u002Fpreview-vm.ts",[357,418,420],{"id":419},"review","Review",[316,422,423,426,429,432],{},[319,424,425],{},"Reviewer assignment: TODO.",[319,427,428],{},"Turnaround SLA: TODO.",[319,430,431],{},"When to request a second reviewer.",[319,433,434],{},"\u002Fultrareview as a tool (multi-agent review on the branch).",[357,436,438],{"id":437},"ship","Ship",[316,440,441,444,447],{},[319,442,443],{},"Merge gate: green CI, one approval, no open conversations.",[319,445,446],{},"Auto-deploy or manual.",[319,448,449],{},"Customer comms — when does a feature warrant changelog \u002F in-app notice.",[357,451,453],{"id":452},"post-ship","Post-ship",[316,455,456,459,462],{},[319,457,458],{},"Watching telemetry for X hours.",[319,460,461],{},"Rollback procedure.",[319,463,464],{},"When a regression becomes a postmortem.",[308,466,468],{"id":467},"cadences","Cadences",[292,470,471],{},"TODO.",[316,473,474,477,480,483],{},[319,475,476],{},"Standup? (Probably no.)",[319,478,479],{},"Weekly demo \u002F show-and-tell?",[319,481,482],{},"Retro?",[319,484,485],{},"Planning session?",[308,487,489],{"id":488},"open-questions","Open questions",[316,491,492,495],{},[319,493,494],{},"Do we want a lightweight RFC convention for cross-cutting changes? What's the threshold?",[319,496,497],{},"How do we keep this doc current as the team grows from 5 → 10?",{"title":499,"searchDepth":500,"depth":500,"links":501},"",2,[502,503,504,513,514],{"id":310,"depth":500,"text":311},{"id":333,"depth":500,"text":334},{"id":351,"depth":500,"text":352,"children":505},[506,508,509,510,511,512],{"id":359,"depth":507,"text":360},3,{"id":380,"depth":507,"text":381},{"id":398,"depth":507,"text":399},{"id":419,"depth":507,"text":420},{"id":437,"depth":507,"text":438},{"id":452,"depth":507,"text":453},{"id":467,"depth":500,"text":468},{"id":488,"depth":500,"text":489},"How we go from idea → spec → PR → review → ship at studyflash. Inspired by PH's process but adapted to a 5-person team.","md",null,{},true,"rajiv",{"title":24,"description":515},"draft","development-process",[525,526],"process","engineering","xKGTQXvi_jsTkrn_nvEDmWUUWdZU8LCdcP9zZ9yhVL4",1779007962943]