Individual skill

typescript-project

Modern TypeScript project architecture guide for 2025. Use when creating new TS projects, setting up configurations, or designing project structure. Covers tech stack selection, layered architecture, and best practices.

skills/typescript-project/SKILL.md

Read pinned source

Source commit 238e07625aeca5bcf0d6f7cb3e2d07f94c717194

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: No
Skill scan complete: No
Observed behavior: Network or broad shell
Last checked: Nov 11, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 290
Repository last updated: Nov 4, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

ai-agents Repository topic
ai-coding-assistant Repository topic
claude Repository topic
claude-code Repository topic
developer-tools Repository topic
productivity Repository topic
automation Repository topic
agent-skills Repository topic
code-review Repository topic
prompt-engineering Repository topic
engineering Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

SKILL.mdcore · 13,212 bytes
SKILL.mdcore · 13,212 bytes
SKILL.mdcore · 13,212 bytes
SKILL.mdcore · 13,212 bytes
reference/architecture.mddoc · 8,575 bytes
reference/patterns.mddoc · 12,325 bytes
reference/tech-stack.mddoc · 9,647 bytes
templates/project/biome.jsonasset · 566 bytes
templates/project/package.jsonruns · 735 bytes
templates/project/src/adapters/in-memory.repository.tsruns · 909 bytes
templates/project/src/adapters/llm.adapter.tsruns · 2,671 bytes
templates/project/src/index.tsruns · 595 bytes
templates/project/src/lib/config.tsruns · 1,550 bytes
templates/project/src/lib/errors.tsruns · 1,532 bytes
templates/project/src/lib/index.tsruns · 148 bytes
templates/project/src/lib/logger.tsruns · 2,243 bytes
templates/project/src/lib/types.tsruns · 947 bytes
templates/project/src/services/example.service.tsruns · 2,404 bytes
templates/project/tests/example.service.test.tsruns · 3,594 bytes
templates/project/tsconfig.jsonasset · 584 bytes

Read excerpt

# TypeScript Project Architecture

## Core Principles

- **Type safety first** — Strict mode, no `any`, Zod for runtime validation
- **ESM native** — ES Modules by default, Node 22+ / Bun
- **Layered architecture** — Separate lib/services/adapters
- **200-line limit** — No file exceeds 200 lines (see elegant-architecture skill)
- **Test reality** — Vitest/Bun test, minimal mocks
- **No backwards compatibility** — Delete, don't deprecate. Change directly, no shims
- **LiteLLM for LLM APIs** — Use LiteLLM proxy for all LLM integrations, unless specific SDK required

## Gotchas

- Bun, Zod, directory layout and LiteLLM choices are activation observations, not proof of