Skip to content

LiorCohen/sdd / plugin/fullstack-typescript/skills/techpack-settings

techpack-settings

Verified

Component type definitions, settings schemas, directory patterns, and validation rules for the fullstack-typescript tech pack.

Techpack Settings

Component type definitions, settings schemas, directory patterns, and validation rules for the fullstack-typescript tech pack. This skill is loaded by core's project-settings skill to provide tech-pack-specific component knowledge.


Component Types

TypeDirectory PatternDescription
configcomponents/configSingleton configuration management
servercomponents/servers/{name}Node.js/Express backend (CMDO architecture)
webappcomponents/webapps/{name}React/Vite frontend (MVVM architecture)
databasecomponents/databases/{name}PostgreSQL database
contractcomponents/contracts/{name}OpenAPI 3.x specification
helmcomponents/helm_charts/{name}Kubernetes Helm chart
integration-testingcomponents/integration-testingIntegration test suite
e2e-testingcomponents/e2e-testingE2E test suite (Playwright)
cicdcomponents/cicdCI/CD pipeline (GitHub Actions)

Settings Schema by Type

Server Settings

SettingTypeDefaultDescription
server_typeapi|worker|cron|hybridapiCommunication pattern(s)
modes(api|worker|cron)[]—For hybrid: which modes (2+ required)
databasesstring[][]Database components this server uses
provides_contractsstring[][]Contracts this server implements
consumes_contractsstring[][]Contracts this server calls
helmbooleantrueWhether to generate helm chart

Impact:

  • server_type determines operator lifecycle(s)
  • databases drives DAL layer per database, config sections
  • provides_contracts drives HTTP routes, Service in helm chart
  • consumes_contracts drives API clients, config sections
  • helm: false skips helm chart scaffolding

Webapp Settings

SettingTypeDefaultDescription
contractsstring[][]Contracts this webapp uses
helmbooleantrueWhether to generate helm chart

Impact:

  • contracts drives API clients, config sections

Helm Settings

SettingTypeDefaultDescription
deploysstring—Component to deploy (required)
deploy_typeserver|webapp—Type being deployed (required)
deploy_modes(api|worker|cron)[]—For servers: which modes
ingressbooleantrueExternal HTTP access
assetsbundled|entrypointbundledFor webapps: asset strategy

Impact:

  • deploy_modes creates separate deployments for multi-mode servers
  • ingress includes/excludes ingress.yaml
  • assets determines webapp build strategy

Database Settings

SettingTypeDefaultDescription
providerpostgresqlpostgresqlDatabase provider
dedicatedbooleanfalseNeeds own DB server

Contract Settings

SettingTypeDefaultDescription
visibilitypublic|internalinternalExternal consumers allowed

Config Settings

Config component has no settings (it is a singleton).

Testing Settings

Testing components (integration-testing, e2e-testing) have no settings. Structure is driven by testing standards skills.

CI/CD Settings

CI/CD component has no settings. Structure is driven by the cicd-standards skill.


Validation Rules

  1. Config is a mandatory singleton — every project must have exactly one config component.
  2. Database references must exist — any name in a server's databases array must match an existing database component.
  3. Contract references must exist — any name in provides_contracts, consumes_contracts, or contracts must match an existing contract component.
  4. Helm deploys must reference existing component — the deploys field must reference an existing server or webapp component.
  5. Helm deploy_modes must be valid — each mode in deploy_modes must be a valid mode for the referenced server's server_type (e.g., a server with server_type: api cannot have deploy_modes: [worker]).

Naming Rules

  • Names must be lowercase
  • Use hyphens, not underscores or spaces
  • Names should be multi-word and domain-specific
    • Good: order-service, analytics-db, customer-portal, task-api
    • Avoid: api, public, primary, main, server
  • Exception: config (singleton)

Input / Output

This skill defines no input parameters or structured output.

brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 318kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 196kUpdated Claude CodeCodexVerifiedInstall