hatch3r 1.6.2 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (170) hide show
  1. package/README.md +5 -5
  2. package/agents/hatch3r-a11y-auditor.md +5 -0
  3. package/agents/hatch3r-architect.md +5 -0
  4. package/agents/hatch3r-ci-watcher.md +5 -0
  5. package/agents/hatch3r-context-rules.md +5 -0
  6. package/agents/hatch3r-creator.md +304 -0
  7. package/agents/hatch3r-dependency-auditor.md +5 -0
  8. package/agents/hatch3r-devops.md +5 -0
  9. package/agents/hatch3r-docs-writer.md +5 -0
  10. package/agents/hatch3r-fixer.md +5 -0
  11. package/agents/hatch3r-implementer.md +5 -0
  12. package/agents/hatch3r-learnings-loader.md +5 -0
  13. package/agents/hatch3r-lint-fixer.md +5 -0
  14. package/agents/hatch3r-perf-profiler.md +5 -0
  15. package/agents/hatch3r-researcher.md +5 -0
  16. package/agents/hatch3r-reviewer.md +5 -0
  17. package/agents/hatch3r-security-auditor.md +5 -0
  18. package/agents/hatch3r-test-writer.md +5 -0
  19. package/agents/modes/architecture.md +3 -0
  20. package/agents/modes/boundary-analysis.md +3 -0
  21. package/agents/modes/codebase-impact.md +3 -0
  22. package/agents/modes/complexity-risk.md +3 -0
  23. package/agents/modes/coverage-analysis.md +3 -0
  24. package/agents/modes/current-state.md +3 -0
  25. package/agents/modes/feature-design.md +3 -0
  26. package/agents/modes/impact-analysis.md +3 -0
  27. package/agents/modes/library-docs.md +3 -0
  28. package/agents/modes/migration-path.md +3 -0
  29. package/agents/modes/prior-art.md +3 -0
  30. package/agents/modes/refactoring-strategy.md +3 -0
  31. package/agents/modes/regression.md +3 -0
  32. package/agents/modes/requirements-elicitation.md +3 -0
  33. package/agents/modes/risk-assessment.md +3 -0
  34. package/agents/modes/risk-prioritization.md +3 -0
  35. package/agents/modes/root-cause.md +3 -0
  36. package/agents/modes/similar-implementation.md +3 -0
  37. package/agents/modes/symptom-trace.md +3 -0
  38. package/agents/modes/test-pattern.md +3 -0
  39. package/agents/shared/efficiency-patterns.md +71 -0
  40. package/agents/shared/external-knowledge.md +2 -0
  41. package/agents/shared/injection-patterns.md +2 -0
  42. package/agents/shared/prompt-structure.md +2 -0
  43. package/agents/shared/quality-charter.md +10 -0
  44. package/agents/shared/user-content-templates.md +257 -0
  45. package/checks/accessibility.md +1 -0
  46. package/checks/code-quality.md +1 -0
  47. package/checks/performance.md +1 -0
  48. package/checks/security.md +1 -0
  49. package/checks/testing.md +1 -0
  50. package/commands/board/pickup-azure-devops.md +1 -0
  51. package/commands/board/pickup-delegation-multi.md +1 -0
  52. package/commands/board/pickup-delegation.md +1 -0
  53. package/commands/board/pickup-github.md +1 -0
  54. package/commands/board/pickup-gitlab.md +1 -0
  55. package/commands/board/pickup-modes.md +1 -0
  56. package/commands/board/pickup-post-impl.md +1 -0
  57. package/commands/board/shared-azure-devops.md +1 -0
  58. package/commands/board/shared-board-overview.md +1 -0
  59. package/commands/board/shared-github.md +1 -0
  60. package/commands/board/shared-gitlab.md +1 -0
  61. package/commands/hatch3r-agent-customize.md +9 -2
  62. package/commands/hatch3r-api-spec.md +16 -0
  63. package/commands/hatch3r-benchmark.md +16 -0
  64. package/commands/hatch3r-board-fill.md +16 -0
  65. package/commands/hatch3r-board-groom.md +3 -0
  66. package/commands/hatch3r-board-init.md +3 -0
  67. package/commands/hatch3r-board-pickup.md +16 -0
  68. package/commands/hatch3r-board-refresh.md +3 -0
  69. package/commands/hatch3r-board-shared.md +3 -0
  70. package/commands/hatch3r-bug-plan.md +16 -0
  71. package/commands/hatch3r-codebase-map.md +16 -0
  72. package/commands/hatch3r-command-customize.md +3 -0
  73. package/commands/hatch3r-context-health.md +3 -0
  74. package/commands/hatch3r-cost-tracking.md +3 -0
  75. package/commands/hatch3r-create.md +197 -0
  76. package/commands/hatch3r-debug.md +16 -0
  77. package/commands/hatch3r-dep-audit.md +3 -0
  78. package/commands/hatch3r-feature-plan.md +16 -0
  79. package/commands/hatch3r-healthcheck.md +3 -0
  80. package/commands/hatch3r-hooks.md +3 -0
  81. package/commands/hatch3r-learn.md +3 -0
  82. package/commands/hatch3r-migration-plan.md +16 -0
  83. package/commands/hatch3r-onboard.md +16 -0
  84. package/commands/hatch3r-project-spec.md +16 -0
  85. package/commands/hatch3r-quick-change.md +17 -1
  86. package/commands/hatch3r-recipe.md +3 -0
  87. package/commands/hatch3r-refactor-plan.md +16 -0
  88. package/commands/hatch3r-release.md +3 -0
  89. package/commands/hatch3r-revision.md +16 -0
  90. package/commands/hatch3r-roadmap.md +16 -0
  91. package/commands/hatch3r-rule-customize.md +3 -0
  92. package/commands/hatch3r-security-audit.md +3 -0
  93. package/commands/hatch3r-skill-customize.md +3 -0
  94. package/commands/hatch3r-test-plan.md +16 -0
  95. package/commands/hatch3r-workflow.md +17 -1
  96. package/commands/revision/revision-board-integration.md +1 -0
  97. package/commands/revision/revision-delegation.md +1 -0
  98. package/commands/revision/revision-modes.md +1 -0
  99. package/commands/revision/revision-quality.md +1 -0
  100. package/dist/cli/index.js +2365 -924
  101. package/dist/cli/index.js.map +1 -1
  102. package/github-agents/hatch3r-docs-agent.md +3 -0
  103. package/github-agents/hatch3r-lint-agent.md +3 -0
  104. package/github-agents/hatch3r-security-agent.md +3 -0
  105. package/github-agents/hatch3r-test-agent.md +3 -0
  106. package/hooks/hatch3r-ci-failure.md +1 -0
  107. package/hooks/hatch3r-file-save.md +1 -0
  108. package/hooks/hatch3r-post-merge.md +1 -0
  109. package/hooks/hatch3r-pre-commit.md +1 -0
  110. package/hooks/hatch3r-pre-push.md +1 -0
  111. package/hooks/hatch3r-session-start.md +1 -0
  112. package/package.json +10 -1
  113. package/prompts/hatch3r-bug-triage.md +2 -0
  114. package/prompts/hatch3r-code-review.md +2 -0
  115. package/prompts/hatch3r-pr-description.md +2 -0
  116. package/rules/hatch3r-accessibility-standards.md +1 -0
  117. package/rules/hatch3r-agent-orchestration-detail.md +1 -0
  118. package/rules/hatch3r-agent-orchestration.md +1 -0
  119. package/rules/hatch3r-api-design.md +1 -0
  120. package/rules/hatch3r-browser-verification.md +1 -0
  121. package/rules/hatch3r-ci-cd.md +1 -0
  122. package/rules/hatch3r-code-standards.md +1 -0
  123. package/rules/hatch3r-component-conventions.md +1 -0
  124. package/rules/hatch3r-data-classification.md +1 -0
  125. package/rules/hatch3r-deep-context.md +1 -0
  126. package/rules/hatch3r-dependency-management.md +1 -0
  127. package/rules/hatch3r-feature-flags.md +1 -0
  128. package/rules/hatch3r-git-conventions.md +1 -0
  129. package/rules/hatch3r-i18n.md +1 -0
  130. package/rules/hatch3r-iteration-summary.md +86 -0
  131. package/rules/hatch3r-iteration-summary.mdc +81 -0
  132. package/rules/hatch3r-learning-consult.md +1 -0
  133. package/rules/hatch3r-migrations.md +1 -0
  134. package/rules/hatch3r-observability-logging.md +1 -0
  135. package/rules/hatch3r-observability-metrics.md +1 -0
  136. package/rules/hatch3r-observability-tracing-detail.md +1 -0
  137. package/rules/hatch3r-observability-tracing.md +1 -0
  138. package/rules/hatch3r-observability.md +1 -0
  139. package/rules/hatch3r-performance-budgets.md +1 -0
  140. package/rules/hatch3r-secrets-management.md +1 -0
  141. package/rules/hatch3r-security-patterns.md +1 -0
  142. package/rules/hatch3r-testing.md +1 -0
  143. package/rules/hatch3r-theming.md +1 -0
  144. package/rules/hatch3r-tooling-hierarchy.md +1 -0
  145. package/skills/hatch3r-a11y-audit/SKILL.md +2 -0
  146. package/skills/hatch3r-agent-customize/SKILL.md +2 -0
  147. package/skills/hatch3r-api-spec/SKILL.md +2 -0
  148. package/skills/hatch3r-architecture-review/SKILL.md +2 -0
  149. package/skills/hatch3r-bug-fix/SKILL.md +2 -0
  150. package/skills/hatch3r-ci-pipeline/SKILL.md +2 -0
  151. package/skills/hatch3r-command-customize/SKILL.md +2 -0
  152. package/skills/hatch3r-context-health/SKILL.md +2 -0
  153. package/skills/hatch3r-cost-tracking/SKILL.md +2 -0
  154. package/skills/hatch3r-customize/SKILL.md +2 -0
  155. package/skills/hatch3r-dep-audit/SKILL.md +2 -0
  156. package/skills/hatch3r-feature/SKILL.md +2 -0
  157. package/skills/hatch3r-gh-agentic-workflows/SKILL.md +2 -0
  158. package/skills/hatch3r-incident-response/SKILL.md +2 -0
  159. package/skills/hatch3r-issue-workflow/SKILL.md +2 -0
  160. package/skills/hatch3r-logical-refactor/SKILL.md +2 -0
  161. package/skills/hatch3r-migration/SKILL.md +2 -0
  162. package/skills/hatch3r-perf-audit/SKILL.md +2 -0
  163. package/skills/hatch3r-pr-creation/SKILL.md +2 -0
  164. package/skills/hatch3r-qa-validation/SKILL.md +2 -0
  165. package/skills/hatch3r-recipe/SKILL.md +2 -0
  166. package/skills/hatch3r-refactor/SKILL.md +2 -0
  167. package/skills/hatch3r-release/SKILL.md +2 -0
  168. package/skills/hatch3r-rule-customize/SKILL.md +2 -0
  169. package/skills/hatch3r-skill-customize/SKILL.md +2 -0
  170. package/skills/hatch3r-visual-refactor/SKILL.md +2 -0
