| name | stack-detection |
| description | Detects project technology stacks by analyzing package manifests, config files, directory structures, and code patterns. Produces a structured stack profile for agent adaptation. Covers technology detection, framework identification, project type analysis. |
| user-invocable | false |
Current Stack Profile
!cat .blueprint/stack-profile.json 2>/dev/null || echo "No stack profile detected yet. Run /bp:discover first."
Stack Detection
This skill provides comprehensive technology stack detection for any project. It goes beyond simple file-existence checks to analyze actual configurations, versions, and usage patterns.
When to Use
- At the start of any blueprint-dev workflow (
/blueprint-dev:bp:discover)
- When agents need to adapt their output to the project's specific stack
- When generating CLAUDE.md suggestions based on detected technologies
How It Works
Detection Layers
- Manifest Analysis: Read package managers (package.json, composer.json, Gemfile, etc.) for declared dependencies
- Config File Analysis: Read framework configs for specific settings (e.g., Next.js app router vs pages router)
- Code Pattern Analysis: Grep source files for usage patterns that confirm or refine detections
- Infrastructure Analysis: Check for Docker, CI/CD, deployment configs
Fingerprint Matching
Use the fingerprints in references/fingerprints.md to match specific technologies. Each fingerprint has:
- Primary signal: File or pattern that strongly indicates the technology
- Confirming signals: Additional evidence that increases confidence
- Version detection: How to determine the specific version in use
- Variant detection: Sub-variants (e.g., Next.js App Router vs Pages Router)
Output
Results go to .blueprint/stack-profile.json using the template in references/profile-template.md.
Key Principles
- Verify, don't guess: Only report technologies you can confirm through multiple signals
- Version matters:
react@18 and react@19 may need different agent behavior
- Conventions matter more than dependencies: How the project uses a technology is more valuable than knowing it's installed
- Fast by default: The SessionStart hook does a quick scan; deep analysis happens only when
/discover is explicitly run
