hatch3r 1.3.0 → 1.4.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 (62) hide show
  1. package/README.md +2 -1
  2. package/agents/hatch3r-a11y-auditor.md +7 -11
  3. package/agents/hatch3r-architect.md +7 -11
  4. package/agents/hatch3r-ci-watcher.md +7 -10
  5. package/agents/hatch3r-context-rules.md +5 -7
  6. package/agents/hatch3r-dependency-auditor.md +7 -13
  7. package/agents/hatch3r-devops.md +7 -13
  8. package/agents/hatch3r-docs-writer.md +7 -11
  9. package/agents/hatch3r-fixer.md +2 -8
  10. package/agents/hatch3r-implementer.md +2 -8
  11. package/agents/hatch3r-learnings-loader.md +5 -7
  12. package/agents/hatch3r-lint-fixer.md +7 -9
  13. package/agents/hatch3r-perf-profiler.md +7 -11
  14. package/agents/hatch3r-researcher.md +6 -8
  15. package/agents/hatch3r-reviewer.md +7 -10
  16. package/agents/hatch3r-security-auditor.md +7 -12
  17. package/agents/hatch3r-test-writer.md +7 -11
  18. package/agents/shared/external-knowledge.md +21 -0
  19. package/agents/shared/quality-charter.md +78 -0
  20. package/commands/board/pickup-azure-devops.md +4 -0
  21. package/commands/board/pickup-delegation-multi.md +3 -0
  22. package/commands/board/pickup-delegation.md +3 -0
  23. package/commands/board/pickup-github.md +4 -0
  24. package/commands/board/pickup-gitlab.md +4 -0
  25. package/commands/board/pickup-post-impl.md +8 -1
  26. package/commands/board/shared-azure-devops.md +13 -3
  27. package/commands/board/shared-github.md +1 -0
  28. package/commands/board/shared-gitlab.md +9 -2
  29. package/commands/hatch3r-agent-customize.md +5 -1
  30. package/commands/hatch3r-board-groom.md +55 -2
  31. package/commands/hatch3r-board-init.md +5 -2
  32. package/commands/hatch3r-board-shared.md +37 -2
  33. package/commands/hatch3r-command-customize.md +4 -0
  34. package/commands/hatch3r-hooks.md +1 -1
  35. package/commands/hatch3r-quick-change.md +29 -3
  36. package/commands/hatch3r-revision.md +136 -16
  37. package/commands/hatch3r-rule-customize.md +4 -0
  38. package/commands/hatch3r-skill-customize.md +4 -0
  39. package/commands/hatch3r-workflow.md +10 -1
  40. package/dist/cli/index.js +522 -360
  41. package/dist/cli/index.js.map +1 -1
  42. package/package.json +12 -9
  43. package/rules/hatch3r-agent-orchestration-detail.md +159 -0
  44. package/rules/hatch3r-agent-orchestration-detail.mdc +156 -0
  45. package/rules/hatch3r-agent-orchestration.md +91 -330
  46. package/rules/hatch3r-agent-orchestration.mdc +127 -149
  47. package/rules/hatch3r-code-standards.mdc +10 -2
  48. package/rules/hatch3r-component-conventions.mdc +0 -1
  49. package/rules/hatch3r-deep-context.mdc +30 -8
  50. package/rules/hatch3r-dependency-management.mdc +17 -5
  51. package/rules/hatch3r-i18n.mdc +0 -1
  52. package/rules/hatch3r-migrations.mdc +12 -1
  53. package/rules/hatch3r-observability.mdc +289 -0
  54. package/rules/hatch3r-security-patterns.mdc +11 -0
  55. package/rules/hatch3r-testing.mdc +1 -1
  56. package/rules/hatch3r-theming.mdc +0 -1
  57. package/rules/hatch3r-tooling-hierarchy.mdc +18 -4
  58. package/skills/hatch3r-agent-customize/SKILL.md +4 -72
  59. package/skills/hatch3r-command-customize/SKILL.md +4 -62
  60. package/skills/hatch3r-customize/SKILL.md +117 -0
  61. package/skills/hatch3r-rule-customize/SKILL.md +4 -65
  62. package/skills/hatch3r-skill-customize/SKILL.md +4 -62
@@ -1,71 +1,10 @@
1
1
  ---
2
2
  id: hatch3r-rule-customize
3
- description: Create and manage per-rule customization files for scope overrides, description changes, enable/disable control, and project-specific markdown instructions. Use when tailoring rules to project-specific needs.
3
+ description: Rule customization redirects to the unified hatch3r-customize skill.
4
4
  tags: [customize]
5
5
  ---
6
- # Rule Customization Management
6
+ # Rule Customization
7
7
 
8
- ## Quick Start
8
+ > **This skill has been consolidated.** Use the `hatch3r-customize` skill with `type: rule`.
9
9
 
