nitm-ai-dev-toolkit 3.0.15

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

@@ -0,0 +1,36 @@
+# GitHub Copilot Skills
+
+This folder is for skills installed via `npx -y skills add <owner/repo> --skill '*' --agent github-copilot cursor` when using GitHub Copilot.
+
+## 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 github-copilot` flag:
+
+```bash
+# For GitHub Copilot only
+npx -y skills add -a github-copilot <owner/repo> --skill '*' --agent github-copilot cursor
+
+# For multiple agents (e.g., Copilot + Cursor)
+npx -y skills add -a github-copilot -a cursor <owner/repo> --skill '*' --agent github-copilot cursor
+```
+
+**Tip:** The skills CLI automatically detects installed agents. If you omit `-a github-copilot`, 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 github-copilot` to install only for GitHub Copilot (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...
+
+See the main README.md for a full list of recommended skills.

package/src/repo/.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/.opencode/agents/admin-portal.md

@@ -0,0 +1,14 @@
+---
+description: "Build administrator portals with RBAC, system dashboards, reporting, analytics, and operational tooling. Specializes in admin frameworks and monitoring ecosystem tools."
+mode: subagent
+temperature: 0.1
+permission:
+  edit: allow
+  bash: allow
+---
+
+# Admin Portal Specialist
+
+Build administrator portals with RBAC, system dashboards, reporting, analytics, and operational tooling.
+
+@.claude/agents-snippets/admin-portal.md

package/src/repo/.opencode/agents/api-specialist.md

@@ -0,0 +1,14 @@
+---
+description: "Design and implement API architecture, documentation, and developer experience. Use for REST design, GraphQL, OpenAPI specs, SDK generation, API versioning, and integration patterns."
+mode: subagent
+temperature: 0.1
+permission:
+  edit: allow
+  bash: allow
+---
+
+# API Specialist
+
+Design and implement API architecture, documentation, and developer experience.
+
+@.claude/agents-snippets/api-specialist.md

package/src/repo/.opencode/agents/backend-architect.md

@@ -0,0 +1,14 @@
+---
+description: "Design APIs, databases, and server-side architecture. Use for scalable backend systems, data modeling, caching strategies, system design, and infrastructure decisions."
+mode: subagent
+temperature: 0.1
+permission:
+  edit: allow
+  bash: allow
+---
+
+# Backend Architect
+
+Design APIs, databases, and server-side architecture.
+
+@.claude/agents-snippets/backend-architect.md

package/src/repo/.opencode/agents/documenter.md

@@ -0,0 +1,14 @@
+---
+description: "Analyze codebases and create comprehensive documentation. Use for AGENTS.md, README files, API docs, architecture documentation, and onboarding guides."
+mode: subagent
+temperature: 0.1
+permission:
+  edit: allow
+  bash: allow
+---
+
+# Documenter
+
+Analyze codebases and create comprehensive documentation.
+
+@.claude/agents-snippets/documenter.md

package/src/repo/.opencode/agents/feature-builder.md

@@ -0,0 +1,15 @@
+---
+description: "Coordinate end-to-end feature development using subagents for planning, implementation, and review. Orchestrates the full development lifecycle."
+mode: subagent
+temperature: 0.3
+permission:
+  edit: allow
+  bash: allow
+  task: allow
+---
+
+# Feature Builder — Coordinator
+
+Coordinate end-to-end feature development using subagents for planning, implementation, and review.
+
+@.claude/agents-snippets/feature-builder.md

package/src/repo/.opencode/agents/frontend-developer.md

@@ -0,0 +1,14 @@
+---
+description: "Build user interfaces, implement components, handle state management, and optimize frontend performance. Use for responsive, accessible, and performant web applications."
+mode: subagent
+temperature: 0.1
+permission:
+  edit: allow
+  bash: allow
+---
+
+# Frontend Developer
+
+Build user interfaces, implement components, handle state management, and optimize frontend performance.
+
+@.claude/agents-snippets/frontend-developer.md

package/src/repo/.opencode/agents/green.md

@@ -0,0 +1,14 @@
+---
+description: "Write minimal code to make failing tests pass. Part of the TDD red-green-refactor cycle."
+mode: subagent
+temperature: 0.1
+permission:
+  edit: allow
+  bash: allow
+---
+
+# Green Agent (TDD — Make Tests Pass)
+
+Write minimal code to make failing tests pass. Part of the TDD red-green-refactor cycle.
+
+@.claude/agents-snippets/green.md

package/src/repo/.opencode/agents/implementer.md

@@ -0,0 +1,14 @@
+---
+description: "Implement code changes for a specific task. Follow TDD, write tests alongside code, and self-review before reporting completion."
+mode: subagent
+temperature: 0.1
+permission:
+  edit: allow
+  bash: allow
+---
+
+# Implementer Agent
+
+Implement code changes for a specific task. Follow TDD, write tests alongside code, and self-review before reporting completion.
+
+@.claude/agents-snippets/implementer.md

package/src/repo/.opencode/agents/planner.md

@@ -0,0 +1,14 @@
+---
+description: "Break down feature requests into implementation tasks. Read specifications, analyze codebase patterns, and produce structured plans with dependencies."
+mode: subagent
+temperature: 0.1
+permission:
+  edit: allow
+  bash: allow
+---
+
+# Planner Agent
+
+Break down feature requests into implementation tasks. Read specifications, analyze codebase patterns, and produce structured plans with dependencies.
+
+@.claude/agents-snippets/planner.md

package/src/repo/.opencode/agents/red.md

@@ -0,0 +1,14 @@
+---
+description: "Write failing tests that define expected behavior. Part of the TDD red-green-refactor cycle."
+mode: subagent
+temperature: 0.1
+permission:
+  edit: allow
+  bash: allow
+---
+
+# Red Agent (TDD — Write Failing Tests)
+
+Write failing tests that define expected behavior. Part of the TDD red-green-refactor cycle.
+
+@.claude/agents-snippets/red.md

package/src/repo/.opencode/agents/refactor.md

@@ -0,0 +1,14 @@
+---
+description: "Improve code quality and structure while keeping all tests passing. Part of the TDD red-green-refactor cycle."
+mode: subagent
+temperature: 0.1
+permission:
+  edit: allow
+  bash: allow
+---
+
+# Refactor Agent (TDD — Improve Code Quality)
+
+Improve code quality and structure while keeping all tests passing. Part of the TDD red-green-refactor cycle.
+
+@.claude/agents-snippets/refactor.md

package/src/repo/.opencode/agents/researcher.md

@@ -0,0 +1,14 @@
+---
+description: "Research codebase patterns, dependencies, and technical context. Analyze code structure, find relevant examples, and report findings without making changes."
+mode: subagent
+temperature: 0.1
+permission:
+  edit: deny
+  bash: deny
+---
+
+# Researcher Agent
+
+Research codebase patterns, dependencies, and technical context. Analyze code structure, find relevant examples, and report findings without making changes.
+
+@.claude/agents-snippets/researcher.md

package/src/repo/.opencode/agents/reviewer.md

@@ -0,0 +1,14 @@
+---
+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."
+mode: subagent
+temperature: 0.1
+permission:
+  edit: deny
+  bash: allow
+---
+
+# Reviewer Agent
+
+Review code changes for correctness, code quality, security, and adherence to project patterns.
+
+@.claude/agents-snippets/reviewer.md

package/src/repo/.opencode/agents/tdd.md

@@ -0,0 +1,15 @@
+---
+description: "Implement a feature using test-driven development with red-green-refactor cycle. Coordinates specialized subagents for writing failing tests, implementing code, and refactoring."
+mode: subagent
+temperature: 0.3
+permission:
+  edit: allow
+  bash: allow
+  task: allow
+---
+
+# TDD Coordinator Agent
+
+Implement a feature using test-driven development with red-green-refactor cycle.
+
+@.claude/agents-snippets/tdd.md

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

@@ -0,0 +1,16 @@
+---
+description: "Create {{ISSUE_TRACKER}} tickets from requirements or task files"
+---
+
+# Assign Tasks
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Task assignment and execution
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/assign-tasks.md

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

@@ -0,0 +1,18 @@
+---
+description: "Patch AI instructions by fetching updates from the toolkit repo and applying new/updated/missing guidance"
+---
+
+# Patch AI Instructions
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `fixer` | Standard patch — incremental changes to existing config |
+| `planner` | Complex patch — cross-cutting changes needing analysis first |
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/bootstrap-patch.md

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

@@ -0,0 +1,18 @@
+---
+description: "Upgrade AI instructions from pre-3.0 inline pattern to 3.0+ snippet architecture"
+---
+
+# Bootstrap Upgrade
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `fixer` | Standard upgrade — version bump and migration |
+| `planner` | Complex upgrade — breaking changes needing dependency analysis |
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/bootstrap-upgrade.md

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

@@ -0,0 +1,18 @@
+---
+description: "Bootstrap AI instructions by inferring project details and customizing templates"
+---
+
+# Bootstrap AI Instructions
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `fixer` | Standard bootstrap — project analysis and template customization |
+| `planner` | Complex bootstrap — needs requirements gathering and architecture decisions first |
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/bootstrap.md

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

@@ -0,0 +1,16 @@
+---
+description: "Commit and push changes with conventional commit messages"
+---
+
+# Commit & Push
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Git operations, execution-focused
+
+Commit and push changes using conventional commit format.
+
+@.claude/prompt-snippets/commit-push.md
+
+$ARGUMENTS

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

@@ -0,0 +1,18 @@
+---
+description: "Create or update the project constitution defining core principles and guidelines"
+---
+
+# Project Constitution
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `oracle` | Project principles and governance — architectural decisions |
+| `planner` | Project conventions and standards — team norms and practices |
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/constitution.md

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

@@ -0,0 +1,16 @@
+---
+description: "Create a new agent skill following VS Code and agentskills.io specifications"
+---
+
+# Create Skill
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Skill file creation
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/create-skill.md

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

@@ -0,0 +1,18 @@
+---
+description: "Implement a feature by completing tasks sequentially"
+---
+
+# 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 |
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/implement-feature.md

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

@@ -0,0 +1,20 @@
+---
+description: Implement bug fixes with proper tracking and validation
+allowed-tools: "Read, Write, Edit, Bash(*)"
+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 |
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/implement-fixes.md

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

@@ -0,0 +1,18 @@
+---
+description: "Execute implementation tasks from a task list or specification"
+---
+
+# Execute Implementation Tasks
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `fixer` | Bounded implementation — clear spec, known target |
+| `oracle` | Ambiguous implementation — needs architectural judgment first |
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/implement.md

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

@@ -0,0 +1,18 @@
+---
+description: "Create an implementation plan from a feature specification or requirement"
+---
+
+# Create Implementation Plan
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `planner` | Standard implementation plan — breaking work into tasks |
+| `oracle` | Architectural planning — trade-offs, system design, risk analysis |
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/plan.md

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

@@ -0,0 +1,16 @@
+---
+description: "Run or create E2E tests using Playwright"
+---
+
+# Playwright E2E Tests
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Test generation and execution
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/playwright-test.md

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

@@ -0,0 +1,10 @@
+---
+description: "Whole-repo audit for over-engineering. Scans entire codebase for what to delete, simplify, replace."
+---
+
+## Agent Dispatch
+
+> **Recommended agent:** `oracle`
+> Whole-repo over-engineering analysis
+
+@.claude/prompt-snippets/ponytail-audit.md

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

@@ -0,0 +1,10 @@
+---
+
+---
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Debt ledger harvesting
+
+@.claude/prompt-snippets/ponytail-debt.md

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

@@ -0,0 +1,10 @@
+---
+
+---
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Impact scoreboard display
+
+@.claude/prompt-snippets/ponytail-gain.md

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

@@ -0,0 +1,10 @@
+---
+
+---
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Quick-reference display
+
+@.claude/prompt-snippets/ponytail-help.md

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

@@ -0,0 +1,10 @@
+---
+
+---
+
+## Agent Dispatch
+
+> **Recommended agent:** `oracle`
+> Diff-level over-engineering review
+
+@.claude/prompt-snippets/ponytail-review.md

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

@@ -0,0 +1,10 @@
+---
+description: "Forces the laziest solution that actually works — YAGNI, stdlib, native, one-line, minimum."
+---
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Apply YAGNI/stdlib discipline
+
+@.claude/prompt-snippets/ponytail.md

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

@@ -0,0 +1,16 @@
+---
+description: "Generate release notes from git commits (web, git tag, or documentation)"
+---
+
+# Generate Release Notes
+
+## Agent Dispatch
+
+> **Recommended agent:** `fixer`
+> Release notes generation
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/release-notes.md

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

@@ -0,0 +1,18 @@
+---
+description: "Review pull request for code quality and best practices"
+---
+
+# PR Review
+
+## 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.
+
+@.claude/prompt-snippets/review-pr.md
+
+$ARGUMENTS

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

@@ -0,0 +1,11 @@
+---
+description: "Review currently staged files before committing"
+---
+
+# Review Staged Files
+
+## Agent Dispatch
+| Agent | When to use |
+|-------|-------------|
+| `reviewer` | Standard pre-commit review — correctness, style, patterns |
+| `oracle` | Complex staged change — trade-offs, security, scalability |

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

@@ -0,0 +1,18 @@
+---
+description: "Review code for quality, consistency, and adherence to project patterns"
+---
+
+# 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.
+
+@.claude/prompt-snippets/review.md
+
+$ARGUMENTS

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

@@ -0,0 +1,18 @@
+---
+description: "Create a feature specification from a natural language description"
+---
+
+# Create Feature Specification
+
+## Agent Dispatch
+
+| Agent | When to use |
+|-------|-------------|
+| `planner` | Standard feature specification — requirements and acceptance criteria |
+| `oracle` | Complex specification — cross-system design, API contracts, security |
+
+## Arguments
+
+$ARGUMENTS
+
+@.claude/prompt-snippets/specify.md