From sdlc-toolkit
Establish technical foundation for a new project. Proactively suggests stack-appropriate decisions including project structure. Creates .claude/rules/tech-stack.md with project conventions. Triggers: "foundation", "tech stack", "setup project", "project structure"
How this skill is triggered — by the user, by Claude, or both
Slash command
/sdlc-toolkit:foundationThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Establish technical foundation before writing PRDs. Proactively suggests best practices for the chosen stack.
Establish technical foundation before writing PRDs. Proactively suggests best practices for the chosen stack.
When to use: Greenfield projects, or when starting a major new component. PRD skill will suggest this automatically if system-context is empty and no tech-stack.md exists.
.claude/rules/tech-stack.md — rules for Claude to follow (auto-loaded)docs/system-context.md — updated with Tech Stack sectionADRs are created separately via /sdlc-toolkit:adr if the user wants detailed documentation.
.claude/rules/tech-stack.md already exists — if yes, ask if user wants to update or skipdocs/system-context.md if it exists — understand current state< 5 endpoints → suggest MVP structure (simple, flat)> 5 endpoints → suggest Scalable structure (DDD-lite, bounded contexts)users/tests/test_service.pytests/ foldertests/ folderBased on the chosen language/framework, PROACTIVELY SUGGEST a complete stack. Use templates/tech-stack-presets.md as reference:
| Stack | Suggested Preset |
|---|---|
| FastAPI | SQLModel, pytest-asyncio, Pydantic v2, Alembic |
| Django | Django ORM, pytest-django, DRF |
| Express | Prisma or TypeORM, Jest, Zod |
| Go | sqlc or GORM, go test, chi/gin |
| Spring Boot | JPA/Hibernate, JUnit 5, Flyway |
Walk through each category, confirming or adjusting:
.claude/rules/tech-stack.md using templates/tech-stack-rules.md
docs/system-context.md:
/sdlc-toolkit:adrnpx claudepluginhub youarenext/sdlc-toolkit --plugin sdlc-toolkitOpinionated tech stack recommendations and settled library references. Runs parallel researcher agents to compare candidates and emit a stack report + ADRs for greenfield projects, or routes direct references for coding with settled defaults.
Interactively interviews users to determine a new project's tech stack, generates a dev-context compatible context file, and with approval scaffolds project files.
Auto-detects tech stack in new/unfamiliar codebases, verifies build/test/lint tooling, documents code patterns, and scaffolds Architecture Decision Records.