Skip to content

ROADMAP.md

Latest commit

 

History

History
210 lines (156 loc) · 5.5 KB

ROADMAP.md

File metadata and controls

210 lines (156 loc) · 5.5 KB
Raw

SourceAtlas Roadmap

Current Status: v2.9.0 Complete ✅ Last Updated: 2025-12-20 Pattern Count: 221 patterns (iOS 34, TypeScript/React/Vue 50, Android/Kotlin 31, Python 26, Ruby 26, Go 26, Rust 28)

🎯 Current Release: v2.9.0 🔵

Core Commands (7 Total)

Command Purpose Status
/atlas.init Project initialization ✅ 2025-11-30
/atlas.overview Project fingerprint ✅ 2025-11-20
/atlas.pattern Learn patterns ✅ 2025-11-22
/atlas.impact Impact analysis ✅ 2025-11-25
/atlas.history Git temporal analysis ✅ 2025-11-30
/atlas.flow Flow tracing (11 modes) ✅ 2025-12-01
/atlas.deps Dependency analysis ✅ 2025-12-12

Multi-Language Patterns (221 Total)

Language Patterns Tier 1 Tier 2
iOS/Swift 34 16 18
TypeScript/React/Vue 50 25 25
Android/Kotlin 31 12 19
Python 26 12 14
Ruby/Rails 26 12 14
Go 26 12 14
Rust 28 14 14

✅ v2.9.0 - Dependency Analysis (Complete)

/atlas.deps Command

完成日期：2025-12-12 評分：Grade A+ (9.7/10)

核心功能：

  • Phase 0 規則確認機制
  • Built-in rules (iOS, Android, Python)
  • WebSearch 動態規則生成
  • 純粹盤點 vs 升級模式識別

使用方式：

/atlas.deps "react"           # 分析 React 使用情況
/atlas.deps "iOS 18"          # iOS SDK 升級分析
/atlas.deps "Python 3.12"     # Python 版本升級

測試結果：

  • 4 場景測試，100% 準確率 (42/42 樣本)
  • Production Ready

📅 v3.0 Planning (Next)

Priority P0 - Must Do

1. Language Expansion

Goal: Add 60+ patterns for 2 more languages

Candidates (choose 2):

Language Use Case Difficulty
Go Backend, CLI, K8s Medium
Rust Systems, WASM High
Ruby Rails, Scripts Low
PHP Laravel, WordPress Low

Recommendation: Start with Go + Ruby (broader coverage, lower risk)

2. /atlas.flow Improvements

Based on P0-A implementation (2025-12-01):

Feature Impact Effort
AST analysis High accuracy High
Import graph Cross-file tracing Medium
Pattern learning Project-specific Medium

Priority P1 - Should Do

3. SourceAtlas Monitor

Concept: Continuous health tracking

MVP Features:

  • Weekly health snapshot
  • Hotspot trend tracking
  • Bus factor alerts
  • Technical debt score

Decision: Evaluate after v2.9 user feedback

4. User Feedback Collection

  • Publish release notes
  • Create feedback form
  • Track real usage
  • Identify top pain points

Priority P2 - Nice to Have

  • Performance dashboard
  • Pattern statistics
  • Cross-repo analysis
  • /atlas.standup - GitLab MR integration

📊 Progress Tracking

Completed Milestones ✅

Date Milestone Impact
2025-12-20 221 patterns 7 language support (+ Ruby, Go, Rust)
2025-12-12 v2.9.0 Release /atlas.deps + Model 優化
2025-12-06 v2.8.1 Release Constitution v1.1 + Handoffs
2025-12-05 v2.8.0 Release Constitution v1.0 + Monorepo
2025-12-01 v2.7.0 Release 6 commands + /atlas.flow
2025-11-30 /atlas.history Git temporal analysis
2025-11-30 141 patterns 4 language support
2025-11-25 /atlas.impact Change analysis
2025-11-22 v1.0 Complete Methodology validated
2025-11-20 YAML Decision Standard > optimization

In Progress 🔵

  • User feedback collection

Upcoming 📋

  • /atlas.flow AST integration
  • Additional language patterns (C#, Java, etc.)

🎓 Key Learnings

From v1.0 to v2.7.0:

  1. Information Theory Works: <5% scan achieves 70-80% understanding
  2. Scale Awareness Matters: Different project sizes need different strategies
  3. Standard > Optimization: YAML ecosystem > 14% token savings
  4. Language-Specific Patterns: Generic patterns don't achieve high accuracy
  5. Zero-Parameter Design: Better portability across AI tools
  6. Political Sensitivity: "Recent Contributors" > "Ownership %"
  7. Confidence Scoring: Helps users trust results appropriately

🔧 Technical Debt

Resolved ✅

  • Plugin sync (4 → 6 commands)
  • PROMPTS.md update
  • Version unification
  • Vue directive pattern fix
  • Path-based patterns removal

Remaining

  • Linux compatibility testing
  • Performance benchmarking
  • Error message improvements

📈 Success Metrics

v2.8.1 (Achieved) ✅

  • 7 core commands (6 + deps in progress)
  • 141 patterns
  • Constitution v1.1
  • Handoffs 原則

v2.9.0 (Achieved) ✅

  • /atlas.deps command complete
  • Library upgrade scenario covered
  • Breaking change detection
  • Migration checklist generation

v2.9.x (Achieved) ✅

  • 221 patterns (7 languages)
  • Ruby/Rails support (26 patterns)
  • Go support (26 patterns)
  • Rust support (28 patterns)

v3.0.0 (Future Targets)

  • 200+ patterns - ✅ Achieved (221)
  • 6+ languages supported - ✅ Achieved (7)
  • AST-based flow analysis
  • User satisfaction >4/5

Long-term Vision

  • 300+ patterns (10+ languages)
  • Real-time monitoring
  • IDE plugin integration
  • Team collaboration features

Next Review: Weekly on Sunday Contact: Check issues at https://github.com/lis186/SourceAtlas