heraspec 0.1.12 → 0.1.14

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 (129) hide show
  1. package/LICENSE +22 -22
  2. package/README.md +188 -103
  3. package/bin/heraspec.js +4805 -1122
  4. package/bin/heraspec.js.map +4 -4
  5. package/dist/core/templates/skills/CHANGELOG.md +117 -117
  6. package/dist/core/templates/skills/README-template.md +58 -58
  7. package/dist/core/templates/skills/README.md +38 -38
  8. package/dist/core/templates/skills/content-optimization-skill.md +104 -104
  9. package/dist/core/templates/skills/data/design-systems.csv +54 -0
  10. package/dist/core/templates/skills/data/pages-proposed.csv +21 -21
  11. package/dist/core/templates/skills/data/pages.csv +9 -9
  12. package/dist/core/templates/skills/data/typography.csv +57 -57
  13. package/dist/core/templates/skills/deploy-documentation-skill.md +408 -0
  14. package/dist/core/templates/skills/design-system-skill.md +176 -0
  15. package/dist/core/templates/skills/documents/templates/documentation-landing-page.html +63 -63
  16. package/dist/core/templates/skills/documents/templates/documentation.html +49 -49
  17. package/dist/core/templates/skills/documents/templates/landing-script.js +38 -38
  18. package/dist/core/templates/skills/documents/templates/landing-style.css +158 -158
  19. package/dist/core/templates/skills/documents/templates/script.js +56 -56
  20. package/dist/core/templates/skills/documents/templates/style.css +155 -155
  21. package/dist/core/templates/skills/documents/templates/technical-doc-template.md +16 -16
  22. package/dist/core/templates/skills/documents/templates/user-guide-template.md +16 -16
  23. package/dist/core/templates/skills/documents-skill.md +104 -104
  24. package/dist/core/templates/skills/e2e-test-skill.md +119 -119
  25. package/dist/core/templates/skills/git-embed-skill.md +57 -0
  26. package/dist/core/templates/skills/integration-test-skill.md +118 -118
  27. package/dist/core/templates/skills/knowledge/README.md +63 -0
  28. package/dist/core/templates/skills/knowledge/design-systems/airbnb/DESIGN.md +246 -0
  29. package/dist/core/templates/skills/knowledge/design-systems/airtable/DESIGN.md +89 -0
  30. package/dist/core/templates/skills/knowledge/design-systems/apple/DESIGN.md +313 -0
  31. package/dist/core/templates/skills/knowledge/design-systems/bmw/DESIGN.md +180 -0
  32. package/dist/core/templates/skills/knowledge/design-systems/cal/DESIGN.md +259 -0
  33. package/dist/core/templates/skills/knowledge/design-systems/claude/DESIGN.md +312 -0
  34. package/dist/core/templates/skills/knowledge/design-systems/clay/DESIGN.md +304 -0
  35. package/dist/core/templates/skills/knowledge/design-systems/clickhouse/DESIGN.md +281 -0
  36. package/dist/core/templates/skills/knowledge/design-systems/cohere/DESIGN.md +266 -0
  37. package/dist/core/templates/skills/knowledge/design-systems/coinbase/DESIGN.md +129 -0
  38. package/dist/core/templates/skills/knowledge/design-systems/composio/DESIGN.md +307 -0
  39. package/dist/core/templates/skills/knowledge/design-systems/cursor/DESIGN.md +309 -0
  40. package/dist/core/templates/skills/knowledge/design-systems/elevenlabs/DESIGN.md +265 -0
  41. package/dist/core/templates/skills/knowledge/design-systems/expo/DESIGN.md +281 -0
  42. package/dist/core/templates/skills/knowledge/design-systems/figma/DESIGN.md +220 -0
  43. package/dist/core/templates/skills/knowledge/design-systems/framer/DESIGN.md +246 -0
  44. package/dist/core/templates/skills/knowledge/design-systems/hashicorp/DESIGN.md +278 -0
  45. package/dist/core/templates/skills/knowledge/design-systems/ibm/DESIGN.md +332 -0
  46. package/dist/core/templates/skills/knowledge/design-systems/index.json +72 -0
  47. package/dist/core/templates/skills/knowledge/design-systems/intercom/DESIGN.md +146 -0
  48. package/dist/core/templates/skills/knowledge/design-systems/kraken/DESIGN.md +125 -0
  49. package/dist/core/templates/skills/knowledge/design-systems/linear.app/DESIGN.md +367 -0
  50. package/dist/core/templates/skills/knowledge/design-systems/lovable/DESIGN.md +298 -0
  51. package/dist/core/templates/skills/knowledge/design-systems/minimax/DESIGN.md +257 -0
  52. package/dist/core/templates/skills/knowledge/design-systems/mintlify/DESIGN.md +326 -0
  53. package/dist/core/templates/skills/knowledge/design-systems/miro/DESIGN.md +108 -0
  54. package/dist/core/templates/skills/knowledge/design-systems/mistral.ai/DESIGN.md +261 -0
  55. package/dist/core/templates/skills/knowledge/design-systems/mongodb/DESIGN.md +266 -0
  56. package/dist/core/templates/skills/knowledge/design-systems/notion/DESIGN.md +309 -0
  57. package/dist/core/templates/skills/knowledge/design-systems/nvidia/DESIGN.md +293 -0
  58. package/dist/core/templates/skills/knowledge/design-systems/ollama/DESIGN.md +267 -0
  59. package/dist/core/templates/skills/knowledge/design-systems/opencode.ai/DESIGN.md +281 -0
  60. package/dist/core/templates/skills/knowledge/design-systems/pinterest/DESIGN.md +230 -0
  61. package/dist/core/templates/skills/knowledge/design-systems/posthog/DESIGN.md +256 -0
  62. package/dist/core/templates/skills/knowledge/design-systems/raycast/DESIGN.md +268 -0
  63. package/dist/core/templates/skills/knowledge/design-systems/replicate/DESIGN.md +261 -0
  64. package/dist/core/templates/skills/knowledge/design-systems/resend/DESIGN.md +303 -0
  65. package/dist/core/templates/skills/knowledge/design-systems/revolut/DESIGN.md +185 -0
  66. package/dist/core/templates/skills/knowledge/design-systems/runwayml/DESIGN.md +244 -0
  67. package/dist/core/templates/skills/knowledge/design-systems/sanity/DESIGN.md +357 -0
  68. package/dist/core/templates/skills/knowledge/design-systems/sentry/DESIGN.md +262 -0
  69. package/dist/core/templates/skills/knowledge/design-systems/spacex/DESIGN.md +194 -0
  70. package/dist/core/templates/skills/knowledge/design-systems/spotify/DESIGN.md +246 -0
  71. package/dist/core/templates/skills/knowledge/design-systems/stripe/DESIGN.md +322 -0
  72. package/dist/core/templates/skills/knowledge/design-systems/supabase/DESIGN.md +255 -0
  73. package/dist/core/templates/skills/knowledge/design-systems/superhuman/DESIGN.md +252 -0
  74. package/dist/core/templates/skills/knowledge/design-systems/together.ai/DESIGN.md +263 -0
  75. package/dist/core/templates/skills/knowledge/design-systems/uber/DESIGN.md +295 -0
  76. package/dist/core/templates/skills/knowledge/design-systems/vercel/DESIGN.md +310 -0
  77. package/dist/core/templates/skills/knowledge/design-systems/voltagent/DESIGN.md +323 -0
  78. package/dist/core/templates/skills/knowledge/design-systems/warp/DESIGN.md +253 -0
  79. package/dist/core/templates/skills/knowledge/design-systems/webflow/DESIGN.md +92 -0
  80. package/dist/core/templates/skills/knowledge/design-systems/wise/DESIGN.md +173 -0
  81. package/dist/core/templates/skills/knowledge/design-systems/x.ai/DESIGN.md +257 -0
  82. package/dist/core/templates/skills/knowledge/design-systems/zapier/DESIGN.md +328 -0
  83. package/dist/core/templates/skills/knowledge/frameworks/php/codeigniter/rise-cms/profile.json +27 -0
  84. package/dist/core/templates/skills/knowledge/frameworks/php/codeigniter/rise-cms/structure.md +137 -0
  85. package/dist/core/templates/skills/knowledge/frameworks/php/laravel/botble/profile.json +39 -0
  86. package/dist/core/templates/skills/knowledge/frameworks/php/laravel/botble/structure.md +208 -0
  87. package/dist/core/templates/skills/knowledge/frameworks/php/wordpress/core/profile.json +51 -0
  88. package/dist/core/templates/skills/knowledge/frameworks/php/wordpress/core/structure.md +369 -0
  89. package/dist/core/templates/skills/knowledge/index.json +65 -0
  90. package/dist/core/templates/skills/module-codebase-skill.md +110 -110
  91. package/dist/core/templates/skills/plugin-directory-skill.md +396 -396
  92. package/dist/core/templates/skills/project-memory-skill.md +222 -0
  93. package/dist/core/templates/skills/project-memory-skill.vi.md +223 -0
  94. package/dist/core/templates/skills/scripts/CODE_EXPLANATION.md +394 -394
  95. package/dist/core/templates/skills/scripts/SEARCH_ALGORITHMS_COMPARISON.md +421 -421
  96. package/dist/core/templates/skills/scripts/SEARCH_MODES_GUIDE.md +238 -238
  97. package/dist/core/templates/skills/scripts/__pycache__/core.cpython-311.pyc +0 -0
  98. package/dist/core/templates/skills/scripts/core.py +391 -385
  99. package/dist/core/templates/skills/scripts/search.py +1 -1
  100. package/dist/core/templates/skills/smart-explore-skill.md +141 -0
  101. package/dist/core/templates/skills/sourcecode-analyzer-skill.md +210 -0
  102. package/dist/core/templates/skills/sourcecode-analyzer-skill.vi.md +210 -0
  103. package/dist/core/templates/skills/suggestion-skill.md +118 -118
  104. package/dist/core/templates/skills/templates/accessibility-checklist.md +40 -40
  105. package/dist/core/templates/skills/templates/example-prompt-full-theme.md +333 -333
  106. package/dist/core/templates/skills/templates/page-types-guide.md +338 -338
  107. package/dist/core/templates/skills/templates/pages-proposed-summary.md +273 -273
  108. package/dist/core/templates/skills/templates/pre-delivery-checklist.md +42 -42
  109. package/dist/core/templates/skills/templates/prompt-template-full-theme.md +313 -313
  110. package/dist/core/templates/skills/templates/responsive-design.md +40 -40
  111. package/dist/core/templates/skills/ui-ux-skill.md +595 -584
  112. package/dist/core/templates/skills/unit-test-skill.md +111 -111
  113. package/dist/core/templates/skills/ux-element/templates/Controller.php +50 -50
  114. package/dist/core/templates/skills/ux-element/templates/Shortcode.php +23 -23
  115. package/dist/core/templates/skills/ux-element/templates/Template.html +20 -20
  116. package/dist/core/templates/skills/ux-element/templates/Thumbnail.svg +8 -8
  117. package/dist/core/templates/skills/ux-element/templates/View.php +21 -21
  118. package/dist/core/templates/skills/ux-element-skill.md +83 -83
  119. package/dist/core/templates/skills/wordpress-plugin-check-skill.md +151 -76
  120. package/dist/core/templates/skills/wordpress-plugin-standard/templates/admin-dashboard.php +47 -47
  121. package/dist/core/templates/skills/wordpress-plugin-standard/templates/admin-settings.php +60 -60
  122. package/dist/core/templates/skills/wordpress-plugin-standard/templates/assets/admin-css.css +22 -22
  123. package/dist/core/templates/skills/wordpress-plugin-standard/templates/assets/admin-js.js +15 -15
  124. package/dist/core/templates/skills/wordpress-plugin-standard/templates/plugin-main.php +169 -169
  125. package/dist/core/templates/skills/wordpress-plugin-standard/templates/readme.txt +41 -41
  126. package/dist/core/templates/skills/wordpress-plugin-standard/templates/uninstall.php +21 -21
  127. package/dist/core/templates/skills/wordpress-plugin-standard-skill.md +100 -100
  128. package/dist/index.js +4068 -278
  129. package/package.json +75 -72
