Skip to main content

What happened

Full audit of the Choco platform’s GitHub organization: 47 repositories, 121 tracked issues. Every issue was cross-referenced against what’s actually built. The backlog was realigned and a 10-block execution roadmap was created.

The reality check

The platform has extensive architecture documentation, API contracts, infrastructure configuration, and issue tracking. But only 3 of 47 repositories contain code. The web application is live (deployed earlier today), the API contracts are defined, and there’s a Go CLI + SDK skeleton. Everything else — the backend services, the real-time collaboration engine, the search engine, the billing integration, the auth service — exists only as issue descriptions. This isn’t a criticism of the planning. The architecture is thorough. But the gap between planning and implementation needed to be made visible so that execution can be properly sequenced.

What was done

  • 3 duplicate issues closed — same work described twice in different issues
  • 4 issues relocated — moved from the wrong repository to where the code actually lives
  • 4 new issues created — filling gaps (Clerk auth setup, security vulnerabilities, editor EPIC, roadmap)
  • 8 advisory comments — added to issues that reference non-existent services or code in the wrong location
  • 2 EPIC issues updated — to reflect deployment status and implementation reality
  • 10-block roadmap defined — dependency-ordered execution plan (choco-hq#30)

Business impact

Before: 105 open issues spread across 37 repos with no clear execution order. Several issues targeted infrastructure for services that don’t exist yet. Duplicates wasted triage time. Code location didn’t match issue location. After: Clean backlog with dependency-ordered roadmap. The first 3 tasksets (harden web client, API contracts, first backend service) are unblocked and can start immediately. Infrastructure work is deferred to when it provides value.

Key operational takeaway

The BUNDLE-A/B/C/D structure organized work by category (foundation, infrastructure, innovation, DX). The new TASKSET A-J structure organizes by dependency chain and deployment reality. The difference: BUNDLEs say “build all infrastructure before any services” — TASKSETs say “build the minimum infrastructure needed, then the first service, then the next.”

Action items

  • Now: Execute TASKSET A — fix Dependabot vulns, configure Clerk auth, polish Oompa SVGs
  • This week: Start TASKSET B — validate API contracts against existing typed client, design database schema
  • Decision needed: Monorepo vs microservice strategy. Code currently lives in cho-co monorepo but issues are spread across 27 empty repos. Either extract code into individual repos or consolidate issues into the monorepo.

Cross-reference

Technical detail and full issue change log: so1-content/findings/2026-03-16-choco-hq-org-issue-audit-roadmap.md Roadmap issue: choco-hq#30