mirror of
https://github.com/complexcaresolutions/cms.c2sgmbh.git
synced 2026-03-17 22:04:10 +00:00
Martin Porwoll
77f70876f4
- Add .claude/ configuration (agents, commands, hooks, get-shit-done workflows) - Add prompts/ directory with development planning documents - Add scripts/setup-tenants/ with tenant configuration - Add docs/screenshots/ - Remove obsolete phase2.2-corrections-report.md - Update pnpm-lock.yaml - Update detect-secrets.sh to ignore setup.sh (env var usage, not secrets) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
120 lines
3 KiB
Markdown
120 lines
3 KiB
Markdown
# Stack Research Template
|
|
|
|
Template for `.planning/research/STACK.md` — recommended technologies for the project domain.
|
|
|
|
<template>
|
|
|
|
```markdown
|
|
# Stack Research
|
|
|
|
**Domain:** [domain type]
|
|
**Researched:** [date]
|
|
**Confidence:** [HIGH/MEDIUM/LOW]
|
|
|
|
## Recommended Stack
|
|
|
|
### Core Technologies
|
|
|
|
| Technology | Version | Purpose | Why Recommended |
|
|
|------------|---------|---------|-----------------|
|
|
| [name] | [version] | [what it does] | [why experts use it for this domain] |
|
|
| [name] | [version] | [what it does] | [why experts use it for this domain] |
|
|
| [name] | [version] | [what it does] | [why experts use it for this domain] |
|
|
|
|
### Supporting Libraries
|
|
|
|
| Library | Version | Purpose | When to Use |
|
|
|---------|---------|---------|-------------|
|
|
| [name] | [version] | [what it does] | [specific use case] |
|
|
| [name] | [version] | [what it does] | [specific use case] |
|
|
| [name] | [version] | [what it does] | [specific use case] |
|
|
|
|
### Development Tools
|
|
|
|
| Tool | Purpose | Notes |
|
|
|------|---------|-------|
|
|
| [name] | [what it does] | [configuration tips] |
|
|
| [name] | [what it does] | [configuration tips] |
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
# Core
|
|
npm install [packages]
|
|
|
|
# Supporting
|
|
npm install [packages]
|
|
|
|
# Dev dependencies
|
|
npm install -D [packages]
|
|
```
|
|
|
|
## Alternatives Considered
|
|
|
|
| Recommended | Alternative | When to Use Alternative |
|
|
|-------------|-------------|-------------------------|
|
|
| [our choice] | [other option] | [conditions where alternative is better] |
|
|
| [our choice] | [other option] | [conditions where alternative is better] |
|
|
|
|
## What NOT to Use
|
|
|
|
| Avoid | Why | Use Instead |
|
|
|-------|-----|-------------|
|
|
| [technology] | [specific problem] | [recommended alternative] |
|
|
| [technology] | [specific problem] | [recommended alternative] |
|
|
|
|
## Stack Patterns by Variant
|
|
|
|
**If [condition]:**
|
|
- Use [variation]
|
|
- Because [reason]
|
|
|
|
**If [condition]:**
|
|
- Use [variation]
|
|
- Because [reason]
|
|
|
|
## Version Compatibility
|
|
|
|
| Package A | Compatible With | Notes |
|
|
|-----------|-----------------|-------|
|
|
| [package@version] | [package@version] | [compatibility notes] |
|
|
|
|
## Sources
|
|
|
|
- [Context7 library ID] — [topics fetched]
|
|
- [Official docs URL] — [what was verified]
|
|
- [Other source] — [confidence level]
|
|
|
|
---
|
|
*Stack research for: [domain]*
|
|
*Researched: [date]*
|
|
```
|
|
|
|
</template>
|
|
|
|
<guidelines>
|
|
|
|
**Core Technologies:**
|
|
- Include specific version numbers
|
|
- Explain why this is the standard choice, not just what it does
|
|
- Focus on technologies that affect architecture decisions
|
|
|
|
**Supporting Libraries:**
|
|
- Include libraries commonly needed for this domain
|
|
- Note when each is needed (not all projects need all libraries)
|
|
|
|
**Alternatives:**
|
|
- Don't just dismiss alternatives
|
|
- Explain when alternatives make sense
|
|
- Helps user make informed decisions if they disagree
|
|
|
|
**What NOT to Use:**
|
|
- Actively warn against outdated or problematic choices
|
|
- Explain the specific problem, not just "it's old"
|
|
- Provide the recommended alternative
|
|
|
|
**Version Compatibility:**
|
|
- Note any known compatibility issues
|
|
- Critical for avoiding debugging time later
|
|
|
|
</guidelines>
|