Scaffold ralph-powered TDD + team mode for fork maintenance

[qte77]

Context

This repo is a fork of hbmartin/secure-design (itself forked from superdesigndev/superdesign). Both upstream repos are stale since Oct 2025. This fork aims to revive the project with a focus on Claude Code integration, automated maintenance, and strict TDD.

Plan Summary

Phase 0: Scaffold

• Add ralph as git submodule (TDD loop engine)
• Create CLAUDE.md, AGENTS.md, .claude/rules/, Makefile
• Set up compound.env for ralph configuration

Phase 1: Cherry-Pick Sprint

• STORY-001: CC SDK integration (secure-design User cannot log in or signup superdesigndev/superdesign#97)
• STORY-002: Fix workspace detection (superdesign fix: Improve workspace detection logic superdesigndev/superdesign#76)
• STORY-003: Fix stop button + canvas delete (superdesign Fix/stop button and delete feature superdesigndev/superdesign#80)
• STORY-004: Wire up "Add Context" file picker (superdesign feature: Implement logic for 'Add Context' button superdesigndev/superdesign#75)
• STORY-005: Conditional IDE file generation (superdesign Added conditional generation of IDE & LLM specific files superdesigndev/superdesign#15)
• STORY-006: Vercel AI Gateway provider (superdesign feat: add Vercel AI Gateway provider support superdesigndev/superdesign#96)

Phase 2: Test Infrastructure

• Create src/test/ (zero test files exist currently)
• Foundation tests: core-components, llm-service, read-tool, write-edit-tools
• make validate target: typecheck + lint + compile + test

Phase 3: Ralph Loop Integration

• Autonomous TDD sprints via ralph loop
• Team mode: architect/developer/reviewer agent roles
• Worktree isolation for parallel story execution

Phase 4: Automated Maintenance (GHA Fleet)

• Weekly ralphy cycle (synthesize → PRD → TDD → writeback)
• Daily upstream sync (cross-repo-issue-sync, timeline, changelog)
• Dependabot + Snyk for deps

Phase 5: Scope Governance

• CC integration is priority 1
• Upstream cherry-picks are TDD-gated
• Architecture changes require ADR

Phase 6: MCP Support

• Extract design engine into MCP server for CC CLI usage
• Bridge VS Code extension + agent-native MCP paradigms
• Integration targets: stitch-kit, ui-mcp, screenshot-to-code

Competitive Position

Superdesign is the only OSS tool combining VS Code sidebar + text-to-UI + wireframing + CC export. Main threat is MCP-native tools (stitch-kit, ui-mcp) bypassing the extension model. Phase 6 hedges this.

References

• Plan file: superdesign-fork-ralph-tdd-scaffold.md
• Upstream: superdesigndev/superdesign (6.3k stars, abandoned)
• Leading fork: hbmartin/secure-design (93 stars, stalled)