nitm-ai-dev-toolkit 3.0.15

package/src/monorepo/.cursor/rules/version-control.mdc

@@ -0,0 +1,11 @@
+---
+description: Version control and commit message standards
+globs:
+alwaysApply: agent
+---
+
+# Version Control
+
+Conventional commit format with ticket references and PR template compliance.
+
+**CRITICAL: READ:** [.claude/rules-snippets/version-control.md](../../.claude/rules-snippets/version-control.md)

package/src/monorepo/.cursor/rules/what-to-avoid.mdc

@@ -0,0 +1,11 @@
+---
+description: Deprecated patterns and anti-practices to avoid
+globs:
+alwaysApply: agent
+---
+
+# What to Avoid
+
+No deprecated features, global CSS, direct DOM manipulation, or duplicated logic.
+
+**CRITICAL: READ:** [.claude/rules-snippets/what-to-avoid.md](../../.claude/rules-snippets/what-to-avoid.md)

package/src/monorepo/.cursor/skills/README.md

@@ -0,0 +1,50 @@
+# Cursor Skills
+
+This folder is for skills installed via `npx -y skills add <owner/repo> --skill '*' --agent github-copilot cursor`.
+
+## About Skills
+
+Skills are folders of instructions and resources that help AI agents perform specific tasks more accurately. They use the [Agent Skills](https://agentskills.io/) open format.
+
+## Installing Skills
+
+Install skills from [skills.sh](https://skills.sh/) using the `-a cursor` flag:
+
+```bash
+# For Cursor only
+npx -y skills add -a cursor <owner/repo> --skill '*' --agent github-copilot cursor
+
+# For multiple agents (e.g., Cursor + GitHub Copilot)
+npx -y skills add -a cursor -a github-copilot <owner/repo> --skill '*' --agent github-copilot cursor
+```
+
+**Tip:** The skills CLI automatically detects installed agents. If you omit `-a cursor`, you'll be prompted to choose from detected agents. Use `--skill '*' --agent github-copilot cursor` to avoid skill-selection prompts when installing from a repo.
+
+**Important:** Always use `-a cursor` to install only for Cursor (or add multiple `-a` flags if you use multiple agents). This prevents creating unnecessary configuration files for other agents.
+
+## Pre-installed Skills
+
+Universal workflow skills are pre-installed in `.agents/skills/`. These include:
+
+- test-driven-development
+- systematic-debugging
+- verification-before-completion
+- writing-plans
+- executing-plans
+- And more...
+
+## Examples
+
+```bash
+# Frontend skills
+npx -y skills add -a cursor onmax/nuxt-skills --skill '*' --agent github-copilot cursor
+npx -y skills add -a cursor vercel-labs/agent-skills --skill '*' --agent github-copilot cursor
+
+# Security skills
+npx -y skills add -a cursor trailofbits/skills --skill '*' --agent github-copilot cursor
+
+# Framework-specific
+npx -y skills add -a cursor better-auth/skills --skill '*' --agent github-copilot cursor
+```
+
+See the main README.md for a full list of recommended skills.

package/src/monorepo/.github/agents/admin-portal.agent.md

@@ -0,0 +1,11 @@
+---
+name: Admin Portal
+description: "Build administrator portals with RBAC, system dashboards, reporting, analytics, and operational tooling. Specializes in admin frameworks and monitoring ecosystem tools."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+---
+
+# Admin Portal Specialist
+
+Build secure, efficient admin interfaces for system operations, reporting, and user/role management.
+
+**CRITICAL: READ:** [.claude/agents-snippets/admin-portal.md](../../.claude/agents-snippets/admin-portal.md)

package/src/monorepo/.github/agents/api-specialist.agent.md

@@ -0,0 +1,11 @@
+---
+name: API Specialist
+description: "Design and implement API architecture, documentation, and developer experience. Use for REST design, GraphQL, OpenAPI specs, SDK generation, API versioning, and integration patterns."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+---
+
+# API Specialist
+
+Design, document, and optimize APIs for internal and external consumption.
+
+**CRITICAL: READ:** [.claude/agents-snippets/api-specialist.md](../../.claude/agents-snippets/api-specialist.md)

package/src/monorepo/.github/agents/backend-architect.agent.md

@@ -0,0 +1,11 @@
+---
+name: Backend Architect
+description: "Design APIs, databases, and server-side architecture. Use for scalable backend systems, data modeling, caching strategies, system design, and infrastructure decisions."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+---
+
+# Backend Architect
+
+Design and implement scalable, secure, and maintainable server-side systems.
+
+**CRITICAL: READ:** [.claude/agents-snippets/backend-architect.md](../../.claude/agents-snippets/backend-architect.md)

package/src/monorepo/.github/agents/documenter.agent.md

@@ -0,0 +1,11 @@
+---
+name: Documenter
+description: "Analyze codebases and create comprehensive documentation. Use for AGENTS.md, README files, API docs, architecture documentation, and onboarding guides."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+---
+
+# Documenter
+
+Analyze codebases and produce clear, actionable documentation.
+
+**CRITICAL: READ:** [.claude/agents-snippets/documenter.md](../../.claude/agents-snippets/documenter.md)

package/src/monorepo/.github/agents/feature-builder.agent.md

@@ -0,0 +1,24 @@
+---
+name: Feature Builder
+description: "Coordinate end-to-end feature development using subagents for planning, implementation, and review. Orchestrates the full development lifecycle."
+tools:
+  ["agent", "edit", "search", "read", "runInTerminal", "terminalLastCommand"]
+agents:
+  [
+    "Planner",
+    "Implementer",
+    "Reviewer",
+    "Researcher",
+    "Backend Architect",
+    "Frontend Developer",
+    "API Specialist",
+    "Admin Portal",
+    "Documenter",
+  ]
+---
+
+# Feature Builder — Coordinator Agent
+
+Manage the full lifecycle of feature implementation by delegating to specialized subagents.
+
+**CRITICAL: READ:** [.claude/agents-snippets/feature-builder.md](../../.claude/agents-snippets/feature-builder.md)

package/src/monorepo/.github/agents/frontend-developer.agent.md

@@ -0,0 +1,11 @@
+---
+name: Frontend Developer
+description: "Build user interfaces, implement components, handle state management, and optimize frontend performance. Use for responsive, accessible, and performant web applications."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+---
+
+# Frontend Developer
+
+Build responsive, accessible, and performant user interfaces.
+
+**CRITICAL: READ:** [.claude/agents-snippets/frontend-developer.md](../../.claude/agents-snippets/frontend-developer.md)

package/src/monorepo/.github/agents/green.agent.md

@@ -0,0 +1,12 @@
+---
+name: Green
+description: "Write minimal code to make failing tests pass. Part of the TDD red-green-refactor cycle."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+user-invocable: false
+---
+
+# Green Agent (TDD — Make Tests Pass)
+
+Write the minimal production code needed to make the failing tests pass.
+
+**CRITICAL: READ:** [.claude/agents-snippets/green.md](../../.claude/agents-snippets/green.md)

package/src/monorepo/.github/agents/implementer.agent.md

@@ -0,0 +1,12 @@
+---
+name: Implementer
+description: "Implement code changes for a specific task. Follow TDD, write tests alongside code, and self-review before reporting completion."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+user-invocable: false
+---
+
+# Implementer Agent
+
+Write production-quality code for a specific task following TDD principles.
+
+**CRITICAL: READ:** [.claude/agents-snippets/implementer.md](../../.claude/agents-snippets/implementer.md)

package/src/monorepo/.github/agents/planner.agent.md

@@ -0,0 +1,12 @@
+---
+name: Planner
+description: "Break down feature requests into implementation tasks. Read specifications, analyze codebase patterns, and produce structured plans with dependencies."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+user-invocable: false
+---
+
+# Planner Agent
+
+Break down feature requests into clear, actionable implementation tasks.
+
+**CRITICAL: READ:** [.claude/agents-snippets/planner.md](../../.claude/agents-snippets/planner.md)

package/src/monorepo/.github/agents/red.agent.md

@@ -0,0 +1,12 @@
+---
+name: Red
+description: "Write failing tests that define expected behavior. Part of the TDD red-green-refactor cycle."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+user-invocable: false
+---
+
+# Red Agent (TDD — Write Failing Tests)
+
+Write tests that define the expected behavior for the given requirement. Tests MUST fail when first run.
+
+**CRITICAL: READ:** [.claude/agents-snippets/red.md](../../.claude/agents-snippets/red.md)

package/src/monorepo/.github/agents/refactor.agent.md

@@ -0,0 +1,12 @@
+---
+name: Refactor
+description: "Improve code quality and structure while keeping all tests passing. Part of the TDD red-green-refactor cycle."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+user-invocable: false
+---
+
+# Refactor Agent (TDD — Improve Code Quality)
+
+Improve code quality without changing behavior. All tests must remain green throughout.
+
+**CRITICAL: READ:** [.claude/agents-snippets/refactor.md](../../.claude/agents-snippets/refactor.md)

package/src/monorepo/.github/agents/researcher.agent.md

@@ -0,0 +1,12 @@
+---
+name: Researcher
+description: "Research codebase patterns, dependencies, and technical context. Analyze code structure, find relevant examples, and report findings without making changes."
+tools: ["read", "search"]
+user-invocable: true
+---
+
+# Researcher Agent
+
+Research codebase patterns, dependencies, and technical context without making changes.
+
+**CRITICAL: READ:** [.claude/agents-snippets/researcher.md](../../.claude/agents-snippets/researcher.md)

package/src/monorepo/.github/agents/reviewer.agent.md

@@ -0,0 +1,11 @@
+---
+name: Reviewer
+description: "Review code changes for correctness, code quality, security, and adherence to project patterns. Provide actionable feedback with specific file and line references. Use immediately after writing or modifying code, or as a quality gate in orchestrated workflows."
+tools: ["read", "search", "runInTerminal", "terminalLastCommand"]
+---
+
+# Reviewer Agent
+
+Review code changes for correctness, code quality, security, and adherence to project patterns.
+
+**CRITICAL: READ:** [.claude/agents-snippets/reviewer.md](../../.claude/agents-snippets/reviewer.md)

package/src/monorepo/.github/agents/tdd.agent.md

@@ -0,0 +1,13 @@
+---
+name: TDD
+description: "Implement a feature using test-driven development with red-green-refactor cycle. Coordinates specialized subagents for writing failing tests, implementing code, and refactoring."
+tools:
+  ["agent", "edit", "search", "read", "runInTerminal", "terminalLastCommand"]
+agents: ["Red", "Green", "Refactor"]
+---
+
+# TDD Coordinator Agent
+
+Implement features using test-driven development with red-green-refactor cycle.
+
+**CRITICAL: READ:** [.claude/agents-snippets/tdd.md](../../.claude/agents-snippets/tdd.md)

package/src/monorepo/.github/copilot-instructions.md

@@ -0,0 +1,95 @@
+# Copilot Instructions — {{PROJECT_NAME}} Monorepo
+
+## Project Overview
+
+- **Type:** Monorepo
+- **Package Manager:** {{PACKAGE_MANAGER}}
+- **Apps:** `apps/{{APP_NAME_1}}/`, `apps/{{APP_NAME_2}}/`
+- **Packages:** `packages/{{PACKAGE_NAME_1}}/`, `packages/{{PACKAGE_NAME_2}}/`, `packages/config/`
+
+## Orientation to recent work
+
+The [orient-to-recent-work](../.agents/skills/orient-to-recent-work/SKILL.md) skill (auto-loaded) orients you to recent project activity before any non-trivial task: CHANGELOG Unreleased, recent commits, recent decisions. Skip for trivial fixes: typos, version bumps, isolated docs updates, mechanical refactors with a known target.
+
+## Instruction Sources
+
+Detailed standards are organized into focused instruction files. Copilot will automatically load these based on the `applyTo` patterns:
+
+| Instruction File                    | Description                                       |
+| ----------------------------------- | ------------------------------------------------- |
+| `agent-conduct.instructions.md`     | Agent conduct rules, clarification protocols      |
+| `project-context.instructions.md`   | Monorepo architecture and project context         |
+| `coding-standards.instructions.md`  | Coding standards and shared code conventions      |
+| `patterns.instructions.md`          | Monorepo patterns, workspace conventions, imports |
+| `workflows.instructions.md`         | Development commands and monorepo workflows       |
+| `testing.instructions.md`           | Testing strategy across apps and packages         |
+| `deployment.instructions.md`        | Deployment configuration per app                  |
+| `logging.instructions.md`           | Monorepo logging standards and best practices     |
+| `documentation.instructions.md`     | Distributed documentation strategy                |
+| `subagent-workflow.instructions.md` | Orchestrator-first patterns and agent delegation  |
+
+## Context Sources
+
+- [AGENTS.md](../AGENTS.md) - Monorepo architecture and agent conduct
+- [apps/{{APP_NAME_1}}/AGENTS.md](../apps/{{APP_NAME_1}}/AGENTS.md) - App-specific patterns
+- [apps/{{APP_NAME_2}}/AGENTS.md](../apps/{{APP_NAME_2}}/AGENTS.md) - App-specific patterns
+
+## Ponytail, lazy senior dev mode
+
+See [.claude/rules-snippets/ponytail.md](../.claude/rules-snippets/ponytail.md) for the full rule content.
+
+## Preferred Workflow: Orchestrator + Subagents
+
+**Default to using a coordinator agent for non-trivial work.** For details, see `subagent-workflow.instructions.md`.
+
+### Coordinators
+
+| Agent               | File                              | Purpose                                      |
+| ------------------- | --------------------------------- | -------------------------------------------- |
+| **Feature Builder** | `agents/feature-builder.agent.md` | End-to-end feature development orchestration |
+| **TDD**             | `agents/tdd.agent.md`             | Red-green-refactor cycle coordination        |
+
+### Domain Specialists (user-invocable)
+
+| Agent                  | File                                 | Purpose                                 |
+| ---------------------- | ------------------------------------ | --------------------------------------- |
+| **Backend Architect**  | `agents/backend-architect.agent.md`  | API design, databases, system arch      |
+| **Frontend Developer** | `agents/frontend-developer.agent.md` | UI components, state, responsive design |
+| **API Specialist**     | `agents/api-specialist.agent.md`     | API contracts, docs, versioning         |
+| **Admin Portal**       | `agents/admin-portal.agent.md`       | RBAC, dashboards, reporting, monitoring |
+| **Documenter**         | `agents/documenter.agent.md`         | AGENTS.md, README, API docs             |
+| **Reviewer**           | `agents/reviewer.agent.md`           | Multi-perspective code review           |
+
+### Process Workers (subagent-only)
+
+| Agent           | File                          | Purpose                                |
+| --------------- | ----------------------------- | -------------------------------------- |
+| **Planner**     | `agents/planner.agent.md`     | Implementation task breakdown          |
+| **Implementer** | `agents/implementer.agent.md` | Production code implementation         |
+| **Researcher**  | `agents/researcher.agent.md`  | Read-only codebase analysis            |
+| **Red**         | `agents/red.agent.md`         | Write failing tests (TDD red phase)    |
+| **Green**       | `agents/green.agent.md`       | Make tests pass (TDD green phase)      |
+| **Refactor**    | `agents/refactor.agent.md`    | Improve code quality, keep tests green |
+
+Process workers (`user-invocable: false`) are only accessible as subagents — they don't appear in the agents dropdown.
+
+> **Docs:** [VS Code Subagents](https://code.visualstudio.com/docs/copilot/agents/subagents) · [Cursor Subagents](https://cursor.com/docs/subagents)
+
+## Skills References
+
+For detailed standards on specific topics, refer to these skills:
+
+| Topic             | Skill Location                                   | Description                                                  |
+| ----------------- | ------------------------------------------------ | ------------------------------------------------------------ |
+| **Logging**       | `.agents/skills/logging/SKILL.md`                | Structured logging standards, log levels, message formatting |
+| **Documentation** | `.agents/skills/project-documentation/SKILL.md`  | README standards, code comments, ADRs, changelogs            |
+| **Writing Plans** | `.agents/skills/writing-plans/SKILL.md`          | Feature planning and specification                           |
+| **Code Review**   | `.agents/skills/requesting-code-review/SKILL.md` | Code review process and checklists                           |
+| **Debugging**     | `.agents/skills/systematic-debugging/SKILL.md`   | Systematic debugging workflows                               |
+
+## Guidelines
+
+- Follow monorepo conventions for task dependencies
+- Use internal packages for shared code
+- Run commands from monorepo root
+- Reference app-specific AGENTS.md for detailed patterns

package/src/monorepo/.github/instructions/agent-conduct.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "Agent conduct rules, clarification protocols, and assumption handling."
+---
+
+# Agent Conduct & Interaction Rules
+
+Follow the rules defined in [.claude/rules-snippets/agent-conduct.md](../../.claude/rules-snippets/agent-conduct.md).
+
+Key points:
+- **Orchestration checkpoint first** — Before ANY multi-step task (2+ of: research, planning, implementation, testing, review), read the orchestration checkpoint in AGENTS.md and use coordinator agents.
+- **Ask before assuming** — Clarify ambiguous requirements, architecture decisions, data model changes, and breaking changes before proceeding.
+- **Monorepo guardrails** — Never silently change database schemas, API contracts, or auth flows. Never modify shared packages without considering downstream consumers.
+- **Prefer reversible changes** when acting without full clarity.

package/src/monorepo/.github/instructions/api-server.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "API route patterns, input validation, and response formats for the {{PROJECT_NAME}} monorepo."
+---
+
+# API Server
+
+Follow the rules defined in [.claude/rules-snippets/api-server.md](../../.claude/rules-snippets/api-server.md).
+
+Key points:
+- {{API_ROUTE_PATTERN}} — validate all input data before processing.
+- Return consistent response formats with proper HTTP status codes.
+- Document API endpoints in {{API_DOCS_LOCATION}}.
+- Use shared API types from `{{PACKAGES_DIR}}/` for cross-app consistency.

package/src/monorepo/.github/instructions/coding-standards.instructions.md

@@ -0,0 +1,13 @@
+---
+applyTo: "**/*"
+description: "Coding standards and conventions for the {{PROJECT_NAME}} monorepo."
+---
+
+# Coding Standards
+
+Follow the rules defined in [.claude/rules-snippets/coding-standards.md](../../.claude/rules-snippets/coding-standards.md).
+
+Key points:
+- Follow {{LANGUAGE}} best practices across all apps and packages; run `{{LINT_COMMAND}}` and `{{CHECK_TYPES_COMMAND}}` before committing.
+- **SRP and reuse-first principle** — Review existing shared packages before implementing new functionality; prefer extending over duplicating.
+- Every shared package must have a clean public API with explicit exports.

package/src/monorepo/.github/instructions/component-structure.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "Component structure patterns and naming conventions for the {{PROJECT_NAME}} monorepo."
+---
+
+# Component Structure
+
+Follow the rules defined in [.claude/rules-snippets/component-structure.md](../../.claude/rules-snippets/component-structure.md).
+
+Key points:
+- Follow the {{COMPONENT_PATTERN}} pattern for all components with clear, descriptive naming for props, events, and methods.
+- Keep logic within components focused and manageable; add code comments for complex or non-obvious implementations.
+- Use bracketed identifiers for logs: `[ComponentName]: message`.
+- Share reusable components via `{{PACKAGES_DIR}}/` when used across multiple apps.

package/src/monorepo/.github/instructions/core-libraries.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "Core library usage and utility patterns for the {{PROJECT_NAME}} monorepo."
+---
+
+# Core Libraries
+
+Follow the rules defined in [.claude/rules-snippets/core-libraries.md](../../.claude/rules-snippets/core-libraries.md).
+
+Key points:
+- Use {{UTILITY_LIBRARY}} for common utilities and {{STATE_MANAGEMENT}} for state management.
+- Use {{STYLING}} for styling; prefer utility classes over custom CSS.
+- Use {{UI_LIBRARY}} for UI components; check existing components before creating new ones.
+- Prefer shared packages from `{{PACKAGES_DIR}}/` over app-local duplicates.

package/src/monorepo/.github/instructions/deployment.instructions.md

@@ -0,0 +1,13 @@
+---
+applyTo: "**/*"
+description: "Deployment configuration for the {{PROJECT_NAME}} monorepo."
+---
+
+# Deployment
+
+Follow the rules defined in [.claude/rules-snippets/deployment.md](../../.claude/rules-snippets/deployment.md).
+
+Key points:
+- Each app has its own deploy platform and command; environment variables are configured per-app and at root level.
+- CI/CD workflows must install, build, test, and lint across the full workspace.
+- **Pre-deployment checklist**: All tests pass, linting passes, builds complete, env vars configured, migrations applied, shared package changes tested in all consuming apps.

package/src/monorepo/.github/instructions/documentation.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "Monorepo documentation standards for features and fixes"
+---
+
+# Monorepo Documentation Guidelines
+
+Follow the rules defined in [.claude/rules-snippets/documentation.md](../../.claude/rules-snippets/documentation.md).
+
+Key points:
+- **Distributed strategy** — App-specific docs live in `apps/{{APP_NAME}}/docs/`; root `docs/` is only for monorepo-wide concerns (`docs/architecture/`, `docs/integration/`, `docs/guides/`, `docs/constitution.md`).
+- **Docs app sync required** — Every commit that changes user-facing behavior must update `apps/{{DOCS_APP}}/content/` before committing.
+- **Pre-commit gate** — Documentation MUST be written or updated BEFORE committing code. Features need spec + plan in `apps/{{APP_NAME}}/docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/`; fixes go in monthly logs; breaking changes update CHANGELOG.md.
+- **No individual fix files for simple bugs** — Use `apps/{{APP_NAME}}/docs/fixes/{{YYYY-MM}}.md` monthly logs instead.

package/src/monorepo/.github/instructions/environment-tooling.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "Environment and tooling configuration rules for the {{PROJECT_NAME}} monorepo."
+---
+
+# Environment & Tooling
+
+Follow the rules defined in [.claude/rules-snippets/environment-tooling.md](../../.claude/rules-snippets/environment-tooling.md).
+
+Key points:
+- Tailor commands to the user's OS and shell.
+- Use `{{PACKAGE_MANAGER}}` for package management across all apps and packages.
+- {{TOOLING_RULE_1}} and {{TOOLING_RULE_2}}.
+- Use workspace commands (e.g., `{{PACKAGE_MANAGER}} --filter={{APP_NAME_1}}`) for app-specific tasks.

package/src/monorepo/.github/instructions/logging-comments.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "Logging and code comment standards for the {{PROJECT_NAME}} monorepo."
+---
+
+# Logging & Comments
+
+Follow the rules defined in [.claude/rules-snippets/logging-comments.md](../../.claude/rules-snippets/logging-comments.md).
+
+Key points:
+- Comment complex logic and non-obvious implementations.
+- Use bracketed identifiers for logs: `[ModuleName]: message`; include app/package context in monorepo logs.
+- Use appropriate log levels: error, warn, info, debug.
+- Remove debug logs before committing to main branch.

package/src/monorepo/.github/instructions/logging.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "Monorepo logging standards and best practices"
+---
+
+# Monorepo Logging Standards
+
+Follow the rules defined in [.claude/rules-snippets/logging.md](../../.claude/rules-snippets/logging.md).
+
+Key points:
+- **Always include app/package context**: Prefix every log with `[App:name]` or `[Pkg:name]`.
+- **Use correlation IDs** to track requests across apps; log all cross-app communication.
+- **Use appropriate log levels**: `error` for critical failures, `warn` for non-blocking issues, `info` for significant events, `debug` for diagnostics.
+- **Never log sensitive data** (passwords, tokens, PII); sanitize before logging. Avoid logging in hot paths.

package/src/monorepo/.github/instructions/patterns.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "Monorepo patterns and conventions."
+---
+
+# Monorepo Patterns
+
+Follow the rules defined in [.claude/rules-snippets/patterns.md](../../.claude/rules-snippets/patterns.md).
+
+Key points:
+- **Package naming**: Apps use direct names, packages use `@{{PROJECT_NAME}}/` scope. Use `@/` for internal app imports.
+- **SRP and reuse-first principle** — Review existing shared packages before implementing new functionality; never duplicate state or behavior that a utility already manages.
+- **Turbo tasks**: Use `{{PACKAGE_MANAGER}} build --filter=` for specific workspaces; `^build` for dependency ordering.
+- Shared config (ESLint, TypeScript) lives in `packages/config/` and is extended by each app.

package/src/monorepo/.github/instructions/prisma-migrations.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "Database migration and schema management rules for the {{PROJECT_NAME}} monorepo."
+---
+
+# Database Migrations
+
+Follow the rules defined in [.claude/rules-snippets/prisma-migrations.md](../../.claude/rules-snippets/prisma-migrations.md).
+
+Key points:
+- {{DATABASE_SYNC_RULE}} — create migrations with descriptive names and apply to development database before committing.
+- Maintain corresponding model definitions for database entities and update affected services after schema changes.
+- Run tests after schema modifications to catch regressions early.
+- Coordinate schema changes across apps when using shared database packages.

package/src/monorepo/.github/instructions/project-context.instructions.md

@@ -0,0 +1,13 @@
+---
+applyTo: "**/*"
+description: "Monorepo architecture and project context."
+---
+
+# Project Architecture
+
+Follow the rules defined in [.claude/rules-snippets/project-context.md](../../.claude/rules-snippets/project-context.md).
+
+Key points:
+- This is a **monorepo** with `apps/` (deployable applications) and `packages/` (shared internal packages).
+- Cross-package imports use the `@{{PROJECT_NAME}}/` scope; internal app imports use `@/` or `~/`.
+- Context files: Root `AGENTS.md` for monorepo-level context, `apps/*/AGENTS.md` for app-specific patterns, `packages/*/README.md` for package docs.

package/src/monorepo/.github/instructions/server-client-separation.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "Server/client boundary enforcement and data fetching patterns for the {{PROJECT_NAME}} monorepo."
+---
+
+# Server-Client Separation
+
+Follow the rules defined in [.claude/rules-snippets/server-client-separation.md](../../.claude/rules-snippets/server-client-separation.md).
+
+Key points:
+- Never import server-only code in client components; use API endpoints to expose server functionality to clients.
+- Create shared types for cross-boundary use; use appropriate data fetching patterns for the framework.
+- Mark server-only modules clearly (e.g., `.server.{{LANGUAGE_EXTENSION}}`).
+- Use shared packages from `{{PACKAGES_DIR}}/` for cross-boundary types and utilities.

package/src/monorepo/.github/instructions/subagent-workflow.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "Subagent workflow patterns and orchestrator-first approach. Loaded when working with multi-step tasks, feature development, or agent delegation."
+---
+
+# Subagent Workflow
+
+Follow the rules defined in [.claude/rules-snippets/subagent-workflow.md](../../.claude/rules-snippets/subagent-workflow.md).
+
+Key points:
+- **Orchestration checkpoint** — If your work involves 2+ of: research, planning, implementation, testing, review, use a coordinator agent (Feature Builder, TDD) instead of single-agent execution.
+- **Domain specialist selection**: Backend → Backend Architect, UI → Frontend Developer, API → API Specialist, Admin → Admin Portal, Docs → Documenter, General → Implementer.
+- **Quality gates**: Every implementation must pass Reviewer before proceeding; if a reviewer requests changes, the original specialist fixes them and re-review occurs.
+- **Parallelization analysis required** before dispatching: Tasks writing to different files with no shared state are parallel-safe.

package/src/monorepo/.github/instructions/testing-quality.instructions.md

@@ -0,0 +1,15 @@
+---
+applyTo: "**/*"
+description: "Testing and quality assurance standards for the {{PROJECT_NAME}} monorepo."
+---
+
+# Testing & Quality
+
+Follow the rules defined in [.claude/rules-snippets/testing-quality.md](../../.claude/rules-snippets/testing-quality.md).
+
+Key points:
+- Ensure lint, test, and build pass before committing.
+- Use {{TEST_FRAMEWORK}} for unit/component tests and {{E2E_FRAMEWORK}} for end-to-end tests.
+- Place tests alongside implementation files or in `tests/` directory.
+- Aim for meaningful test coverage of business logic; shared packages need standalone unit tests.
+- Run `{{PACKAGE_MANAGER}} test` for all apps or `--filter={{APP_NAME_1}}` for specific apps.

package/src/monorepo/.github/instructions/testing.instructions.md

@@ -0,0 +1,14 @@
+---
+applyTo: "**/*"
+description: "Testing strategy and conventions for the {{PROJECT_NAME}} monorepo."
+---
+
+# Testing Standards
+
+Follow the rules defined in [.claude/rules-snippets/testing.md](../../.claude/rules-snippets/testing.md).
+
+Key points:
+- **Commands**: `{{PACKAGE_MANAGER}} test` (all), `--filter={{APP_NAME_1}}` (specific app), `-- --watch` (watch mode).
+- **Test locations**: Unit tests in `{{PACKAGES_DIR}}/**/` and `{{APP_DIR}}/**/`; integration in `{{INTEGRATION_TEST_DIR}}/`; E2E in `{{E2E_TEST_DIR}}/`.
+- **Coverage**: Minimum {{COVERAGE_THRESHOLD}}; critical paths need integration or E2E coverage; new features require tests before merging.
+- **Cross-package testing**: Shared packages need standalone unit tests; apps must test integration with shared packages.