Skip to main content

​
What happened

Built and shipped the first premium feature that spans three platforms: sparki-tools (customer-facing web app), SO1 (automation factory), and Choco HQ (documentation). The feature takes messy, unstructured LLM output — issue lists, triage notes, planning brain dumps — and converts it into structured, prioritised taskset blocks that teams can act on immediately.

​
What was wrong

When Claude or any LLM produces a triage or planning output, the result is useful but unstructured. Teams copy-paste it into docs, manually reformat it, and lose the prioritisation context. There was no productised way to turn raw planning output into actionable, ordered work blocks. Additionally, the three platforms had zero integration between them — sparki-tools used its own auth system (BetterAuth), SO1 used Clerk, and Choco HQ was documentation-only. There was no pattern for cross-service API calls.

​
What we did

  1. Defined the contract first — TypeScript types + OpenAPI spec before any implementation. Both platforms share the same data model.
  2. Built the processing engine in the SO1 factory — an n8n workflow that calls Claude to parse and structure the input, with a callback mechanism to report results.
  3. Created an API key auth layer so sparki-tools (which uses BetterAuth) can call SO1 (which uses Clerk) without needing Clerk sessions.
  4. Built the premium UI in sparki-tools — a Pro-tier gated page where users paste input and get structured output with visual priority coding, domain badges, and dependency tracking.
  5. Documented everything in Choco HQ — 7 formal requirements, 14 acceptance scenarios, catalog entries.
  6. Wrote 21 tests covering the full API surface.

​
Business impact

  • New revenue lever — Taskset Generator is the first Pro-tier feature in sparki-tools, directly driving subscription upgrades.
  • Cross-platform pattern established — API key auth + async processing + callback model is now reusable for any future feature that spans sparki-tools and SO1.
  • Documentation-first approach means every requirement is traceable through SRS-009 in Choco HQ — useful for audits and customer trust.

​
Action items

  • Deploy SO1 BFF with new env vars (EXTERNAL_API_KEYS, TASKSET_WORKFLOW_ID)
  • Create the n8n workflow matching the spec in automations/taskset-generator-workflow.md
  • Generate and configure API keys for sparki-tools → SO1 communication
  • Add NEXT_PUBLIC_SO1_BFF_URL and NEXT_PUBLIC_SO1_API_KEY to sparki-tools deployment
  • Activate Polar tier gating for Pro+ on the tasksets endpoint
  • Consider marketing the feature: “Paste your planning chaos, get structured tasksets”