Imported from dirien/stop-building-portals-start-building-conversations (slides/.opencode/skills/agent-rules/references/examples/express-api-ts/src/AGENTS.md). Install upstream with npx skills add dirien/stop-building-portals-start-building-conversations --skill src. Copyright stays with the author.

AGENTS.md — src

Name: src
Author: dirien

Overview

Backend services (TypeScript/Node.js)

Key Files

File	Purpose
`src/config.ts`	(add description)
`src/routes/health.ts`	Add database connectivity check here
`src/routes/users.ts`	(add description)
`src/index.ts`	Middleware
`src/utils/logger.ts`	(add description)

Golden Samples (follow these patterns)

Pattern	Reference
Standard implementation	`src/controllers/userController.ts`

Setup & environment

Install: pnpm install
Node version: >=20.0.0
Package manager: pnpm
Environment variables: See .env or .env.example

Build & tests

Typecheck (project-wide): pnpm typecheck
Format: pnpm format
Lint: pnpm lint
Test: pnpm test
Build: pnpm build
Dev server: pnpm dev

Code style & conventions

Use TypeScript strict mode (strict: true in tsconfig)
No any without explicit justification comment
Prefer interface over type for object shapes
Naming: camelCase for functions/vars, PascalCase for classes/types
Async/await over raw Promises
Prefer const over let, never use var
Destructure objects and arrays when appropriate

Security & safety

Validate all user inputs (use zod or similar)
Parameterized queries only (no string concatenation)
Never use dynamic code execution with user data
Sensitive data: never log or expose in errors
Environment: use dotenv, never hardcode secrets
CORS: configure explicitly, no wildcard in production
Rate limiting: implement for public endpoints

PR/commit checklist

Tests pass: pnpm test
Type check clean: pnpm typecheck
Lint clean: pnpm lint
Formatted: pnpm format
No any types without justification
API endpoints have validation
Error responses don't leak internals

Patterns to Follow

Prefer looking at real code in this repo over generic examples. See Golden Samples section above for files that demonstrate correct patterns.

When stuck

Check Node.js docs: https://nodejs.org/docs
TypeScript handbook: https://www.typescriptlang.org/docs
Review existing patterns in this codebase
Check root AGENTS.md for project-wide conventions

{ "ocm": "1", "id": "dirien-stop-building-portals-start-building-conversations-src", "kind": "skill", "name": "src", "description": "", "publisher": "dirien", "version": "1.0.0", "capabilities": { "domains": [ "math" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "" ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/dirien/stop-building-portals-start-building-conversations", "path": "slides/.opencode/skills/agent-rules/references/examples/express-api-ts/src/AGENTS.md", "ref": "3c2ded6c99ff8120f483fb1a1891dc110c38761a", "url": "https://github.com/dirien/stop-building-portals-start-building-conversations/blob/3c2ded6c99ff8120f483fb1a1891dc110c38761a/slides/.opencode/skills/agent-rules/references/examples/express-api-ts/src/AGENTS.md", "key": "dirien/stop-building-portals-start-building-conversations/slides/.opencode/skills/agent-rules/references/examples/express-api-ts/src/AGENTS.md" } }, "instructions": "\n\n# AGENTS.md — src\n\n\n## Overview\nBackend services (TypeScript/Node.js)\n\n\n\n## Key Files\n| File | Purpose |\n|------|---------|\n| `src/config.ts` | (add description) |\n| `src/routes/health.ts` | Add database connectivity check here |\n| `src/routes/users.ts` | (add description) |\n| `src/index.ts` | Middleware |\n| `src/utils/logger.ts` | (add description) |\n<!-- AGENTS-GENERATED:", "cost": { "context_tokens": 793 } }

src

About