Skip to content

Commit 5ff6c43

Browse files
committed
docs(ruQu): Add limitations, unknowns, and roadmap for publication readiness
Honest assessment of current boundaries: - Simulation-only validation (hardware pending) - Surface code focus (code-agnostic architecture) - API stability (v0.x) - Scaling unknowns at d>11 Roadmap through v1.0 with hardware validation goal. Call for hardware partners, algorithm experts, application developers.
1 parent 8a7ad9e commit 5ff6c43

1 file changed

Lines changed: 35 additions & 0 deletions

File tree

crates/ruQu/README.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1319,6 +1319,41 @@ Results:
13191319

13201320
---
13211321

1322+
## Limitations & Roadmap
1323+
1324+
### Current Limitations
1325+
1326+
| Limitation | Impact | Mitigation Path |
1327+
|------------|--------|-----------------|
1328+
| **Simulation-only validation** | Hardware behavior may differ | Partner with hardware teams for on-device testing |
1329+
| **Surface code focus** | Other codes (color, Floquet) untested | Architecture is code-agnostic; validation needed |
1330+
| **Fixed grid topology** | Assumes regular detector layout | Extend to arbitrary graphs |
1331+
| **API stability** | v0.x means breaking changes possible | Semantic versioning; deprecation warnings |
1332+
1333+
### What We Don't Know Yet
1334+
1335+
- **Scaling behavior at d>11** — Algorithm is O(n^{o(1)}) in theory; large-scale benchmarks pending
1336+
- **Real hardware noise models** — Simulation uses idealized correlated bursts; real drift patterns may differ
1337+
- **Optimal threshold selection** — Current thresholds are empirically tuned; adaptive learning may improve
1338+
1339+
### Roadmap
1340+
1341+
| Phase | Goal | Status |
1342+
|-------|------|--------|
1343+
| **v0.1** | Core coherence gate with min-cut | ✅ Complete |
1344+
| **v0.2** | Predictive early warning, drift detection | ✅ Complete |
1345+
| **v0.3** | Hardware integration API | 🔄 In progress |
1346+
| **v0.4** | Multi-code support (color codes) | 📋 Planned |
1347+
| **v1.0** | Production-ready with hardware validation | 📋 Planned |
1348+
1349+
### How to Help
1350+
1351+
- **Hardware partners**: We need access to real syndrome streams for validation
1352+
- **Algorithm experts**: Optimize min-cut for specific code geometries
1353+
- **Application developers**: Build on ruQu for healthcare, finance, or security use cases
1354+
1355+
---
1356+
13221357
## References
13231358

13241359
<details>

0 commit comments

Comments
 (0)