@@ -4,6 +4,8 @@ type: skill
4
4
  description: Design and optimize CI/CD pipelines. Covers stage design, test parallelization, artifact management, and pipeline performance.
5
5
  tags: [devops]
6
6
  quality_charter: agents/shared/quality-charter.md
7
+ efficiency_patterns: agents/shared/efficiency-patterns.md
8
+ cache_friendly: true
7
9
  ---
8
10
 
9
11
  # CI Pipeline Workflow
@@ -3,6 +3,8 @@ id: hatch3r-command-customize
3
3
  description: Redirect to edit orchestrator pipeline and prompt wording for slash commands under .hatch3r/commands/ -- use when changing how a command fans out to sub-agents
4
4
  tags: [customize]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  # Command Customization
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-context-health
3
3
  description: Monitor and maintain conversation context health during long sessions. Use when context may be degrading, after many turns, or when experiencing repeated errors.
4
4
  tags: [maintenance]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  # Context Health Monitoring
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-cost-tracking
3
3
  description: Track token usage and estimate costs for agent sessions. Use when monitoring spend, approaching budget limits, or generating cost reports.
4
4
  tags: [maintenance]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  # Cost Tracking Workflow
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-customize
3
3
  description: Create and manage customization files for any hatch3r artifact type (agents, commands, rules, skills). Supports model overrides, description changes, scope overrides, enable/disable control, and project-specific markdown instructions.
