Geometry OS Implementation Plans

This directory contains detailed implementation plans for Geometry OS development.

Phase 1: Critical Fixes & Technical Debt (Weeks 1-2)

✅ Ready to Execute

Quick Start

Executing a Plan

Each plan is self-contained and can be executed independently. To execute a plan:

Option 1: Subagent-Driven (Current Session)

# Use the superpowers:subagent-driven-development skill
# This will spawn fresh subagents per task with code review between steps

Option 2: Parallel Session

# Open a new session in a dedicated worktree
# Use the superpowers:executing-plans skill

Plan Structure

Each plan follows this structure:

1. Header - Goal, architecture, tech stack
2. Bite-sized tasks - Each step takes 2-5 minutes
3. Exact file paths - No ambiguity
4. Complete code - Full implementations in plan
5. Verification steps - How to confirm it works

Execution Order

Priority 1 (Do First - Unblocking)

1. WGSL i64 Fix - Unblocks RISC-V GPU VM execution
2. CUDA Compatibility - Enables GPU tests on newer hardware

Priority 2 (High Impact)

1. RTS AMP BF16 Support - Performance improvement for Ampere+
2. Lightning Integration - Streamlines training infrastructure

All four tasks can be executed in parallel by different team members.

Task Creation Guidelines

When creating new plans:

1. Use the superpowers:writing-plans skill
2. Save to docs/plans/YYYY-MM-DD-<feature-name>.md
3. Follow the established template
4. Include exact file paths from the codebase
5. Break into 2-5 minute steps
6. Include verification commands

Phase Status

• Phase 1 (Critical Fixes): Plans complete, ready to execute
• Phase 2 (Feature Completeness): Pending planning
• Phase 3 (Scalability): Pending planning
• Phase 4 (Documentation): Ongoing
• Phase 5 (Future): Ideation

Links

• Main Roadmap
• GPU Compatibility Guide
• RTS AMP BF16 Guide
• Lightning Integration Guide