nitm-ai-dev-toolkit 3.0.15

package/src/repo/.claude/skills/README.md

@@ -0,0 +1,50 @@
+# Claude Code Skills
+
+This folder is for skills installed via `npx -y skills add -a claude-code <owner/repo> --skill '*'`.
+
+## 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 claude-code` flag:
+
+```bash
+# For Claude Code only
+npx -y skills add -a claude-code <owner/repo> --skill '*'
+
+# For multiple agents (e.g., Claude Code + GitHub Copilot)
+npx -y skills add -a claude-code -a github-copilot <owner/repo> --skill '*'
+```
+
+**Tip:** The skills CLI automatically detects installed agents. If you omit `-a claude-code`, you'll be prompted to choose from detected agents.
+
+**Important:** Always use `-a claude-code` to install only for Claude Code (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 claude-code onmax/nuxt-skills --skill '*'
+npx -y skills add -a claude-code vercel-labs/agent-skills --skill '*'
+
+# Security skills
+npx -y skills add -a claude-code trailofbits/skills --skill '*'
+
+# Framework-specific
+npx -y skills add -a claude-code better-auth/skills --skill '*'
+```
+
+See the main README.md for a full list of recommended skills.

package/src/repo/.cursor/agents/admin-portal.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Build secure, efficient admin interfaces for system operations, reporting, and user/role management."
+globs:
+alwaysApply: agent
+---
+
+# 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/repo/.cursor/agents/api-specialist.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Design, document, and optimize APIs for internal and external consumption."
+globs:
+alwaysApply: agent
+---
+
+# 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/repo/.cursor/agents/backend-architect.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Design and implement scalable, secure, and maintainable server-side systems."
+globs:
+alwaysApply: agent
+---
+
+# 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/repo/.cursor/agents/documenter.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Analyze codebases and produce clear, actionable documentation."
+globs:
+alwaysApply: agent
+---
+
+# Documenter
+
+Analyze codebases and produce clear, actionable documentation.
+
+**CRITICAL: READ:** [.claude/agents-snippets/documenter.md](../../.claude/agents-snippets/documenter.md)

package/src/repo/.cursor/agents/feature-builder.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Manage the full lifecycle of feature implementation by delegating to specialized subagents."
+globs:
+alwaysApply: agent
+---
+
+# 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/repo/.cursor/agents/frontend-developer.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Build responsive, accessible, and performant user interfaces."
+globs:
+alwaysApply: agent
+---
+
+# 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/repo/.cursor/agents/green.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Write the minimal production code needed to make the failing tests pass."
+globs:
+alwaysApply: agent
+---
+
+# 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/repo/.cursor/agents/implementer.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Write production-quality code for a specific task following TDD practices."
+globs:
+alwaysApply: agent
+---
+
+# Implementer Agent
+
+Write production-quality code for a specific task following TDD practices.
+
+**CRITICAL: READ:** [.claude/agents-snippets/implementer.md](../../.claude/agents-snippets/implementer.md)

package/src/repo/.cursor/agents/planner.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Break down feature requests into clear, actionable implementation tasks."
+globs:
+alwaysApply: agent
+---
+
+# 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/repo/.cursor/agents/red.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Write tests that define expected behavior. Tests MUST fail when first run."
+globs:
+alwaysApply: agent
+---
+
+# 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/repo/.cursor/agents/refactor.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Improve code quality without changing behavior. All tests must remain green."
+globs:
+alwaysApply: agent
+---
+
+# 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/repo/.cursor/agents/researcher.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Gather and analyze information from the codebase without making any changes."
+globs:
+alwaysApply: agent
+---
+
+# Researcher Agent
+
+Gather and analyze information from the codebase without making any changes.
+
+**CRITICAL: READ:** [.claude/agents-snippets/researcher.md](../../.claude/agents-snippets/researcher.md)

package/src/repo/.cursor/agents/reviewer.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Review code changes for correctness, code quality, security, and adherence to project patterns."
+globs:
+alwaysApply: agent
+---
+
+# 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/repo/.cursor/agents/tdd.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Coordinate the red-green-refactor cycle using specialized subagents."
+globs:
+alwaysApply: agent
+---
+
+# TDD Coordinator Agent
+
+Coordinate the red-green-refactor cycle using specialized subagents.
+
+**CRITICAL: READ:** [.claude/agents-snippets/tdd.md](../../.claude/agents-snippets/tdd.md)

package/src/repo/.cursor/commands/assign-tasks.md

@@ -0,0 +1,13 @@
+---
+description: Create {{ISSUE_TRACKER}} tickets from requirements or task files
+argument-hint: "requirements or task file path"
+---
+
+# Create Tickets from Requirements
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Task assignment and execution
+
+**CRITICAL: READ:** [.claude/prompt-snippets/assign-tasks.md](../../.claude/prompt-snippets/assign-tasks.md)

package/src/repo/.cursor/commands/bootstrap-patch.md

@@ -0,0 +1,17 @@
+---
+description: Patch AI instructions by fetching updates from the toolkit repo and applying new/updated/missing guidance
+argument-hint: "optional patch options"
+---
+
+# Bootstrap Patch
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `fixer` | Standard patch — incremental changes to existing config |
+| `planner` | Complex patch — cross-cutting changes needing analysis first |
+
+Patch AI instructions by comparing against the latest templates and applying updates.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/bootstrap-patch.md](../../.claude/prompt-snippets/bootstrap-patch.md)

package/src/repo/.cursor/commands/bootstrap-upgrade.md

@@ -0,0 +1,15 @@
+---
+description: Upgrade AI instructions from pre-3.0 inline pattern to 3.0+ snippet architecture
+argument-hint: "no arguments required"
+---
+
+# Bootstrap Upgrade
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `fixer` | Standard upgrade — version bump and migration |
+| `planner` | Complex upgrade — breaking changes needing dependency analysis |
+
+**CRITICAL: READ:** [.claude/prompt-snippets/bootstrap-upgrade.md](../../.claude/prompt-snippets/bootstrap-upgrade.md).

package/src/repo/.cursor/commands/bootstrap.md

@@ -0,0 +1,17 @@
+---
+description: Bootstrap AI instructions by inferring project details and customizing templates
+argument-hint: "optional bootstrap options"
+---
+
+# Bootstrap
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `fixer` | Standard bootstrap — project analysis and template customization |
+| `planner` | Complex bootstrap — needs requirements gathering and architecture decisions first |
+
+Bootstrap AI instructions by analyzing the codebase and customizing template files.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/bootstrap.md](../../.claude/prompt-snippets/bootstrap.md)

package/src/repo/.cursor/commands/commit-push.md

@@ -0,0 +1,15 @@
+---
+description: Commit and push changes with conventional commit messages
+argument-hint: "optional commit message or options"
+---
+
+# Commit & Push
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Git operations, execution-focused
+
+Commit and push changes with conventional commit messages.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/commit-push.md](../../.claude/prompt-snippets/commit-push.md)

package/src/repo/.cursor/commands/constitution.md

@@ -0,0 +1,17 @@
+---
+description: Create or update the project constitution defining core principles and guidelines
+argument-hint: "no arguments required"
+---
+
+# Constitution
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `oracle` | Project principles and governance — architectural decisions |
+| `planner` | Project conventions and standards — team norms and practices |
+
+Create or update the project constitution at `docs/constitution.md` with core principles and standards.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/constitution.md](../../.claude/prompt-snippets/constitution.md)

package/src/repo/.cursor/commands/create-skill.md

@@ -0,0 +1,15 @@
+---
+description: Create a new agent skill following VS Code and agentskills.io specifications
+argument-hint: "skill name and requirements"
+---
+
+# Create Skill
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Skill file creation
+
+Create a new agent skill following VS Code and agentskills.io specifications.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/create-skill.md](../../.claude/prompt-snippets/create-skill.md)

package/src/repo/.cursor/commands/implement-feature.md

@@ -0,0 +1,17 @@
+---
+description: Implement a feature by completing tasks sequentially
+argument-hint: "feature specification or task list"
+---
+
+# Implement Feature
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `fixer` | Bounded feature work — spec is clear, files are known |
+| `feature-builder` | Complex feature — needs research, planning, and coordination |
+
+Implement a feature by completing tasks sequentially with proper tracking.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/implement-feature.md](../../.claude/prompt-snippets/implement-feature.md)

package/src/repo/.cursor/commands/implement-fixes.md

@@ -0,0 +1,17 @@
+---
+description: Implement bug fixes with proper tracking and validation
+argument-hint: "bug description or fix requirements"
+---
+
+# Implement Fixes
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `fixer` | Bounded fixes — clear root cause, known scope |
+| `oracle` | Ambiguous fixes — root cause unclear, needs investigation first |
+
+Implement bug fixes and corrections with proper validation and documentation.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/implement-fixes.md](../../.claude/prompt-snippets/implement-fixes.md)

package/src/repo/.cursor/commands/implement.md

@@ -0,0 +1,17 @@
+---
+description: Execute implementation tasks from a task list or specification
+argument-hint: "task list or specification"
+---
+
+# Implement
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `fixer` | Bounded implementation — clear spec, known target |
+| `oracle` | Ambiguous implementation — needs architectural judgment first |
+
+Execute implementation tasks from a task list or specification with orchestrator-first flow.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/implement.md](../../.claude/prompt-snippets/implement.md)

package/src/repo/.cursor/commands/plan.md

@@ -0,0 +1,17 @@
+---
+description: Create an implementation plan from a feature specification or requirement
+argument-hint: "feature specification or requirement"
+---
+
+# Plan
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `planner` | Standard implementation plan — breaking work into tasks |
+| `oracle` | Architectural planning — trade-offs, system design, risk analysis |
+
+Create an implementation plan from a feature specification or requirement.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/plan.md](../../.claude/prompt-snippets/plan.md)

package/src/repo/.cursor/commands/playwright-test.md

@@ -0,0 +1,15 @@
+---
+description: Run or create E2E tests using Playwright
+argument-hint: "test file or test description"
+---
+
+# Playwright Test
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Test generation and execution
+
+Run or create E2E tests using Playwright.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/playwright-test.md](../../.claude/prompt-snippets/playwright-test.md)

package/src/repo/.cursor/commands/ponytail-audit.md

@@ -0,0 +1,13 @@
+---
+description: Audit the whole repo for over-engineering, what can be deleted
+argument-hint: "no arguments required"
+---
+
+# Ponytail Audit
+
+## Agent Dispatch
+
+> **Recommended agent:** `oracle`
+> Whole-repo over-engineering analysis
+
+**CRITICAL: READ:** [.claude/prompt-snippets/ponytail-audit.md](../../.claude/prompt-snippets/ponytail-audit.md)

package/src/repo/.cursor/commands/ponytail-debt.md

@@ -0,0 +1,13 @@
+---
+description: "Harvest ponytail: comments into a tracked debt ledger"
+argument-hint: "no arguments required"
+---
+
+# Ponytail Debt
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Debt ledger harvesting
+
+**CRITICAL: READ:** [.claude/prompt-snippets/ponytail-debt.md](../../.claude/prompt-snippets/ponytail-debt.md)

package/src/repo/.cursor/commands/ponytail-gain.md

@@ -0,0 +1,13 @@
+---
+description: Show ponytail's measured impact scoreboard (less code, cost, time)
+argument-hint: "no arguments required"
+---
+
+# Ponytail Gain
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Impact scoreboard display
+
+**CRITICAL: READ:** [.claude/prompt-snippets/ponytail-gain.md](../../.claude/prompt-snippets/ponytail-gain.md)

package/src/repo/.cursor/commands/ponytail-help.md

@@ -0,0 +1,13 @@
+---
+description: Quick reference for ponytail levels, skills, and commands
+argument-hint: "no arguments required"
+---
+
+# Ponytail Help
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Quick-reference display
+
+**CRITICAL: READ:** [.claude/prompt-snippets/ponytail-help.md](../../.claude/prompt-snippets/ponytail-help.md)

package/src/repo/.cursor/commands/ponytail-review.md

@@ -0,0 +1,13 @@
+---
+description: Review changes for over-engineering, what can be deleted
+argument-hint: "no arguments required"
+---
+
+# Ponytail Review
+
+## Agent Dispatch
+
+> **Recommended agent:** `oracle`
+> Diff-level over-engineering review
+
+**CRITICAL: READ:** [.claude/prompt-snippets/ponytail-review.md](../../.claude/prompt-snippets/ponytail-review.md)

package/src/repo/.cursor/commands/ponytail.md

@@ -0,0 +1,13 @@
+---
+description: Switch ponytail intensity level (lite/full/ultra/off)
+argument-hint: "ponytail level (lite/full/ultra/off)"
+---
+
+# Ponytail
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Apply YAGNI/stdlib discipline
+
+**CRITICAL: READ:** [.claude/prompt-snippets/ponytail.md](../../.claude/prompt-snippets/ponytail.md)

package/src/repo/.cursor/commands/release-notes.md

@@ -0,0 +1,15 @@
+---
+description: Generate release notes from git commits (web, git tag, or documentation)
+argument-hint: "version or tag"
+---
+
+# Release Notes
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Release notes generation
+
+Generate professional release notes from git commits.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/release-notes.md](../../.claude/prompt-snippets/release-notes.md)

package/src/repo/.cursor/commands/review-pr.md

@@ -0,0 +1,17 @@
+---
+description: Conduct comprehensive pull request code review
+argument-hint: "PR number or URL"
+---
+
+# Review PR
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `reviewer` | Standard PR review — correctness, test coverage, patterns |
+| `oracle` | Complex PR review — architecture, security, cross-system impact |
+
+Conduct comprehensive code review for pull requests with structured fix tracking.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/review-pr.md](../../.claude/prompt-snippets/review-pr.md)

package/src/repo/.cursor/commands/review-staged.md

@@ -0,0 +1,10 @@
+---
+description: Review currently staged files before committing
+argument-hint: "no arguments required"
+---
+
+# Review Staged Files
+
+Comprehensive pre-commit review for staged changes.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/review-staged.md](../../.claude/prompt-snippets/review-staged.md)

package/src/repo/.cursor/commands/review.md

@@ -0,0 +1,17 @@
+---
+description: Conduct code review for files or features
+argument-hint: "file path or feature description"
+---
+
+# Code Review
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `reviewer` | Standard code review — correctness, style, patterns |
+| `oracle` | Complex architectural review — trade-offs, security, scalability |
+
+Review code for quality, security, and adherence to project patterns.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/review.md](../../.claude/prompt-snippets/review.md)

package/src/repo/.cursor/commands/specify.md

@@ -0,0 +1,17 @@
+---
+description: Create a feature specification from a natural language description
+argument-hint: "feature description"
+---
+
+# Specify
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `planner` | Standard feature specification — requirements and acceptance criteria |
+| `oracle` | Complex specification — cross-system design, API contracts, security |
+
+Create a feature specification from a natural language description.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/specify.md](../../.claude/prompt-snippets/specify.md)

package/src/repo/.cursor/commands/tasks.md

@@ -0,0 +1,15 @@
+---
+description: Generate an actionable task list from a specification or plan
+argument-hint: "specification or plan file"
+---
+
+# Tasks
+
+## Agent Dispatch
+
+> **Recommended agent:** `planner`
+> Task breakdown and management
+
+Break down a feature into actionable tasks from a specification or plan.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/tasks.md](../../.claude/prompt-snippets/tasks.md)

package/src/repo/.cursor/mcp.json

@@ -0,0 +1,13 @@
+{
+    "mcpServers": {
+        // Add your MCP servers here
+        // Example:
+        // "example-server": {
+        //     "command": "npx",
+        //     "args": ["-y", "@example/mcp-server@latest"],
+        //     "env": {
+        //         "API_KEY": "${API_KEY}"
+        //     }
+        // }
+    }
+}

package/src/repo/.cursor/rules/agent-conduct.mdc

@@ -0,0 +1,11 @@
+---
+description: Agent conduct, clarification protocols, and assumption handling
+globs:
+alwaysApply: agent
+---
+
+# Agent Conduct
+
+Agents must follow conduct rules for clarification, assumption handling, and guardrails.
+
+**CRITICAL: READ:** [.claude/rules-snippets/agent-conduct.md](../../.claude/rules-snippets/agent-conduct.md)