4
4
  tags: [customize]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  # Artifact Customization Management
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-dep-audit
3
3
  description: Audit and update npm dependencies for security, freshness, and bundle impact. Use when auditing dependencies, responding to CVEs, or upgrading packages.
4
4
  tags: [maintenance, security]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  > **Note:** Commands below use `npm` as an example. Substitute with your project's package manager (`yarn`, `pnpm`, `bun`) or build tool when your project uses a different package manager.
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-feature
3
3
  description: End-to-end feature implementation workflow. Covers data model, domain logic, API, and UI as a vertical slice. Use when implementing new features or working on feature request issues.
4
4
  tags: [core, implementation]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  > **Note:** Commands below use `npm` as an example. Substitute with your project's package manager (`yarn`, `pnpm`, `bun`) or build tool when your project uses a different package manager.
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-gh-agentic-workflows
3
3
  description: Set up CI/CD agentic workflows for continuous AI-powered repository automation (GitHub Actions, Azure Pipelines, GitLab CI)
4
4
  tags: [devops, team]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  # CI/CD Agentic Workflows Integration
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-incident-response
3
3
  description: Handle production incidents with structured triage, mitigation, and post-mortem. Use when responding to production issues, outages, or security incidents.
4
4
  tags: [devops]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  # Incident Response Workflow
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-issue-workflow
3
3
  description: Guides the 8-step agentic development workflow for issues/work items. Covers parsing issues, loading skills, reading specs, planning, implementing, testing, opening PRs/MRs, and addressing review. Use when working on any issue/work item or when the user mentions an issue number.
