* 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>
279 lines
8.8 KiB
Markdown
279 lines
8.8 KiB
Markdown
# 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 |
|
|
|
|
## Recommended Stacks by Product Type
|
|
|
|
### 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)
|