@@ -1,118 +1,118 @@
1
- # Skill: Feature Suggestion (Cross-Cutting)
2
-
3
- ## Purpose
4
-
5
- This skill is used to analyze existing project structure and suggest new features that would integrate well with the current codebase. It helps identify opportunities for enhancements and new functionality based on existing patterns and architecture.
6
-
7
- ## When to Use
8
-
9
- - When planning new features for a project
10
- - When identifying gaps in functionality
11
- - When analyzing project structure for enhancement opportunities
12
- - When proposing improvements based on existing patterns
13
- - When suggesting features that align with project architecture
14
-
15
- ## Step-by-Step Process
16
-
17
- ### Step 1: Analyze Project Structure
18
- - Read and understand `heraspec/project.md`
19
- - Review existing specs in `heraspec/specs/`
20
- - Analyze existing changes and their patterns
21
- - Identify project type and tech stack
22
- - Map current feature set
23
-
24
- ### Step 2: Identify Integration Points
25
- - Find logical places for new features
26
- - Identify patterns in existing code
27
- - Determine appropriate project structure locations
28
- - Consider dependencies and relationships
29
- - Map feature hierarchy
30
-
31
- ### Step 3: Generate Suggestions
32
- - Create feature suggestions based on analysis
33
- - Ensure suggestions align with project type
34
- - Consider existing patterns and conventions
35
- - Propose features that enhance current functionality
36
- - Suggest improvements and extensions
37
-
38
- ### Step 4: Organize Suggestions
39
- - Group suggestions by category/domain
40
- - Prioritize based on feasibility and value
41
- - Create suggestion files in appropriate locations
42
- - Link suggestions to existing features
43
- - Document integration points
44
-
45
- ### Step 5: Review and Refine
46
- - Review suggestions for consistency
47
- - Ensure suggestions follow project conventions
48
- - Verify integration points are correct
49
- - Refine based on project requirements
50
- - Prepare for implementation planning
51
-
52
- ## Required Input
53
-
54
- - **Project structure**: Understanding of project organization
55
- - **Existing specs**: Current feature specifications
56
- - **Project type**: Type of project (plugin, module, app, etc.)
57
- - **Tech stack**: Technologies used in the project
58
- - **Domain context**: Business domain and requirements
59
-
60
- ## Expected Output
61
-
62
- - Feature suggestion files
63
- - Suggestions organized by category
64
- - Integration points identified
65
- - Suggestions linked to existing features
66
- - Documentation of suggested enhancements
67
-
68
- ## Tone & Rules
69
-
70
- ### Suggestion Quality
71
- - Suggest features that add value
72
- - Align with project type and architecture
73
- - Consider existing patterns and conventions
74
- - Propose realistic and feasible features
75
- - Enhance rather than replace existing functionality
76
-
77
- ### Integration
78
- - Identify appropriate locations for features
79
- - Consider dependencies and relationships
80
- - Follow existing project structure
81
- - Maintain consistency with current patterns
82
- - Document integration approach
83
-
84
- ### Documentation
85
- - Clearly describe suggested features
86
- - Explain integration points
87
- - Link to related existing features
88
- - Provide context and rationale
89
- - Include implementation considerations
90
-
91
- ### Limitations
92
- - ❌ DO NOT suggest features that conflict with existing architecture
93
- - ❌ DO NOT ignore project conventions
94
- - ❌ DO NOT suggest overly complex features
95
- - ❌ DO NOT duplicate existing functionality
96
- - ❌ DO NOT suggest features without considering integration
97
-
98
- ## Available Templates
99
-
100
- - `templates/suggestion-template.md` - Template for feature suggestions
101
- - `templates/suggestion-category-template.md` - Template for organizing suggestions by category
102
-
103
- ## Available Scripts
104
-
105
- - `scripts/analyze-project-structure.py` - Analyze project structure for suggestion opportunities
106
-
107
- ## Examples
108
-
109
- See `examples/` directory for reference:
110
- - `good-suggestions/` - Well-structured feature suggestions
111
- - `bad-suggestions/` - Examples to avoid
112
-
113
- ## Links to Other Skills
114
-
115
- - **documents**: Use to document suggestion rationale
116
- - **unit-test**: Consider testability when suggesting features
117
- - **integration-test**: Consider integration testing when suggesting features
118
-
1
+ # Skill: Feature Suggestion (Cross-Cutting)
2
+
3
+ ## Purpose
4
+
5
+ This skill is used to analyze existing project structure and suggest new features that would integrate well with the current codebase. It helps identify opportunities for enhancements and new functionality based on existing patterns and architecture.
6
+
7
+ ## When to Use
8
+
9
+ - When planning new features for a project
10
+ - When identifying gaps in functionality
11
+ - When analyzing project structure for enhancement opportunities
12
+ - When proposing improvements based on existing patterns
13
+ - When suggesting features that align with project architecture
14
+
15
+ ## Step-by-Step Process
16
+
17
+ ### Step 1: Analyze Project Structure
18
+ - Read and understand `heraspec/project.md`
19
+ - Review existing specs in `heraspec/specs/`
20
+ - Analyze existing changes and their patterns
21
+ - Identify project type and tech stack
22
+ - Map current feature set
23
+
24
+ ### Step 2: Identify Integration Points
25
+ - Find logical places for new features
26
+ - Identify patterns in existing code
27
+ - Determine appropriate project structure locations
28
+ - Consider dependencies and relationships
29
+ - Map feature hierarchy
30
+
31
+ ### Step 3: Generate Suggestions
32
+ - Create feature suggestions based on analysis
33
+ - Ensure suggestions align with project type
34
+ - Consider existing patterns and conventions
35
+ - Propose features that enhance current functionality
36
+ - Suggest improvements and extensions
37
+
38
+ ### Step 4: Organize Suggestions
39
+ - Group suggestions by category/domain
40
+ - Prioritize based on feasibility and value
41
+ - Create suggestion files in appropriate locations
42
+ - Link suggestions to existing features
43
+ - Document integration points
44
+
45
+ ### Step 5: Review and Refine
46
+ - Review suggestions for consistency
47
+ - Ensure suggestions follow project conventions
48
+ - Verify integration points are correct
49
+ - Refine based on project requirements
50
+ - Prepare for implementation planning
51
+
52
+ ## Required Input
53
+
54
+ - **Project structure**: Understanding of project organization
55
+ - **Existing specs**: Current feature specifications
56
+ - **Project type**: Type of project (plugin, module, app, etc.)
57
+ - **Tech stack**: Technologies used in the project
58
+ - **Domain context**: Business domain and requirements
59
+
60
+ ## Expected Output
61
+
62
+ - Feature suggestion files
63
+ - Suggestions organized by category
64
+ - Integration points identified
65
+ - Suggestions linked to existing features
66
+ - Documentation of suggested enhancements
67
+
68
+ ## Tone & Rules
69
+
70
+ ### Suggestion Quality
71
+ - Suggest features that add value
72
+ - Align with project type and architecture
73
+ - Consider existing patterns and conventions
74
+ - Propose realistic and feasible features
75
+ - Enhance rather than replace existing functionality
76
+
77
+ ### Integration
78
+ - Identify appropriate locations for features
79
+ - Consider dependencies and relationships
80
+ - Follow existing project structure
81
+ - Maintain consistency with current patterns
82
+ - Document integration approach
83
+
84
+ ### Documentation
85
+ - Clearly describe suggested features
86
+ - Explain integration points
87
+ - Link to related existing features
88
+ - Provide context and rationale
89
+ - Include implementation considerations
90
+
91
+ ### Limitations
92
+ - ❌ DO NOT suggest features that conflict with existing architecture
93
+ - ❌ DO NOT ignore project conventions
94
+ - ❌ DO NOT suggest overly complex features
95
+ - ❌ DO NOT duplicate existing functionality
96
+ - ❌ DO NOT suggest features without considering integration
97
+
98
+ ## Available Templates
99
+
100
+ - `templates/suggestion-template.md` - Template for feature suggestions
101
+ - `templates/suggestion-category-template.md` - Template for organizing suggestions by category
102
+
103
+ ## Available Scripts
104
+
105
+ - `scripts/analyze-project-structure.py` - Analyze project structure for suggestion opportunities
106
+
107
+ ## Examples
108
+
109
+ See `examples/` directory for reference:
110
+ - `good-suggestions/` - Well-structured feature suggestions
111
+ - `bad-suggestions/` - Examples to avoid
112
+
113
+ ## Links to Other Skills
114
+
115
+ - **documents**: Use to document suggestion rationale
116
+ - **unit-test**: Consider testability when suggesting features
117
+ - **integration-test**: Consider integration testing when suggesting features
118
+
@@ -1,40 +1,40 @@
1
- # Accessibility Checklist (WCAG 2.1 AA)
2
-
3
- ## Perceivable
4
-
5
- - [ ] All images have descriptive alt text
6
- - [ ] Color is not the only means of conveying information
7
- - [ ] Text contrast ratio meets 4.5:1 for normal text, 3:1 for large text
8
- - [ ] Content can be resized up to 200% without loss of functionality
9
-
10
- ## Operable
11
-
12
- - [ ] All functionality available via keyboard
13
- - [ ] No keyboard traps
14
- - [ ] Focus indicators visible
15
- - [ ] Sufficient time limits (if any) can be extended
16
- - [ ] No content that causes seizures (flashing)
17
- - [ ] Touch targets at least 44x44px
18
-
19
- ## Understandable
20
-
21
- - [ ] Page titles are descriptive
22
- - [ ] Form inputs have labels
23
- - [ ] Error messages are clear and helpful
24
- - [ ] Language of page is declared
25
- - [ ] Navigation is consistent
26
-
27
- ## Robust
28
-
29
- - [ ] Valid HTML markup
30
- - [ ] ARIA attributes used correctly (if needed)
31
- - [ ] Screen reader compatible
32
- - [ ] Works with assistive technologies
33
-
34
- ## Additional Best Practices
35
-
36
- - [ ] `prefers-reduced-motion` respected
37
- - [ ] Skip links for keyboard navigation
38
- - [ ] Logical tab order
39
- - [ ] Focus management for modals/dialogs
40
-
1
+ # Accessibility Checklist (WCAG 2.1 AA)
2
+
3
+ ## Perceivable
4
+
5
+ - [ ] All images have descriptive alt text
6
+ - [ ] Color is not the only means of conveying information
7
+ - [ ] Text contrast ratio meets 4.5:1 for normal text, 3:1 for large text
8
+ - [ ] Content can be resized up to 200% without loss of functionality
9
+
10
+ ## Operable
11
+
12
+ - [ ] All functionality available via keyboard
13
+ - [ ] No keyboard traps
14
+ - [ ] Focus indicators visible
15
+ - [ ] Sufficient time limits (if any) can be extended
16
+ - [ ] No content that causes seizures (flashing)
17
+ - [ ] Touch targets at least 44x44px
18
+
19
+ ## Understandable
20
+
21
+ - [ ] Page titles are descriptive
22
+ - [ ] Form inputs have labels
23
+ - [ ] Error messages are clear and helpful
24
+ - [ ] Language of page is declared
25
+ - [ ] Navigation is consistent
26
+
27
+ ## Robust
28
+
29
+ - [ ] Valid HTML markup
30
+ - [ ] ARIA attributes used correctly (if needed)
31
+ - [ ] Screen reader compatible
32
+ - [ ] Works with assistive technologies
33
+
34
+ ## Additional Best Practices
35
+
36
+ - [ ] `prefers-reduced-motion` respected
37
+ - [ ] Skip links for keyboard navigation
38
+ - [ ] Logical tab order
39
+ - [ ] Focus management for modals/dialogs
40
+