gh-jschulte-claude-plugins-stackshift/skills/analyze/operations/detect-stack.md

Tech Stack Detection

Comprehensive commands for detecting programming languages, frameworks, and build systems.

Overview

Run all detection commands in parallel to identify the technology stack. Missing files are normal - they just mean that technology isn't used.

---

Detection Commands

Execute these commands to detect the primary language and framework:

# Get current directory context
pwd

# Show directory contents
ls -la

# Get git repository info
git remote -v 2>/dev/null

# Language/Framework Detection (run all in parallel)
cat package.json 2>/dev/null          # Node.js/JavaScript/TypeScript
cat composer.json 2>/dev/null         # PHP
cat requirements.txt 2>/dev/null      # Python (pip)
cat Pipfile 2>/dev/null               # Python (pipenv)
cat pyproject.toml 2>/dev/null        # Python (poetry)
cat Gemfile 2>/dev/null               # Ruby
cat pom.xml 2>/dev/null               # Java/Maven
cat build.gradle 2>/dev/null          # Java/Gradle
cat Cargo.toml 2>/dev/null            # Rust
cat go.mod 2>/dev/null                # Go
cat pubspec.yaml 2>/dev/null          # Dart/Flutter
cat mix.exs 2>/dev/null               # Elixir
find . -maxdepth 2 -name "*.csproj" 2>/dev/null   # .NET/C#
find . -maxdepth 2 -name "*.sln" 2>/dev/null      # .NET Solution

---

Framework-Specific Detection

JavaScript/TypeScript Frameworks

If package.json exists, look for these framework indicators:

{
  "dependencies": {
    "react": "...",           // React
    "next": "...",            // Next.js
    "vue": "...",             // Vue.js
    "nuxt": "...",            // Nuxt.js
    "@angular/core": "...",   // Angular
    "svelte": "...",          // Svelte
    "express": "...",         // Express.js (backend)
    "fastify": "...",         // Fastify (backend)
    "nestjs": "..."           // NestJS (backend)
  }
}

Python Frameworks

Look for these imports or dependencies:

• django - Django web framework
• flask - Flask micro-framework
• fastapi - FastAPI
• pyramid - Pyramid
• tornado - Tornado

Ruby Frameworks

In Gemfile:

• rails - Ruby on Rails
• sinatra - Sinatra
• hanami - Hanami

PHP Frameworks

In composer.json:

• laravel/framework - Laravel
• symfony/symfony - Symfony
• slim/slim - Slim

Java Frameworks

In pom.xml or build.gradle:

• spring-boot - Spring Boot
• quarkus - Quarkus
• micronaut - Micronaut

---

Database Detection

Look for database-related dependencies or configuration:

SQL Databases

# PostgreSQL indicators
grep -r "postgres" package.json composer.json requirements.txt 2>/dev/null
ls -la prisma/ 2>/dev/null   # Prisma ORM

# MySQL indicators
grep -r "mysql" package.json composer.json requirements.txt 2>/dev/null

# SQLite
find . -name "*.db" -o -name "*.sqlite" 2>/dev/null

NoSQL Databases

# MongoDB
grep -r "mongodb\|mongoose" package.json requirements.txt 2>/dev/null

# Redis
grep -r "redis" package.json requirements.txt 2>/dev/null

# DynamoDB (AWS)
grep -r "dynamodb\|@aws-sdk" package.json requirements.txt 2>/dev/null

---

Infrastructure Detection

Cloud Providers

# AWS
find . -name "*.tf" -o -name "terraform.tfvars" 2>/dev/null  # Terraform
find . -name "serverless.yml" 2>/dev/null                     # Serverless Framework
find . -name "cdk.json" 2>/dev/null                           # AWS CDK
grep -r "@aws-sdk\|aws-lambda" package.json 2>/dev/null

# Azure
grep -r "@azure" package.json 2>/dev/null

# GCP
grep -r "@google-cloud" package.json 2>/dev/null

Container/Orchestration

# Docker
ls -la Dockerfile docker-compose.yml 2>/dev/null

# Kubernetes
find . -name "*.yaml" | xargs grep -l "apiVersion: apps/v1" 2>/dev/null

---

Build System Detection

Identify the build tool based on manifest files:

• package.json → npm, yarn, or pnpm (check for lock files)
• pom.xml → Maven
• build.gradle → Gradle
• Cargo.toml → Cargo (Rust)
• go.mod → Go modules
• Gemfile → Bundler
• composer.json → Composer
• requirements.txt → pip
• Pipfile → pipenv
• pyproject.toml → poetry

---

Version Extraction

Extract version numbers from manifests:

# Node.js
cat package.json | grep '"version"' | head -1

# Python
cat setup.py | grep "version=" 2>/dev/null
cat pyproject.toml | grep "version =" 2>/dev/null

# Java
cat pom.xml | grep "<version>" | head -1

# Rust
cat Cargo.toml | grep "version =" | head -1

---

Multi-Language Projects

If multiple language manifest files exist, identify:

• Primary language - The main application language (most source files)
• Secondary languages - Supporting tools, scripts, infrastructure

Example:

• Primary: TypeScript (Next.js frontend + backend)
• Secondary: Python (data processing scripts), Terraform (infrastructure)

---

Output Summary

After detection, summarize as:

## Technology Stack

### Primary Language
- TypeScript 5.2

### Frameworks & Libraries
- Next.js 14.0.3 (React framework)
- Prisma 5.6.0 (ORM)
- tRPC 10.45.0 (API)

### Build System
- npm 10.2.3

### Database
- PostgreSQL (via Prisma)

### Infrastructure
- AWS Lambda (Serverless)
- Terraform 1.6.0 (IaC)

---

Common Patterns

Full-Stack JavaScript/TypeScript

• Frontend: React/Next.js/Vue
• Backend: Express/Fastify/NestJS
• Database: PostgreSQL/MongoDB
• Infrastructure: AWS/Vercel/Netlify

Python Web App

• Framework: Django/Flask/FastAPI
• Database: PostgreSQL/MySQL
• Cache: Redis
• Infrastructure: AWS/GCP

Ruby on Rails

• Framework: Rails
• Database: PostgreSQL
• Cache: Redis
• Infrastructure: Heroku/AWS

Java Enterprise

• Framework: Spring Boot
• Database: PostgreSQL/Oracle
• Message Queue: RabbitMQ/Kafka
• Infrastructure: Kubernetes