4
4
  tags: [core, implementation]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  # Issue Workflow
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-logical-refactor
3
3
  description: Workflow for changing behavior or logic flow without adding new features or overhauling UI. Use when modifying business logic, data flows, behavioral rules, or working on logical refactor issues.
4
4
  tags: [implementation]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  > **Note:** Commands below use `npm` as an example. Substitute with your project's package manager (`yarn`, `pnpm`, `bun`) or build tool when your project uses a different package manager.
8
10
 
@@ -4,6 +4,8 @@ type: skill
4
4
  description: Plan and execute migrations for databases, frameworks, and dependencies. Covers breaking change analysis, phased rollout, and rollback procedures.
5
5
  tags: [implementation, brownfield]
6
6
  quality_charter: agents/shared/quality-charter.md
7
+ efficiency_patterns: agents/shared/efficiency-patterns.md
8
+ cache_friendly: true
7
9
  ---
8
10
 
9
11
  # Migration Workflow
@@ -3,6 +3,8 @@ id: hatch3r-perf-audit
3
3
  description: Profile and optimize application performance against defined budgets. Use when investigating performance issues, auditing performance budgets, or optimizing hot paths.
4
4
  tags: [review, performance]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  > **Note:** Commands below use `npm` as an example. Substitute with your project's package manager (`yarn`, `pnpm`, `bun`) or build tool when your project uses a different package manager.
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-pr-creation
3
3
  description: Create a pull request or merge request following project conventions including branch naming, PR/MR template, checklist, and rollout plan. Use when opening or preparing a PR/MR, or when the user asks to create a PR or MR.
4
4
  tags: [core, implementation]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  > **Note:** Commands below use `npm` as an example. Substitute with your project's package manager (`yarn`, `pnpm`, `bun`) or build tool when your project uses a different package manager.
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-qa-validation
3
3
  description: E2E validation workflow producing a structured pass/fail report with evidence. Use when running QA validation, acceptance testing, verifying releases, or working on QA E2E validation issues.
4
4
  tags: [core, review]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  # QA E2E Validation Workflow
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-recipe
3
3
  description: Create, test, and manage workflow recipes that compose hatch3r capabilities into guided sequences. Use when creating new recipes, customizing existing ones, or troubleshooting recipe execution.
4
4
  tags: [core]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  # Recipe Management
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-refactor
3
3
  description: Internal code quality improvement workflow without changing external behavior. Use when refactoring code structure, simplifying modules, or improving maintainability.
4
4
  tags: [core, implementation]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  > **Note:** Commands below use `npm` as an example. Substitute with your project's package manager (`yarn`, `pnpm`, `bun`) or build tool when your project uses a different package manager.
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-release
3
3
  description: Cut a release with version bump, changelog, tagging, and deploy verification. Use when preparing a release, cutting a version, or deploying to production.
4
4
  tags: [devops]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  > **Note:** Commands below use `npm` as an example. Substitute with your project's package manager (`yarn`, `pnpm`, `bun`) or build tool when your project uses a different package manager.
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-rule-customize
3
3
  description: Redirect to adjust glob patterns, always-on triggers, and precedence tiers under .hatch3r/rules/ -- use when narrowing or reprioritizing a canonical lint rule
4
4
  tags: [customize]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  # Rule Customization
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-skill-customize
3
3
  description: Redirect to rewrite dispatch text that the model uses for auto-selection under .hatch3r/skills/ -- use when a capability is chosen for the wrong task or vice versa
4
4
  tags: [customize]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  # Skill Customization
8
10
 
@@ -3,6 +3,8 @@ id: hatch3r-visual-refactor
3
3
  description: UI/UX change workflow matching design, accessibility, and responsiveness requirements. Use when making visual changes, updating components, working on UI issues, or implementing design mockups.
4
4
  tags: [implementation]
5
5
  quality_charter: agents/shared/quality-charter.md
6
+ efficiency_patterns: agents/shared/efficiency-patterns.md
7
+ cache_friendly: true
6
8
  ---
7
9
  > **Note:** Commands below use `npm` as an example. Substitute with your project's package manager (`yarn`, `pnpm`, `bun`) or build tool when your project uses a different package manager.
8
10