feat: Add PRDs for Atmos IDE extensions

[Benbentwo]

Summary

Add comprehensive Product Requirement Documents (PRDs) for Atmos IDE extensions ecosystem:

• VS Code Extension: 300+ features with CLI-first and optional server mode integration
• JetBrains Plugin: 500+ enterprise-grade features leveraging IntelliJ Platform capabilities
• Server Mode: REST API, WebSocket, and LSP integration for high-performance IDE support
• Implementation Roadmap: Strategic 4-phase development plan with parallel workstreams

Key Features

VS Code Extension

• Intelligent YAML editing with autocomplete and validation
• Visual dependency graphs and configuration analysis
• Real-time validation and error diagnostics
• Workflow automation and deployment integration
• AI-powered assistance and suggestions
• Team collaboration and shared workspaces

JetBrains Plugin

• Advanced refactoring with cross-file rename and impact analysis
• Deep code intelligence using PSI and custom inspections
• Configuration debugging with step-through resolution
• Enterprise features: compliance, governance, team collaboration
• VCS integration with semantic change analysis
• Performance profiling and optimization recommendations

Server Mode

• 30+ REST API endpoints covering all Atmos operations
• Real-time WebSocket events for file changes and operations
• Language Server Protocol integration for enhanced editing
• Multi-tenancy with workspace isolation and RBAC
• High availability with clustering and load balancing
• Enterprise authentication and audit logging

Implementation Strategy

• Flexible Integration: CLI-first approach with optional server mode enhancement
• Progressive Enhancement: Basic features work with CLI, advanced features leverage server
• Hybrid Architecture: Automatic detection with graceful fallback between modes
• Parallel Development: VS Code and JetBrains development can proceed simultaneously

Technical Approach

Both extensions support dual integration modes:

1. CLI-First Approach (MVP): Direct execution of Atmos CLI commands with caching
2. Server Mode Approach (Enhanced): WebSocket and REST API integration for real-time features
3. Hybrid Approach (Recommended): Automatic server detection with intelligent fallback

Test plan

• Review PRD completeness and technical accuracy
• Validate feature categorization and prioritization
• Confirm implementation phases and timeline estimates
• Assess CLI command requirements and server API specifications
• Verify enterprise feature requirements and compliance needs

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Added comprehensive planning documentation for Atmos IDE extensions, detailing implementation roadmaps, design principles, and phased delivery strategies for VS Code and JetBrains plugins
  • Documented feature specifications, architectural approaches, and integration patterns for future IDE extension development

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[mergify]

Warning

This PR exceeds the recommended limit of 1,000 lines.

Large PRs are difficult to review and may be rejected due to their size.

Please verify that this PR does not address multiple issues.
Consider refactoring it into smaller, more focused PRs to facilitate a smoother review process.

[github-actions]

Dependency Review

✅ No vulnerabilities or license issues found.

Scanned Files

None

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 74.72%. Comparing base (bda1aab) to head (4e704e0).
⚠️ Report is 7 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1983   +/-   ##
=======================================
  Coverage   74.72%   74.72%           
=======================================
  Files         777      777           
  Lines       71171    71171           
=======================================
+ Hits        53180    53184    +4     
  Misses      14525    14525           
+ Partials     3466     3462    -4     

Flag	Coverage Δ
unittests	74.72% <ø> (+<0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 7 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[coderabbitai]

📝 Walkthrough

Walkthrough

Three new Product Requirements Documents establish the implementation roadmap and detailed specifications for Atmos IDE Extensions. Documents cover VS Code extension, JetBrains plugin, and foundational CLI integration architecture, including design principles, phased delivery plans, feature sets, and technical integration patterns across all platforms.

Changes

Cohort / File(s)

Summary

IDE Extensions PRD Documentation docs/prd/ide-extensions-roadmap.md, docs/prd/vscode-extension.md, docs/prd/jetbrains-plugin.md

Three comprehensive specification documents outlining the complete roadmap for Atmos IDE Extensions. Covers phased implementation strategy (Foundation, Platform-specific, Advanced Features, Community Growth), design principles, CLI integration requirements, architecture patterns, feature sets, and technical considerations. Includes code samples in TypeScript and Kotlin demonstrating integration approaches.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Suggested labels

no-release

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check	✅ Passed	The title 'feat: Add PRDs for Atmos IDE extensions' clearly and specifically describes the main change—adding comprehensive Product Requirement Documents for IDE extensions.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/ide-extensions-prds

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[osterman]

This needs more refinement before we can move forward. Right now, the PRDs feel closer to a raw set of bullet points and don’t yet follow the structure we use in our other PRDs. I’d recommend reviewing a few existing PRDs and revising these to match that format.