Files
claude-skills-reference/product-team/saas-scaffolder/references/tech-stack-comparison.md
Alireza Rezvani a68ae3a05e Dev (#305)
* chore: update gitignore for audit reports and playwright cache

* fix: add YAML frontmatter (name + description) to all SKILL.md files

- Added frontmatter to 34 skills that were missing it entirely (0% Tessl score)
- Fixed name field format to kebab-case across all 169 skills
- Resolves #284

* chore: sync codex skills symlinks [automated]

* fix: optimize 14 low-scoring skills via Tessl review (#290)

Tessl optimization: 14 skills improved from ≤69% to 85%+. Closes #285, #286.

* chore: sync codex skills symlinks [automated]

* fix: optimize 18 skills via Tessl review + compliance fix (closes #287) (#291)

Phase 1: 18 skills optimized via Tessl (avg 77% → 95%). Closes #287.

* feat: add scripts and references to 4 prompt-only skills + Tessl optimization (#292)

Phase 2: 3 new scripts + 2 reference files for prompt-only skills. Tessl 45-55% → 94-100%.

* feat: add 6 agents + 5 slash commands for full coverage (v2.7.0) (#293)

Phase 3: 6 new agents (all 9 categories covered) + 5 slash commands.

* fix: Phase 5 verification fixes + docs update (#294)

Phase 5 verification fixes

* chore: sync codex skills symlinks [automated]

* fix: marketplace audit — all 11 plugins validated by Claude Code (#295)

Marketplace audit: all 11 plugins validated + installed + tested in Claude Code

* fix: restore 7 removed plugins + revert playwright-pro name to pw

Reverts two overly aggressive audit changes:
- Restored content-creator, demand-gen, fullstack-engineer, aws-architect,
  product-manager, scrum-master, skill-security-auditor to marketplace
- Reverted playwright-pro plugin.json name back to 'pw' (intentional short name)

* refactor: split 21 over-500-line skills into SKILL.md + references (#296)

* chore: sync codex skills symlinks [automated]

* docs: update all documentation with accurate counts and regenerated skill pages

- Update skill count to 170, Python tools to 213, references to 314 across all docs
- Regenerate all 170 skill doc pages from latest SKILL.md sources
- Update CLAUDE.md with v2.1.1 highlights, accurate architecture tree, and roadmap
- Update README.md badges and overview table
- Update marketplace.json metadata description and version
- Update mkdocs.yml, index.md, getting-started.md with correct numbers

* fix: add root-level SKILL.md and .codex/instructions.md to all domains (#301)

Root cause: CLI tools (ai-agent-skills, agent-skills-cli) look for SKILL.md
at the specified install path. 7 of 9 domain directories were missing this
file, causing "Skill not found" errors for bundle installs like:
  npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team

Fix:
- Add root-level SKILL.md with YAML frontmatter to 7 domains
- Add .codex/instructions.md to 8 domains (for Codex CLI discovery)
- Update INSTALLATION.md with accurate skill counts (53→170)
- Add troubleshooting entry for "Skill not found" error

All 9 domains now have: SKILL.md + .codex/instructions.md + plugin.json

Closes #301

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add Gemini CLI + OpenClaw support, fix Codex missing 25 skills

Gemini CLI:
- Add GEMINI.md with activation instructions
- Add scripts/gemini-install.sh setup script
- Add scripts/sync-gemini-skills.py (194 skills indexed)
- Add .gemini/skills/ with symlinks for all skills, agents, commands
- Remove phantom medium-content-pro entries from sync script
- Add top-level folder filter to prevent gitignored dirs from leaking

Codex CLI:
- Fix sync-codex-skills.py missing "engineering" domain (25 POWERFUL skills)
- Regenerate .codex/skills-index.json: 124 → 149 skills
- Add 25 new symlinks in .codex/skills/

OpenClaw:
- Add OpenClaw installation section to INSTALLATION.md
- Add ClawHub install + manual install + YAML frontmatter docs

Documentation:
- Update INSTALLATION.md with all 4 platforms + accurate counts
- Update README.md: "three platforms" → "four platforms" + Gemini quick start
- Update CLAUDE.md with Gemini CLI support in v2.1.1 highlights
- Update SKILL-AUTHORING-STANDARD.md + SKILL_PIPELINE.md with Gemini steps
- Add OpenClaw + Gemini to installation locations reference table

Marketplace: all 18 plugins validated — sources exist, SKILL.md present

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(product,pm): world-class product & PM skills audit — 6 scripts, 5 agents, 7 commands, 23 references/assets

Phase 1 — Agent & Command Foundation:
- Rewrite cs-project-manager agent (55→515 lines, 4 workflows, 6 skill integrations)
- Expand cs-product-manager agent (408→684 lines, orchestrates all 8 product skills)
- Add 7 slash commands: /rice, /okr, /persona, /user-story, /sprint-health, /project-health, /retro

Phase 2 — Script Gap Closure (2,779 lines):
- jira-expert: jql_query_builder.py (22 patterns), workflow_validator.py
- confluence-expert: space_structure_generator.py, content_audit_analyzer.py
- atlassian-admin: permission_audit_tool.py
- atlassian-templates: template_scaffolder.py (Confluence XHTML generation)

Phase 3 — Reference & Asset Enrichment:
- 9 product references (competitive-teardown, landing-page-generator, saas-scaffolder)
- 6 PM references (confluence-expert, atlassian-admin, atlassian-templates)
- 7 product assets (templates for PRD, RICE, sprint, stories, OKR, research, design system)
- 1 PM asset (permission_scheme_template.json)

Phase 4 — New Agents:
- cs-agile-product-owner, cs-product-strategist, cs-ux-researcher

Phase 5 — Integration & Polish:
- Related Skills cross-references in 8 SKILL.md files
- Updated product-team/CLAUDE.md (5→8 skills, 6→9 tools, 4 agents, 5 commands)
- Updated project-management/CLAUDE.md (0→12 scripts, 3 commands)
- Regenerated docs site (177 pages), updated homepage and getting-started

Quality audit: 31 files reviewed, 29 PASS, 2 fixed (copy-frameworks.md, governance-framework.md)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: audit and repair all plugins, agents, and commands

- Fix 12 command files: correct CLI arg syntax, script paths, and usage docs
- Fix 3 agents with broken script/reference paths (cs-content-creator,
  cs-demand-gen-specialist, cs-financial-analyst)
- Add complete YAML frontmatter to 5 agents (cs-growth-strategist,
  cs-engineering-lead, cs-senior-engineer, cs-financial-analyst,
  cs-quality-regulatory)
- Fix cs-ceo-advisor related agent path
- Update marketplace.json metadata counts (224 tools, 341 refs, 14 agents,
  12 commands)

Verified: all 19 scripts pass --help, all 14 agent paths resolve, mkdocs
builds clean.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: repair 25 Python scripts failing --help across all domains

- Fix Python 3.10+ syntax (float | None → Optional[float]) in 2 scripts
- Add argparse CLI handling to 9 marketing scripts using raw sys.argv
- Fix 10 scripts crashing at module level (wrap in __main__, add argparse)
- Make yaml/prefect/mcp imports conditional with stdlib fallbacks (4 scripts)
- Fix f-string backslash syntax in project_bootstrapper.py
- Fix -h flag conflict in pr_analyzer.py
- Fix tech-debt.md description (score → prioritize)

All 237 scripts now pass python3 --help verification.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(product-team): close 3 verified gaps in product skills

- Fix competitive-teardown/SKILL.md: replace broken references
  DATA_COLLECTION.md → references/data-collection-guide.md and
  TEMPLATES.md → references/analysis-templates.md (workflow was broken
  at steps 2 and 4)

- Upgrade landing_page_scaffolder.py: add TSX + Tailwind output format
  (--format tsx) matching SKILL.md promise of Next.js/React components.
  4 design styles (dark-saas, clean-minimal, bold-startup, enterprise).
  TSX is now default; HTML preserved via --format html

- Rewrite README.md: fix stale counts (was 5 skills/15+ tools, now
  accurately shows 8 skills/9 tools), remove 7 ghost scripts that
  never existed (sprint_planner.py, velocity_tracker.py, etc.)

- Fix tech-debt.md description (score → prioritize)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* release: v2.1.2 — landing page TSX output, brand voice integration, docs update

- Landing page generator defaults to Next.js TSX + Tailwind CSS (4 design styles)
- Brand voice analyzer integrated into landing page generation workflow
- CHANGELOG, CLAUDE.md, README.md updated for v2.1.2
- All 13 plugin.json + marketplace.json bumped to 2.1.2
- Gemini/Codex skill indexes re-synced
- Backward compatible: --format html preserved, no breaking changes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: alirezarezvani <5697919+alirezarezvani@users.noreply.github.com>
Co-authored-by: Leo <leo@openclaw.ai>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 09:48:49 +01:00

8.8 KiB

Technology Stack Comparison

Overview

Choosing the right technology stack is one of the most impactful early decisions for a SaaS product. This comparison covers the most popular options across frontend, backend, database, and caching layers, with decision criteria for each.

Frontend Frameworks

Next.js (React)

Strengths:

  • Largest ecosystem and community
  • Excellent developer tooling and documentation
  • Server-side rendering (SSR) and static generation (SSG) built in
  • Vercel deployment makes hosting trivial
  • App Router with React Server Components for optimal performance
  • Rich component library ecosystem (shadcn/ui, Radix, Chakra)

Weaknesses:

  • React learning curve (hooks, state management, rendering model)
  • Bundle size can grow without discipline
  • Vercel lock-in concerns for advanced features
  • Frequent major version changes

Best for: Most SaaS products, teams with React experience, SEO-important pages

Remix (React)

Strengths:

  • Web standards focused (forms, HTTP, progressive enhancement)
  • Excellent data loading patterns (loaders/actions)
  • Built-in error boundaries and optimistic UI
  • Works without JavaScript enabled
  • Strong TypeScript support
  • Deployable anywhere (not tied to specific platform)

Weaknesses:

  • Smaller ecosystem than Next.js
  • Fewer deployment guides and hosting templates
  • Less community content and tutorials
  • Now merged into React Router v7 (transition period)

Best for: Data-heavy applications, teams valuing web standards, progressive enhancement needs

SvelteKit (Svelte)

Strengths:

  • Smallest bundle sizes (compiler-based, no virtual DOM)
  • Simplest learning curve among frameworks
  • Built-in state management (reactive declarations)
  • Excellent performance out of the box
  • Growing ecosystem and community
  • First-class TypeScript support

Weaknesses:

  • Smaller ecosystem and component library selection
  • Fewer developers in hiring pool
  • Less enterprise adoption (harder to find case studies)
  • Fewer third-party integrations

Best for: Performance-critical applications, small teams wanting simplicity, developer experience priority

Frontend Decision Criteria

Criterion Next.js Remix SvelteKit
Ecosystem Size Large Medium Growing
Learning Curve Medium Medium Low
Performance Good Good Excellent
SSR/SSG Excellent Good Good
Hiring Pool Large Small Small
Bundle Size Medium Small Smallest
TypeScript Excellent Excellent Excellent
Deployment Flexibility Medium High High

Backend Frameworks

Node.js (Express / Fastify / NestJS)

Strengths:

  • Same language as frontend (JavaScript/TypeScript full-stack)
  • Massive npm ecosystem
  • NestJS provides enterprise patterns (DI, modules, decorators)
  • Excellent for I/O-heavy workloads
  • Large community and hiring pool
  • Great for real-time features (WebSockets)

Weaknesses:

  • Single-threaded (CPU-intensive tasks require workers)
  • Callback/async complexity
  • npm dependency security concerns
  • Less suited for computational workloads

Best for: Full-stack TypeScript teams, real-time applications, API-heavy products

Python (FastAPI / Django)

Strengths:

  • FastAPI: Modern, fast, automatic OpenAPI docs, async support
  • Django: Batteries included (admin, ORM, auth, migrations)
  • Excellent for data processing and ML integration
  • Clean, readable syntax
  • Strong ecosystem for analytics and data work
  • Large hiring pool across web and data roles

Weaknesses:

  • Slower runtime than Go/Rust (mitigated by async in FastAPI)
  • GIL limits true parallelism (multiprocessing required)
  • Django can feel heavyweight for microservices
  • Deployment can be more complex (WSGI/ASGI setup)

Best for: Data-heavy products, ML integration, rapid prototyping, admin-heavy applications

Go (Gin / Echo / Fiber)

Strengths:

  • Excellent performance (compiled, concurrent by design)
  • Low memory footprint
  • Simple deployment (single binary, no runtime)
  • Built-in concurrency (goroutines, channels)
  • Strong standard library
  • Fast compilation

Weaknesses:

  • Smaller web ecosystem than Node.js or Python
  • More verbose for CRUD operations
  • Error handling verbosity
  • Fewer ORM options (GORM is the main choice)
  • Steeper learning curve for teams from dynamic languages

Best for: High-throughput APIs, microservices, infrastructure tooling, performance-critical backends

Backend Decision Criteria

Criterion Node.js Python Go
Performance Good Moderate Excellent
Developer Productivity High High Medium
Ecosystem Largest Large Medium
Hiring Pool Large Large Medium
Full-Stack Synergy Excellent None None
Data/ML Integration Medium Excellent Low
Concurrency Event Loop Async/Threads Goroutines
Deployment Simplicity Medium Medium High

Database

PostgreSQL

Strengths:

  • ACID compliant with excellent reliability
  • Rich feature set (JSON, full-text search, GIS, arrays)
  • Extensible (custom types, functions, extensions like PostGIS, pgvector)
  • Strong community and tooling
  • Excellent for complex queries and analytics
  • Free and open source with managed options (AWS RDS, Supabase, Neon)

Weaknesses:

  • Horizontal scaling requires effort (Citus, partitioning)
  • More complex initial setup than MySQL
  • VACUUM maintenance at high write volumes
  • Slightly slower for simple read-heavy workloads vs MySQL

Best for: Most SaaS applications (recommended default), complex data models, JSON workloads

MySQL

Strengths:

  • Proven at massive scale (Meta, Uber, Shopify)
  • Simpler replication setup
  • Faster for simple read-heavy workloads
  • PlanetScale offers serverless MySQL with branching
  • Wide hosting support

Weaknesses:

  • Fewer advanced features than PostgreSQL
  • Weaker JSON support
  • Less extensible
  • InnoDB limitations for certain workloads

Best for: Read-heavy applications, teams with MySQL expertise, PlanetScale users

Database Decision Criteria

Criterion PostgreSQL MySQL
Feature Richness Excellent Good
JSON Support Excellent Moderate
Replication Good Good
Horizontal Scale Moderate Good (PlanetScale)
Community Excellent Excellent
Managed Options Many Many
Learning Curve Medium Low
Default Choice Yes Situational

Caching Layer

Redis

Strengths:

  • Rich data structures (strings, hashes, lists, sets, sorted sets, streams)
  • Pub/Sub for real-time messaging
  • Lua scripting for atomic operations
  • Persistence options (RDB, AOF)
  • Cluster mode for horizontal scaling
  • Used for caching, sessions, queues, rate limiting, leaderboards

Weaknesses:

  • Memory-bound (dataset must fit in RAM)
  • Single-threaded command processing
  • Licensing changes (Redis 7.4+ source-available)
  • Cluster mode adds complexity

Best for: Most SaaS applications (recommended default), session management, rate limiting, queues

Memcached

Strengths:

  • Simplest possible key-value cache
  • Multi-threaded (better CPU utilization for simple operations)
  • Lower memory overhead per key
  • Predictable performance characteristics
  • Battle-tested at scale

Weaknesses:

  • No data structures (strings only)
  • No persistence
  • No pub/sub or scripting
  • No built-in clustering (client-side sharding)
  • Limited eviction policies

Best for: Pure caching use cases, simple key-value lookups, memory efficiency priority

Cache Decision Criteria

Criterion Redis Memcached
Data Structures Rich Strings Only
Persistence Yes No
Pub/Sub Yes No
Multi-Threading No (I/O threads in v6) Yes
Use Cases Many Caching Only
Memory Efficiency Good Better
Default Choice Yes Rarely

B2B SaaS (Most Common)

  • Frontend: Next.js + TypeScript + shadcn/ui
  • Backend: Node.js (NestJS) or Python (FastAPI)
  • Database: PostgreSQL
  • Cache: Redis
  • Auth: Auth0 or Clerk
  • Payments: Stripe

Developer Tool / API Product

  • Frontend: Next.js or SvelteKit
  • Backend: Go (Gin) or Node.js (Fastify)
  • Database: PostgreSQL
  • Cache: Redis
  • Auth: Custom JWT + API Keys
  • Docs: Mintlify or ReadMe

Data-Heavy / Analytics Product

  • Frontend: Next.js
  • Backend: Python (FastAPI)
  • Database: PostgreSQL + ClickHouse (analytics)
  • Cache: Redis
  • Processing: Celery or Temporal
  • Visualization: Custom or embedded (Metabase)

Real-Time / Collaboration Product

  • Frontend: Next.js or SvelteKit
  • Backend: Node.js (Fastify) + WebSockets
  • Database: PostgreSQL + Redis (pub/sub)
  • Cache: Redis
  • Real-Time: Socket.io or Liveblocks
  • CRDT: Yjs or Automerge (for collaborative editing)