tech-context

Establishes the technical stack, architecture constraints, and engineering principles for a software project.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/scoots31/engineering-playbook --skill tech-context-scoots31
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-context
Source: https://github.com/scoots31/engineering-playbook/tree/main/skills/tech-context
Command: npx skills add https://github.com/scoots31/engineering-playbook --skill tech-context-scoots31

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Projects often start building before the technical foundation is defined, causing design decisions, slice definitions, and done criteria to be written without knowing the actual stack, deployment path, or security requirements. This Skill captures the tech context once, before design and build, so every downstream phase is technically grounded. ## Core Features & Use Cases - Profile-Based Routing: Loads an established organizational profile (e.g., Bayer Aurora) or interviews the user to build a stack definition from scratch for a general solo project. - Structured Tech Context Document: Produces docs/tech-context.md covering the stack table, architecture constraints, engineering principles, branching model, infrastructure slices, security classification, secrets handling, and runtime configuration. - Security Classification: Classifies the project (Standard, Personal, Financial, Authentication, Multi-tenant, Confidential, Regulated) and gates production deploys behind a compliance acknowledgment when Regulated applies. - Use Case: Before designing screens for a new web app, run this Skill to confirm the frontend framework, deployment path (Railway, Render, Local Mac, etc.), observability tool, and CI/CD preference, producing a single reference document used by design review, planning, and build. ## Quick Start Ask the assistant to establish the tech context for this project before design and planning begin.

Frequently Asked Questions about tech-context

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define a tech stack before starting a software project?

Run the tech context step before design and planning. It either loads an existing organizational profile or asks targeted questions about deployment target, frontend, backend, auth, and CI/CD, then writes the answers into a docs/tech-context.md reference document.

When should tech context be established in a project workflow?

It should run after discovery and before design sprint and design review. Running it later means screens get designed without platform constraints and infrastructure slices get missed in the backlog.

What deployment platforms does the tech context support?

The internal taxonomy covers Local Mac, Cloudflare Pages/Workers, Railway, Render, Fly.io, AWS App Runner, and a no-pipeline option. Railway is recommended for first-time deployers and Render for those wanting more control.

How does security classification affect the build process?

The classification (Standard, Personal, Financial, Authentication, Multi-tenant, Confidential, Regulated) generates standing requirements such as no PII in logs or server-side tenant validation. Regulated projects require an external compliance review before production deploy.

Can I reuse a tech stack profile across multiple projects?

Yes. Organizational profiles like Bayer Aurora are stored as reusable profile files and loaded by name. Key constraints are confirmed per project, and any differences are recorded for that project only while the profile stays canonical.