Roadmap
Codifix's engine is strong: hybrid retrieval, an ACT-R-grounded activation model, evidence-backed validation, memory consolidation into insights, a code graph, an automation-loop control plane, and a real evaluation harness.
This roadmap is about the other half — making it easy for a much wider audience to understand, use, and install: from a first-time beginner to a research scientist, from a classroom to a 30-second demo clip to an unconventional integration.
Two principles guide it. Prefer approaches with scientific backing or a tried-and-tested precedent, and keep a few deliberately experimental bets to stay fresh. And sequence foundation-first: an effortless install and a first-run "wow" unlock every other audience.
The nine tracks
E0 · Backlog & roadmap foundation
A clean, legible backlog and this public roadmap. Land first.
E1 · Effortless install
Docker Compose, explicit candidate packages, codifix wizard, and codifix doctor provide setup paths. Use the release package that matches your platform and verify its published checksum. Full native platform acceptance and a simple combined first-run package remain separate goals.
E2 · First-run wow
codifix demo, codifix tour, and the Docker quickstart provide a keyless project to inspect. The first source build takes time. Keep improving the demo and its empty states without adding setup burden.
E3 · Concept coherence & docs
The essentials-first docs and optional deep dives make the main workflow approachable while keeping the mental model, glossary, and science available when wanted.
E4 · Demo & video assets
The 3D codifix graph as the hero visual — with activation rendered as colour and size, and an experimental animation of spreading activation and decay that literally shows the ACT-R model in motion.
E5 · Integration surface & API
The HTTP API reference, non-Git ingestion, and integration recipes are in place. Client libraries and additional integrations remain the next expansion path.
E6 · Research & reproducibility
Turnkey one-command reproduction, citeable experiment bundles, an anonymized dataset with a DOI, and a methods write-up.
E7 · Education & classroom
A keyless single-machine classroom pack, a student mode, and a cognitive-science curriculum taught with the live visualization as the instrument — the tool teaches the concepts it implements.
E8 · Trust & polish
Green the adversarial answer-quality gate, fix known bugs, make every error name its own fix, and add opt-in usage telemetry so we can tell whether the funnel improved.
Current baseline
The public setup, demo, quickstart, API reference, ingestion path, recipes, and documentation structure are available today. The remaining tracks describe improvements beyond that baseline, not steps required before trying Codifix.
Current source also implements operator-owned area routing, private publications and expertise, company/project onboarding, selective offline knowledge and durable enrichment jobs. These are documented under Areas, Team setup, Federation, Offline and Jobs. Source implementation, an opt-in rehearsal and a published package are distinct states. Release compatibility records the current candidate, platform and supervisor limits. This roadmap is direction, not a promise of unrestricted or autonomous cross-area operation.
Deliberately experimental
- A zero-dependency embedded mode for demos and classrooms (a spike first — we will not compromise the Postgres+pgvector engine to get there).
- Animated activation, grounded in the model the engine already runs.
- The tool as a teaching instrument — turning the cited science into classroom lessons driven by the live graph.
Not yet
Hosted/SaaS, internationalization, and a hosted multi-tenant sandbox are deliberately deferred until the API is stable and demand is measured.
The full, tracked roadmap — with per-ticket scope, reuse pointers, and estimates — lives in docs/roadmap.md in the repository and in the Codifix Linear project.