Folo
AI RSS reader (TypeScript) that drove one substantial feature — its over-the-air update service apps/ota — from design spec to shipped implementation through a superpowers spec-and-plan cycle over three days in April 2026.
Reviewed last month · Jul 19, 2026
- Stars
- 38.9K
- Contributors
- 156
- Open issues
- 390
- Age
- 2.4 years
- Last push
- yesterday
- Latest release
- desktop/v1.12.0 Jul 31, 2026
View weekly commit data
| Week starting | Commits |
|---|---|
| Aug 23, 2026 | 1 |
| Aug 16, 2026 | 0 |
| Aug 9, 2026 | 1 |
| Aug 2, 2026 | 0 |
| Jul 26, 2026 | 14 |
| Jul 19, 2026 | 8 |
| Jul 12, 2026 | 15 |
| Jul 5, 2026 | 9 |
| Jun 28, 2026 | 3 |
| Jun 21, 2026 | 11 |
| Jun 14, 2026 | 2 |
| Jun 7, 2026 | 0 |
| May 31, 2026 | 6 |
| May 24, 2026 | 20 |
| May 17, 2026 | 2 |
| May 10, 2026 | 18 |
| May 3, 2026 | 2 |
| Apr 26, 2026 | 13 |
| Apr 19, 2026 | 3 |
| Apr 12, 2026 | 47 |
| Apr 5, 2026 | 71 |
| Mar 29, 2026 | 31 |
| Mar 22, 2026 | 7 |
| Mar 15, 2026 | 15 |
| Mar 8, 2026 | 28 |
| Mar 1, 2026 | 0 |
| Feb 22, 2026 | 15 |
| Feb 15, 2026 | 18 |
| Feb 8, 2026 | 15 |
| Feb 1, 2026 | 0 |
| Jan 25, 2026 | 1 |
| Jan 18, 2026 | 5 |
| Jan 11, 2026 | 2 |
| Jan 4, 2026 | 0 |
| Dec 28, 2025 | 13 |
| Dec 21, 2025 | 7 |
| Dec 14, 2025 | 7 |
| Dec 7, 2025 | 0 |
| Nov 30, 2025 | 0 |
| Nov 23, 2025 | 20 |
| Nov 16, 2025 | 81 |
| Nov 9, 2025 | 66 |
| Nov 2, 2025 | 73 |
| Oct 26, 2025 | 56 |
| Oct 19, 2025 | 130 |
| Oct 12, 2025 | 54 |
| Oct 5, 2025 | 30 |
| Sep 28, 2025 | 18 |
| Sep 21, 2025 | 84 |
| Sep 14, 2025 | 55 |
| Sep 7, 2025 | 41 |
| Aug 31, 2025 | 59 |
Metrics updated Aug 27, 2026 · collected automatically from the GitHub API
Spec structure
- Location
docs/superpowers/- Formats
- Markdown
- Notes
- Two spec/plan pairs:
specs/holds2026-04-10-ota-design.mdand2026-04-11-desktop-ota-unification-design.md, genuine design docs (Summary / Goals / Non-Goals / Key Decisions), each with a much larger matching implementation plan inplans/(the desktop unification plan alone is about 1,400 lines). All four files describe a single initiative: a standalone OTA update service inapps/otabuilt on Expo Updates and Cloudflare Workers/R2.
Assessment drift: moderate
Spec-to-code drift
Moderate, with the nuance common to bounded adoptions. One feature went spec → plan → implementation in three
days in April 2026: the apps/ota scaffold commit landed twelve minutes after the design spec, and the 42-file
implementation commit followed on 2026-04-12. Since then docs/superpowers/ has been dormant — its only later
commit is an incidental three-line edit from a dependency-update PR (chore(deps): update frontend dependencies (#5038), 2026-07-10) — while apps/ota picked up follow-up fixes through late May and the repository as a whole
ships near-daily. The specs still describe the initiative they were written for, but none of the later OTA fixes
updated them, and divergence has not been audited. This reads as a single-initiative adoption rather than an
embedded team practice.
Defects and rework
A short, ordinary shakedown tail followed the launch: fixes within days (fix(ota): restore desktop binary manifest updates, fix(ota): harden store sync and observability, both 2026-04-15) and stragglers into May
(fix(ota): include Expo config in manifests; fix(download): route direct downloads through ota). Roughly half
a dozen fix commits against a service built in three days is unremarkable; whether it is better or worse than the
project’s baseline has not been measured.
Maintenance outcomes
The spec-driven service appears to have reached stability — since late May 2026 the only change under apps/ota
has been a dependency chore, while the app keeps shipping desktop and mobile releases that depend on it. The
signal to watch is whether the practice returns for a second feature: a heavily shipped consumer app trying SDD
once, succeeding, and not (yet) repeating it is itself a data point.
Timeline
-
OTA implementation landed
`feat(ota): unify desktop updates with ota service` — a 42-file commit that also added the desktop implementation plan; the last substantive commit under `docs/superpowers/`.
-
Desktop unification spec added
`docs(spec): add desktop ota unification design`.
-
OTA design spec added
First commit to `docs/superpowers/`: `docs(ota): add OTA service design spec`. Scaffolding of `apps/ota` began within minutes.