hatch3r 1.1.0 → 1.2.0

package/commands/hatch3r-dep-audit.md

@@ -2,6 +2,7 @@
 id: hatch3r-dep-audit
 type: command
 description: Scan, assess, and upgrade npm dependencies. Categorizes findings by severity (CVEs, major/minor/patch outdated), researches migration paths, upgrades packages one at a time with testing, and creates tracking issues for unaddressed items.
+tags: [maintenance, security]
 ---
 
 ## Agent Pipeline
@@ -16,7 +17,7 @@ Scan, assess, and upgrade npm dependencies for **{owner}/{repo}** (root and any
 
 ## Shared Context
 
-**Read the project's shared board context at the start of the run** (e.g., `.cursor/commands/board-shared.md` or equivalent). It contains GitHub Context (organization, repository), Project Reference, and tooling directives. Use GitHub MCP tools for issue creation. Use Context7 MCP for library docs and migration guides. Use web research for CVE details and known workarounds.
+**Read the project's shared board context at the start of the run** (e.g., `.agents/commands/hatch3r-board-shared.md` or equivalent). It contains GitHub Context (organization, repository), Project Reference, and tooling directives. Use GitHub MCP tools for issue creation. Use Context7 MCP for library docs and migration guides. Use web research for CVE details and known workarounds.
 
 ## Global Rule Overrides
 

package/commands/hatch3r-feature-plan.md

@@ -2,6 +2,7 @@
 id: hatch3r-feature-plan
 type: command
 description: Plan a single feature in depth -- spawn parallel researchers, produce feature spec, ADR(s), and structured todo.md entries for board-fill.
+tags: [core, planning]
 ---
 
 ## Agent Pipeline

package/commands/hatch3r-healthcheck.md

@@ -2,6 +2,7 @@
 id: hatch3r-healthcheck
 type: command
 description: Create a full-product QA and testing audit epic with one sub-issue per project module
+tags: [maintenance]
 ---
 
 ## Agent Pipeline
@@ -24,7 +25,7 @@ Create a healthcheck epic on **{owner}/{repo}** with one sub-issue per logical p
 
 ## Shared Context
 
-**Read the project's shared board context at the start of the run** (e.g., `.cursor/commands/board-shared.md` or equivalent). It contains GitHub Context, Project Reference, Projects v2 sync procedure, and Board Overview template. Cache all values for the duration of this run.
+**Read the project's shared board context at the start of the run** (e.g., `.agents/commands/hatch3r-board-shared.md` or equivalent). It contains GitHub Context, Project Reference, Projects v2 sync procedure, and Board Overview template. Cache all values for the duration of this run.
 
 ## Token-Saving Directives
 

package/commands/hatch3r-hooks.md

@@ -2,6 +2,7 @@
 id: hatch3r-hooks
 type: command
 description: Define and manage event-driven hooks that activate agents on project events
+tags: [core, devops]
 ---
 
 ## Agent Pipeline

package/commands/hatch3r-learn.md

@@ -2,6 +2,7 @@
 id: hatch3r-learn
 type: command
 description: Capture learnings from development sessions into reusable knowledge files for future consultation.
+tags: [core, maintenance]
 ---
 
 ## Agent Pipeline

package/commands/hatch3r-migration-plan.md

@@ -2,6 +2,7 @@
 id: hatch3r-migration-plan
 type: command
 description: Create a phased migration plan for a major dependency or framework upgrade. Analyzes breaking changes and produces an actionable plan with rollback procedures.
+tags: [planning, brownfield]
 ---
 
 ## Agent Pipeline

package/commands/hatch3r-onboard.md

@@ -2,6 +2,7 @@
 id: hatch3r-onboard
 type: command
 description: Generate a comprehensive onboarding guide for a new developer joining the project -- spawn parallel researchers to analyze codebase structure, architecture, and conventions, then produce a tailored onboarding document with setup instructions, architecture walkthrough, coding conventions, key workflows, tribal knowledge, and a quick-reference cheat sheet.
+tags: [brownfield, team]
 ---
 
 ## Agent Pipeline

package/commands/hatch3r-project-spec.md

@@ -2,6 +2,7 @@
 id: hatch3r-project-spec
 type: command
 description: Generate complete business and technical project documentation (specs, ADRs, todo.md) from a project vision using parallel researcher sub-agents with dual business/technical scoping.
+tags: [planning, greenfield]
 ---
 # Project Spec — Greenfield Project Specification from Vision to Docs
 

package/commands/hatch3r-quick-change.md

@@ -2,6 +2,7 @@
 id: hatch3r-quick-change
 type: command
 description: Lightweight command for small changes not worth tracking on the board. Adaptive ceremony with inline or sub-agent implementation, batch support, and soft scope guards.
+tags: [core, implementation]
 ---
 
 ## Agent Pipeline

package/commands/hatch3r-recipe.md

@@ -2,6 +2,7 @@
 id: hatch3r-recipe
 type: command
 description: Execute shareable workflow recipes that compose agents, skills, and commands into guided sequences for common development scenarios
+tags: [core]
 ---
 
 ## Agent Pipeline

package/commands/hatch3r-refactor-plan.md

@@ -2,6 +2,7 @@
 id: hatch3r-refactor-plan
 type: command
 description: Plan a refactoring or migration effort -- spawn parallel researchers, produce refactoring spec, ADR(s), and phased todo.md entries for board-fill.
+tags: [planning]
 ---
 
 ## Agent Pipeline

package/commands/hatch3r-release.md

@@ -2,6 +2,7 @@
 id: hatch3r-release
 type: command
 description: Cut a versioned release with changelog generation, version bumping, and GitHub release creation.
+tags: [devops]
 ---
 # Release — Cut a Versioned Release with Changelog
 
@@ -15,7 +16,7 @@ This command runs as a single orchestrator without sub-agent delegation. Quality
 
 ## Shared Context
 
-**Read the project's shared board context at the start of the run** (e.g., `.cursor/commands/board-shared.md` or equivalent). It contains GitHub Context, Project Reference, and tooling directives. Use GitHub MCP tools for issue/PR operations. Fallback to `gh` CLI for release creation (outside MCP catalog).
+**Read the project's shared board context at the start of the run** (e.g., `.agents/commands/hatch3r-board-shared.md` or equivalent). It contains GitHub Context, Project Reference, and tooling directives. Use GitHub MCP tools for issue/PR operations. Fallback to `gh` CLI for release creation (outside MCP catalog).
 
 **Default branch:** Use `board.defaultBranch` from `.agents/hatch.json` (fallback: `"main"`) for all git operations involving the base branch (e.g., `git log`, `search_pull_requests` with `base`, `git push origin`).
 

package/commands/hatch3r-revision.md

@@ -2,6 +2,7 @@
 id: hatch3r-revision
 type: command
 description: User-guided revision of agent-implemented code in a fresh context window. Reconstructs what was done, interviews the user for feedback, fixes issues, cleans up leftovers, and drives toward merge readiness.
+tags: [implementation, team]
 ---
 
 ## Agent Pipeline

package/commands/hatch3r-roadmap.md

@@ -2,6 +2,7 @@
 id: hatch3r-roadmap
 type: command
 description: Generate a dual-lens phased roadmap (business milestones + technical milestones) from specs and vision using parallel researcher sub-agents, output to todo.md in the format that hatch3r-board-fill expects.
+tags: [planning, greenfield]
 ---
 # Roadmap — Generate Phased Roadmap from Specs & Vision
 
@@ -309,7 +310,7 @@ Map technically-driven milestones across the timeline:
 | Phase | Label | Business Criteria | Technical Criteria |
 | ----- | ---- | ----------------- | ------------------ |
 | P0 | Critical / Launch Blockers | Revenue-blocking features, regulatory deadlines, market timing windows | Security fixes, data integrity, core infrastructure dependencies |
-| P1 | Core Features | Primary value-delivering features, conversion-critical flows, first GTM channel enablement | Essential integrations, performance baselines, CI/CD |
+| P1 | Core Features | Primary value-delivering features, conversion-critical flows, first GTM channel enablement | Essential integrations, performance baselines, CI/CD, compound system integrity checks |
 | P2 | Important | Secondary features, retention improvements, additional GTM channels | Quality improvements, significant refactors, testing gaps, monitoring |
 | P3 | Nice to Have | Polish, upsell features, market expansion preparation | Optimizations, non-critical enhancements, developer experience |
 | P4+ | Future Ideas | Long-term market plays, new segments, platform strategy | Long-term architecture evolution, experimental technology |
@@ -531,6 +532,8 @@ If `AGENTS.md` already exists, **ASK** before overwriting: "Root `AGENTS.md` alr
 
 Which would you like to run next? (or none)"
 
+**Future command:** `hatch3r-test-plan` — generates a test plan from the current task context (issue, spec references, acceptance criteria) covering unit, integration, and E2E test scenarios. Not yet implemented; tracked for a future release.
+
 ---
 
 ## Error Handling
@@ -545,6 +548,10 @@ Which would you like to run next? (or none)"
 - **Stage assessment unclear:** Default to "early-revenue" if the user is unsure. This provides balanced prioritization without over- or under-engineering the roadmap.
 - **No business specs found:** If only technical specs exist (legacy layout), generate a technical-only roadmap and recommend running `hatch3r-project-spec` or `hatch3r-codebase-map` to create business specs.
 
+## Adapter Breadth as Differentiation
+
+Hatch3r's breadth across 13+ adapters (Claude, Cursor, Windsurf, Cline, Copilot, Codex, Gemini, Amp, Aider, Goose, Kiro, OpenCode, Zed) is a core differentiation strategy. To maintain this moat, recommend periodic adapter parity audits as part of any roadmap that includes hatch3r-internal work. The audit should verify that no adapter has fallen behind in feature support (e.g., missing MCP, hooks, or skills support that other adapters already handle). Adapter parity gaps should be tracked as `[TECH]` items at P2 priority or higher.
+
 ## Guardrails
 
 - **Never skip ASK checkpoints.** Every step with an ASK must pause for user confirmation.

package/commands/hatch3r-rule-customize.md

@@ -2,6 +2,7 @@
 id: hatch3r-rule-customize
 type: command
 description: Configure per-rule customization including scope overrides, description changes, enable/disable control, and project-specific markdown instructions
+tags: [customize]
 ---
 
 ## Agent Pipeline

package/commands/hatch3r-security-audit.md

@@ -2,6 +2,7 @@
 id: hatch3r-security-audit
 type: command
 description: Create a full-product security audit epic with one sub-issue per project module
+tags: [maintenance, security]
 ---
 
 ## Agent Pipeline
@@ -24,7 +25,7 @@ Create a security audit epic on **{owner}/{repo}** with one sub-issue per logica
 
 ## Shared Context
 
-**Read the project's shared board context at the start of the run** (e.g., `.cursor/commands/board-shared.md` or equivalent). It contains GitHub Context, Project Reference, Projects v2 sync procedure, and Board Overview template. Cache all values for the duration of this run.
+**Read the project's shared board context at the start of the run** (e.g., `.agents/commands/hatch3r-board-shared.md` or equivalent). It contains GitHub Context, Project Reference, Projects v2 sync procedure, and Board Overview template. Cache all values for the duration of this run.
 
 ## Token-Saving Directives
 

package/commands/hatch3r-skill-customize.md

@@ -2,6 +2,7 @@
 id: hatch3r-skill-customize
 type: command
 description: Configure per-skill customization including description overrides, enable/disable control, and project-specific markdown instructions
+tags: [customize]
 ---
 
 ## Agent Pipeline