Commit graph

6 commits

Author SHA1 Message Date
52aaf9e365 docs: add ruff as Python tooling constraint
Use ruff for linting and formatting (replaces flake8, black, isort)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 19:33:13 +00:00
16b17ca2cf docs: create roadmap (9 phases)
Phases:
1. Core Infrastructure & Security: INFR-*, ISO-04
2. Overlay System Foundation: OVLY-01 to OVLY-07, OVLY-10
3. Build Queue & Workers: ISO-01 to ISO-07 (except ISO-04)
4. User Accounts: USER-01 to USER-15
5. Builder Interface (2D): BUILD-04 to BUILD-06, BUILD-09 to BUILD-11
6. Speeches & Community: SPCH-*, OVLY-11 to OVLY-14
7. 3D Visualization: BUILD-01 to BUILD-03, BUILD-07, BUILD-08
8. Advanced Dependency Resolution: OVLY-08, OVLY-09
9. Distribution Content: DIST-01 to DIST-10

All 70 v1 requirements mapped to phases.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 19:32:27 +00:00
f4d2185a56 docs: define v1 requirements
70 requirements across 7 categories:
- Builder Interface: 11
- ISO Generation: 7
- Speeches: 12
- User Accounts: 15
- Overlay System: 14
- Distribution Support: 10
- Infrastructure: 7

11 requirements deferred to v2

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 19:27:47 +00:00
c0ff95951e docs: add project research
Files:
- STACK.md: Technology stack recommendations (Python 3.12+, FastAPI, React 19+, Vite, Celery, PostgreSQL 18+)
- FEATURES.md: Feature landscape analysis (table stakes vs differentiators)
- ARCHITECTURE.md: Layered web-queue-worker architecture with SAT-based dependency resolution
- PITFALLS.md: Critical pitfalls and prevention strategies
- SUMMARY.md: Research synthesis with roadmap implications

Key findings:
- Stack: Modern 2026 async Python (FastAPI/Celery) + React/Three.js 3D frontend
- Architecture: Web-queue-worker pattern with sandboxed archiso builds
- Critical pitfall: Build sandboxing required from day one (CHAOS RAT AUR incident July 2025)

Recommended 9-phase roadmap: Infrastructure → Config → Dependency → Overlay → Build Queue → Frontend → Advanced SAT → 3D Viz → Optimization

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 02:07:11 +00:00
87116b1f56 chore: add project config
Mode: yolo
Depth: comprehensive
Parallelization: enabled
Workflow agents: research=on, plan_check=on, verifier=on

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 01:56:09 +00:00
6e033762ad docs: initialize project
Visual Linux distribution customization platform with 3D builder interface, starting with Omarchy/CachyOS.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 01:54:28 +00:00