nitm-ai-dev-toolkit 3.0.15

package/CHANGELOG.md

@@ -0,0 +1,109 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Custom agent templates (`.agent.md`) for subagent orchestration workflows
+- Feature Builder coordinator agent for end-to-end feature development
+- TDD coordinator agent with Red-Green-Refactor cycle
+- Worker agents: Planner, Implementer, Reviewer, Researcher, Red, Green, Refactor
+- Agent templates in both `.github/agents/` and `.cursor/agents/` for VS Code and Cursor support
+- Docs app sync requirements and per-app documentation obligations in monorepo documentation instructions
+- Pre-commit documentation gate checklist for monorepo template
+- Feature specification template (`feature-spec.template.md`)
+- Feature implementation plan template (`feature-plan.template.md`)
+- Complex fix specification template (`complex-fix-spec.template.md`)
+- Complex fix implementation plan template (`complex-fix-plan.template.md`)
+- Architecture Decision Record template (`adr.template.md`)
+- Documentation folders for architecture (`docs/architecture/`) and API (`docs/api/`)
+- README files for skills directories (`.cursor/skills/`, `.github/skills/`)
+- `bkt-cli` skill — Bitbucket CLI (`bkt`) command reference for repo and monorepo templates
+- `glab-cli` skill — GitLab CLI (`glab`) command reference for repo and monorepo templates
+- Ponytail skill bundle — 6 YAGNI/stdlib/native/minimum-discipline skills (`ponytail`, `ponytail-audit`, `ponytail-debt`, `ponytail-gain`, `ponytail-help`, `ponytail-review`)
+- Ponytail OpenCode plugin (`.opencode/plugins/ponytail.mjs`) loaded via the `plugin` config key
+- 7 ponytail hooks in `hooks/` (`ponytail-activate`, `ponytail-config`, `ponytail-instructions`, `ponytail-mode-tracker`, `ponytail-runtime`, `ponytail-statusline.sh`, `ponytail-statusline.ps1`), plus 2 hook configuration files for Claude/Codex and Copilot (`claude-codex-hooks.json`, `copilot-hooks.json`)
+- Ponytail rule in `.agents/rules/` and `.cursor/rules/` for ambient agent context
+- 6 ponytail commands (`ponytail`, `ponytail-audit`, `ponytail-debt`, `ponytail-gain`, `ponytail-help`, `ponytail-review`) with thin-wrapper sources in `.claude/prompt-snippets/`
+- `check-parity.sh` extended with a Ponytail Parity block
+- `orient-to-recent-work` skill — auto-loaded at session start, orients agents to recent activity (CHANGELOG Unreleased, recent commits) before any non-trivial task
+- npm package (`nitm-ai-dev-toolkit`) with a zero-dependency CLI: `install`, `patch`, `upgrade`, `doctor`, `omo-slim-starter install`
+- CLI scaffolds AI agent config (Cursor, GitHub Copilot, Claude Code, OpenCode) into a target repo, then hands off to an AI agent to run the bootstrap flow
+- `doctor` command inspects installs: missing files and unresolved `{{PLACEHOLDER}}` values
+- GitHub Actions workflow (`.github/workflows/publish.yml`) publishing the package to npm on tagged versions (`v*`)
+- CLI test suite (`test/cli.test.js`) using the built-in `node:test` runner (zero dependencies), covering project-type detection, environment scoping, install conflict handling, `doctor` checks, placeholder scanning, and bootstrap handoff; run via `npm test` and in CI (`.github/workflows/test.yml`)
+
+### Changed
+
+- `install` now aborts if target files already exist (instead of silently skipping) and tells the user to pass `--force` to overwrite or run `patch` to add only missing files
+- `patch` is documented as add-missing-only (never overwrites existing customizations) and re-emits the bootstrap handoff
+- `omo-slim-starter install` now delegates to the published `npx nitm-opencode-starter install` (guides the user if unavailable) instead of cloning the repo and wiring scripts
+- Bootstrap prompts (`bootstrap.md`) now state a "merge, don't clobber" principle so existing customized configs are preserved
+
+### Changed
+
+- Updated AGENTS.md templates with Custom Agents (Subagents) section
+- Updated copilot-instructions.md templates with agent references
+- Updated root README.md with comprehensive subagents documentation
+- Updated repository structure diagrams to include `agents/` directories
+- Updated monorepo `documentation.instructions.md` with docs app (`apps/{{DOCS_APP}}`) sync guidance, per-app documentation obligations table, and content organization patterns
+- Updated bundled skills count from 14 to 16 in README (added `logging` and `project-documentation`)
+- Updated AGENTS.md structure diagram to include `.agents/` folder
+- Cleaned AGENTS.md template to remove project-specific content
+- Updated skill reference table in `src/repo/AGENTS.md` to list all 16 skills
+- CLI `install` scaffolds all harnesses by default; `--env` is now optional (the `/bootstrap` command auto-detects the user's environment, so no per-harness runs are needed)
+- `publish.yml` now runs the test suite before publishing (the `publish` job `needs: test`)
+
+### Fixed
+
+- Removed project-specific Nuxt/Vue/Pinia code from AGENTS.md files
+- Synchronized structure diagrams between README.md and AGENTS.md
+- Added missing templates referenced in templates/README.md
+- `scripts/pre-commit-check.sh` — early-exit when no files are staged so the CHANGELOG check no longer fires on empty commits (PR #20 review)
+- `scripts/check-parity.sh` — removed duplicate `check_body_match` call for the cursor ↔ github prompt body (PR #20 review)
+- `.opencode/plugins/ponytail.mjs` — wrapped `writeMode` in a try/catch so an unwritable state directory no longer crashes the plugin (PR #20 review)
+- `ponytail-help` SKILL.md and prompt snippet — added missing `ponytail-audit`, `ponytail-debt`, and `/ponytail-gain` entries; corrected OpenCode slash-command count to six; rewrote the Claude-Code-specific Update section to describe the template update flow (PR #20 review)
+- `ponytail-gain` SKILL.md and prompt snippet (repo, monorepo, root) — replaced the phantom `benchmarks/` source reference with the upstream `DietrichGebert/ponytail` repo link (PR #20 review)
+- `README.md` — corrected "8 activation hooks" to "7 activation hooks" to match CHANGELOG and the actual hook count (PR #20 review)
+- Root `AGENTS.md` — corrected skill count from 16 to 32 and completed the bundled skills table
+- `src/repo/AGENTS.md` and `src/monorepo/AGENTS.md` — completed skill tables with all 32 bundled skills
+- `src/repo/CLAUDE.md` — fixed `command/` → `commands/` typo and added missing OpenCode rules/agents references
+- Root `AGENTS.md` — fixed `command/` → `commands/` typo in directory structure diagram
+- `src/monorepo/templates/monthly-fix-log.template.md` — replaced Vue-specific `Component.vue` with generic file paths
+- Template READMEs and docs — replaced project-specific `LEB-123`/`LEB-456` with generic `ISSUE-123`/`ISSUE-456`
+- Renamed `composition-api-component-structure` rule to `component-structure` across repo and monorepo templates
+- Comprehensive template review fixes: corrected `CLAUDE.md` `@import` paths (`prompt-snippets` → `rules-snippets`); fixed broken `../.agents/` skill links in `src/repo/AGENTS.md` and `src/monorepo/AGENTS.md`; updated README bundled-skills count to 32 and added `bkt-cli`/`glab-cli` rows; synced truncated monorepo rules-snippets (`agent-conduct`, `subagent-workflow`, `coding-standards`, `core-libraries`) to repo; converted inlined Cursor commands (`review-pr`, `review`, `commit-push`) to thin wrappers; aligned monorepo agent `tools:` names to Claude Code standard; fixed root `.opencode/commands` snippet imports; added missing `testing.md` rule and `component-structure.md` snippet; removed remaining `composition-api-component-structure` stale files
+- Agent tool permissions corrected across repo and monorepo templates: Planner gained write + terminal (Copilot `edit`/`runInTerminal`/`terminalLastCommand`, OpenCode `edit: allow, bash: allow`, Claude `Bash(*)`); Documenter gained `Edit` + `Bash(*)` and OpenCode `edit: allow, bash: allow`; Researcher (Claude) lost `Write` (read-only); Reviewer (Claude) lost `Write` and OpenCode gained `bash: allow` (read + terminal). Added Agent Tool & Permission Calibration step to both `bootstrap.md` files
+
+## [0.1.0] - 2026-01-26
+
+### Added
+
+- Initial release of AI-Assisted Development Toolkit
+- Single repository templates (`src/repo/`)
+- Monorepo templates (`src/monorepo/`)
+- 16 bundled universal skills in `.agents/skills/`
+- 13 Cursor IDE rules (`.cursor/rules/`)
+- 14 Cursor commands (`.cursor/commands/`)
+- 13 GitHub Copilot prompts (`.github/prompts/`)
+- 4 GitHub Copilot instructions (`.github/instructions/`)
+- Bootstrap command for automatic project configuration
+- Support for multiple language ecosystems:
+  - JavaScript/TypeScript
+  - PHP
+  - .NET (C#/F#)
+  - Python
+  - Ruby
+  - Go
+  - Rust
+  - Java/Kotlin
+- Documentation structure templates (`docs/features/`, `docs/fixes/`)
+- Monthly fix log template
+
+[Unreleased]: https://github.com/ninjasitm/ai-assisted-dev-toolkit/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/ninjasitm/ai-assisted-dev-toolkit/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ninjasitm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.