Instructions Catalog

Instructions are persistent, always-on engineering standards. The harness automatically injects the instruction into the LLM context when the open or modified file matches the declared applyTo glob.

Overview Table

Instruction	File	Pattern (applyTo)	Domain Guide	Companion Skill	Description
Think & Plan	think-plan.instructions.md	**/think.md,**/plan.md,**/specs/**	Think & Plan	think-plan	Standards for specifications as think.md and plan.md: bootability preservation, atomic steps, and clean phase separation.
Sharp Agent	sharp-agent.instructions.md	**	Audit & Remediation	—	Directives against overengineering, premature abstractions, and token waste.
Node.js Express	node-express.instructions.md	src/**/*.js	Tech Stacks	node-express-examples	Layered microservice architecture, routing, middleware flow, and error envelopes.
Node Unit Tests	node-unit-tests.instructions.md	tests/**/*.js	Testing & Verification	—	Jest test conventions: isolated module unit tests for services, utils, controllers, and middlewares.
Node HTTP API Tests	node-api-tests.instructions.md	tests/routes/**/*.js,tests/api/**/*.js	Testing & Verification	—	Supertest HTTP API route test conventions: endpoint contracts, request/response assertions, and boundary mocking.
PostgreSQL & Liquibase	postgres-liquibase.instructions.md	db/**/*.{sql,xml,yml,yaml}	Tech Stacks	postgres-liquibase-examples	Audited schemas, soft-delete triggers, history trails, and migration changeSet conventions.
PostgreSQL Liquibase Tests	postgres-liquibase-tests.instructions.md	tests/db/**/*.sql	Testing & Verification	—	Deterministic SQL assertion scripts validating migrations against containerized DB.
Docker & Compose	docker.instructions.md	docker/**, **/dockerfile*, scripts/**/*.sh	Tech Stacks	docker-examples	Multi-service Compose stack behind Traefik, BuildKit secret mounts, non-root users.
Angular Admin	angular-admin.instructions.md	**/src/app/**/*.ts	Tech Stacks	angular-admin-examples	Feature-sliced entities, PrimeNG components, dynamic ACL, and app-config registries.
Angular Unit Tests	angular-unit-tests.instructions.md	**/src/**/*.spec.ts	Testing & Verification	—	Vitest unit specs (ng test), isolated testing, mock providers, and component DOM assertions.
Angular E2E Tests	angular-e2e-tests.instructions.md	**/e2e/**/*.ts	Testing & Verification	—	Playwright end-to-end tests covering login, CRUD workflows, and responsive layouts.
VitePress Docs	vitepress-docs.instructions.md	**/.vitepress/**, **/docs/**/*.md	Specs & Docs	vitepress-docs-examples	VitePress product docs: user-named docs root, Mermaid, Traefik /docs in dev, GitHub Pages in prod.
k6 Performance Tests	k6-performance-tests.instructions.md	tests/perf/, perf Compose	Testing & Verification	k6-performance-examples	k6 API performance scenarios, Docker execution, metric thresholds, and HTML/JSON summaries.
RESTler Fuzzing Tests	restler-fuzzing-tests.instructions.md	tests/restler/, restler Compose	Testing & Verification	restler-fuzzing-examples	RESTler stateful REST API fuzzing: OpenAPI compilation, auth tokens, fuzz-lean CI gating.

---

Detailed Specifications by Domain

Normative architectural rules and code examples are maintained in the respective domain guides to preserve single authoritative ownership.

Universal & Remediation Instructions

• Sharp Agent (sharp-agent.instructions.md): Injected across all files (**). Mandates minimal diffs, token efficiency, zero unrequested dependencies, and test verification before completion. See Surgical Remediation.

Tech Stack Instructions

• Node.js Express (node-express.instructions.md): Enforces strict separation between routes, controllers, and services, standard { data } / { error } JSON envelopes, and security headers. Detailed in Node.js & Express Microservices.
• PostgreSQL & Liquibase (postgres-liquibase.instructions.md): Mandates rollbackable changeSets, automatic timestamp audit triggers, and soft deletion. Detailed in PostgreSQL & Liquibase Database Evolution.
• Docker & Compose (docker.instructions.md): Enforces multi-stage builds, non-root users, BuildKit secrets, and Traefik routing. Detailed in Docker & Container Infrastructure.
• Angular Admin (angular-admin.instructions.md): Governs feature-sliced entities, PrimeNG tables, and dynamic ACL. Detailed in Angular Enterprise Admin Portal.

Automated Testing Instructions

• Node Unit Tests (node-unit-tests.instructions.md): Governs Jest module unit assertions for isolated services and utilities. Detailed in Node.js Module Unit Tests.
• Node HTTP API Tests (node-api-tests.instructions.md): Governs Supertest HTTP route integration assertions. Detailed in Node.js HTTP API Route Tests.
• Angular Unit Tests (angular-unit-tests.instructions.md): Governs colocated Vitest specs. Detailed in Angular Vitest Component Specs.
• Angular E2E Tests (angular-e2e-tests.instructions.md): Governs Playwright Page Object Model suites. Detailed in Angular Playwright End-to-End Tests.
• PostgreSQL Liquibase Tests (postgres-liquibase-tests.instructions.md): Governs SQL forward and rollback assertions. Detailed in PostgreSQL Liquibase Tests.
• k6 Performance Tests (k6-performance-tests.instructions.md): Governs load and spike scenarios with strict SLA thresholds. Detailed in k6 Performance Benchmarking.
• RESTler Fuzzing Tests (restler-fuzzing-tests.instructions.md): Governs API grammar fuzzing and zero 500 error gates. Detailed in RESTler API Grammar Fuzzing.

Think & Plan Instructions

• Think & Plan (think-plan.instructions.md): Governs persistent specification artifacts (think.md and plan.md). Enforces that specifications are structured models of architecture and execution rather than narrative prose, mandating atomic steps, verification commands, and bootability checks before build agents touch code. Detailed in Business Needs to Specifications.

Specs & Docs Instructions

• VitePress Docs (vitepress-docs.instructions.md): Governs docs site scaffolding, VitePress configuration, Mermaid diagrams, and dual dev/prod routing. Detailed in Product Documentation Website.