10
- ```
11
- Task Progress:
12
- - [ ] Step 1: Identify which rule to customize
13
- - [ ] Step 2: Determine customization needs
14
- - [ ] Step 3: Create the customization files
15
- - [ ] Step 4: Sync to propagate changes
16
- - [ ] Step 5: Verify the customized output
17
- ```
18
-
19
- ## Step 1: Identify Rule
20
-
21
- Determine which hatch3r rule needs customization:
22
- - Review the rules in `.agents/rules/` and their default scope/content
23
- - Identify gaps between default rules and project needs
24
- - Check for existing customization files in `.hatch3r/rules/`
25
-
26
- ## Step 2: Determine Customization Needs
27
-
28
- Decide which customization approach to use:
29
-
30
- **YAML (`.customize.yaml`)** — for structured overrides:
31
- - **Scope**: Override when the rule applies (`always`, glob patterns like `src/**/*.ts`)
32
- - **Description**: Change how the rule is described in adapter outputs
33
- - **Enabled**: Set to `false` to disable the rule entirely
34
-
35
- **Markdown (`.customize.md`)** — for free-form instructions:
36
- - Project-specific rule additions or constraints
37
- - Domain-specific standards and requirements
38
- - Framework-specific conventions
39
-
40
- ## Step 3: Create Customization Files
41
-
42
- Create files in `.hatch3r/rules/`:
43
-
44
- **For YAML overrides:**
45
- ```yaml
46
- # .hatch3r/rules/{rule-id}.customize.yaml
47
- scope: "src/**/*.ts,src/**/*.tsx"
48
- description: "Testing rules with healthcare compliance requirements"
49
- ```
50
-
51
- **For markdown instructions:**
52
- Create `.hatch3r/rules/{rule-id}.customize.md` with project-specific additions. This content is injected into the managed block under `## Project Customizations`.
53
-
54
- ## Step 4: Sync
55
-
56
- Run `npx hatch3r sync` to propagate customizations to all adapter outputs.
57
-
58
- ## Step 5: Verify
59
-
60
- Confirm customizations appear in adapter output files:
61
- - Check scope is applied correctly in adapter-specific frontmatter (globs, alwaysApply, etc.)
62
- - Check description in adapter outputs
63
- - Check markdown instructions appear inside the managed block
64
- - Verify disabled rules are absent from adapter outputs
65
-
66
- ## Definition of Done
67
-
68
- - [ ] Customization files created in `.hatch3r/rules/`
69
- - [ ] `npx hatch3r sync` completes without errors
70
- - [ ] Adapter output files reflect the customizations (scope, description, content)
71
- - [ ] Customization files committed to the repository
10
+ For rule-specific reference (scope overrides, YAML schema), see the `hatch3r-rule-customize` command.
@@ -1,68 +1,10 @@
1
1
  ---
2
2
  id: hatch3r-skill-customize
3
- description: Create and manage per-skill customization files for description overrides, enable/disable control, and project-specific markdown instructions. Use when tailoring skill workflows to project-specific needs.
3
+ description: Skill customization redirects to the unified hatch3r-customize skill.
4
4
  tags: [customize]
5
5
  ---
6
- # Skill Customization Management
6
+ # Skill Customization
7
7
 
8
- ## Quick Start
8
+ > **This skill has been consolidated.** Use the `hatch3r-customize` skill with `type: skill`.
9
9
 
10
- ```
11
- Task Progress:
12
- - [ ] Step 1: Identify which skill to customize
13
- - [ ] Step 2: Determine customization needs
14
- - [ ] Step 3: Create the customization files
15
- - [ ] Step 4: Sync to propagate changes
16
- - [ ] Step 5: Verify the customized output
17
- ```
18
-
19
- ## Step 1: Identify Skill
20
-
21
- Determine which hatch3r skill needs customization:
22
- - Review the skills in `.agents/skills/` and their default workflows
23
- - Identify gaps between default workflows and project needs
24
- - Check for existing customization files in `.hatch3r/skills/`
25
-
26
- ## Step 2: Determine Customization Needs
27
-
28
- Decide which customization approach to use:
29
-
30
- **YAML (`.customize.yaml`)** — for structured overrides:
31
- - **Description**: Change how the skill is described in adapter frontmatter
32
- - **Enabled**: Set to `false` to disable the skill entirely
33
-
34
- **Markdown (`.customize.md`)** — for free-form instructions:
35
- - Project-specific workflow additions
36
- - Additional prerequisites or validation steps
37
- - Custom tooling or process requirements
38
-
39
- ## Step 3: Create Customization Files
40
-
41
- Create files in `.hatch3r/skills/`:
42
-
43
- **For YAML overrides:**
44
- ```yaml
45
- # .hatch3r/skills/{skill-id}.customize.yaml
46
- description: "Issue workflow with mandatory security review"
47
- ```
48
-
49
- **For markdown instructions:**
50
- Create `.hatch3r/skills/{skill-id}.customize.md` with project-specific additions. This content is injected into the managed block under `## Project Customizations`.
51
-
52
- ## Step 4: Sync
53
-
54
- Run `npx hatch3r sync` to propagate customizations to all adapter outputs.
55
-
56
- ## Step 5: Verify
57
-
58
- Confirm customizations appear in adapter output files:
59
- - Check description in frontmatter (where applicable)
60
- - Check markdown instructions appear inside the managed block
61
- - Verify disabled skills are absent from adapter outputs
62
-
63
- ## Definition of Done
64
-
65
- - [ ] Customization files created in `.hatch3r/skills/`
66
- - [ ] `npx hatch3r sync` completes without errors
67
- - [ ] Adapter output files reflect the customizations
68
- - [ ] Customization files committed to the repository
10
+ For skill-specific reference (YAML schema, examples), see the `hatch3r-skill-customize` command.