heraspec 0.1.16 → 0.1.17
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.
- package/README.md +67 -63
- package/bin/heraspec.js +587 -31
- package/bin/heraspec.js.map +2 -2
- package/dist/commands/create.d.ts +1 -0
- package/dist/core/config.d.ts +1 -1
- package/dist/core/init.d.ts +4 -0
- package/dist/core/schemas/base.schema.d.ts +3 -0
- package/dist/core/schemas/spec.schema.d.ts +2 -0
- package/dist/core/templates/skills/content-channel/content-compliance/skill.md +83 -0
- package/dist/core/templates/skills/content-channel/content-prompts/skill.md +74 -0
- package/dist/core/templates/skills/content-channel/content-scaffolding/skill.md +82 -0
- package/dist/core/templates/skills/content-channel/content-scripting/skill.md +147 -0
- package/dist/core/templates/skills/content-channel/content-strategy/skill.md +78 -0
- package/dist/core/templates/skills/content-channel/content-vault-sync/skill.md +74 -0
- package/dist/core/templates/skills/content-channel/content-voice-adapter/skill.md +143 -0
- package/dist/core/templates/skills/content-channel/skill.md +127 -0
- package/dist/index.js +229 -16
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -49,6 +49,8 @@ HeraSpec is a specification-based development framework that helps you:
|
|
|
49
49
|
Here are some products built partially or entirely using the HeraSpec framework:
|
|
50
50
|
|
|
51
51
|
<ul>
|
|
52
|
+
<li><a href="https://codecanyon.net/item/mtmedia-1-click-automated-web-recording-and-product-screenshot-suite-for-windows-and-macos/64976949" target="_blank">MTMedia | 1 Click Automated Web Recording and Product Screenshot Suite for Windows and macOS</a></li>
|
|
53
|
+
<li><a href="https://headrandom.com/mtxstudio" target="_blank">MTxStudio - AI Video Voiceover & Multi-Track Studio</a></li>
|
|
52
54
|
<li><a href="https://codecanyon.net/item/flexinote-for-perfex-crm/60590690" target="_blank">FlexNote for Perfex CRM</a> - Advanced note management with AI capabilities.</li>
|
|
53
55
|
<li><a href="https://codecanyon.net/item/polyutilities-for-perfex-crm-quick-access-menu-custom-js-css-and-more/49522529" target="_blank">PolyUtilities for Perfex CRM</a> - Essential toolkit for Perfex CRM customization.</li>
|
|
54
56
|
<li><a href="https://codecanyon.net/item/data-builder-for-perfex-crm/62297963" target="_blank">Data Builder — Visual Reporting, REST API & GraphQL for Perfex CRM</a> - Automated demo instance creator.</li>
|
|
@@ -80,71 +82,72 @@ Here are some products built partially or entirely using the HeraSpec framework:
|
|
|
80
82
|
<li><a href="https://wordpress.org/plugins/white-label-builder/" target="_blank">White Label Builder</a></li>
|
|
81
83
|
<li><a href="https://wordpress.org/plugins/poly-support/" target="_blank">Poly Support</a></li>
|
|
82
84
|
<li><a href="https://wordpress.org/plugins/team-manager-unified/" target="_blank">Team Manager Unified</a></li>
|
|
83
|
-
</ul>
|
|
84
|
-
|
|
85
|
-
<!-- HeraSpec Section -->
|
|
86
|
-
## HeraSpec Development
|
|
87
|
-
|
|
88
|
-
This project uses [HeraSpec](https://github.com/PolyXGO/HeraSpec) for spec-driven development.
|
|
89
|
-
|
|
90
|
-
### Quick Start
|
|
91
|
-
|
|
92
|
-
```bash
|
|
93
|
-
# Initialize HeraSpec (if not already done)
|
|
94
|
-
heraspec init
|
|
95
|
-
|
|
96
|
-
# List active changes
|
|
97
|
-
heraspec list
|
|
98
|
-
|
|
99
|
-
# View a change
|
|
100
|
-
heraspec show <change-name>
|
|
101
|
-
|
|
102
|
-
# Validate changes
|
|
103
|
-
heraspec validate <change-name>
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
### Project Structure
|
|
107
|
-
|
|
108
|
-
- `heraspec/project.md` - Project overview and configuration
|
|
109
|
-
- `heraspec/specs/` - Source of truth specifications
|
|
110
|
-
- `heraspec/changes/` - Active changes in progress
|
|
111
|
-
- `heraspec/skills/` - Reusable skills for AI agents
|
|
112
|
-
- `AGENTS.heraspec.md` - AI agent instructions
|
|
113
|
-
|
|
114
|
-
### Working with Changes
|
|
115
|
-
|
|
116
|
-
1. **Create a change**: Ask AI to create a HeraSpec change, or create manually
|
|
117
|
-
2. **Refine specs**: Review and update delta specs in `heraspec/specs/<change-name>/`
|
|
118
|
-
3. **Implement**: Follow tasks in `heraspec/changes/<change-name>/tasks.md`
|
|
119
|
-
4. **Archive**: Run `heraspec archive <change-name> --yes` when complete
|
|
120
|
-
|
|
121
|
-
### Skills
|
|
122
|
-
|
|
123
|
-
Add skills to your project:
|
|
124
|
-
|
|
125
|
-
```bash
|
|
126
|
-
# List available skills
|
|
127
|
-
heraspec skill list
|
|
128
|
-
|
|
129
|
-
# Add a skill
|
|
130
|
-
heraspec skill add ui-ux
|
|
131
|
-
heraspec skill add unit-test
|
|
132
|
-
|
|
133
|
-
# View skill details
|
|
134
|
-
heraspec skill show ui-ux
|
|
135
|
-
```
|
|
136
|
-
|
|
137
|
-
For more information, see the [HeraSpec documentation](https://github.com/
|
|
138
|
-
|
|
139
|
-
---
|
|
140
|
-
|
|
141
|
-
*This section is automatically updated by `heraspec init`. Last updated: 2026-
|
|
142
|
-
|
|
85
|
+
</ul>
|
|
86
|
+
|
|
87
|
+
<!-- HeraSpec Section -->
|
|
88
|
+
## HeraSpec Development
|
|
89
|
+
|
|
90
|
+
This project uses [HeraSpec](https://github.com/PolyXGO/HeraSpec) for spec-driven development.
|
|
91
|
+
|
|
92
|
+
### Quick Start
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
# Initialize HeraSpec (if not already done)
|
|
96
|
+
heraspec init
|
|
97
|
+
|
|
98
|
+
# List active changes
|
|
99
|
+
heraspec list
|
|
100
|
+
|
|
101
|
+
# View a change
|
|
102
|
+
heraspec show <change-name>
|
|
103
|
+
|
|
104
|
+
# Validate changes
|
|
105
|
+
heraspec validate <change-name>
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
### Project Structure
|
|
109
|
+
|
|
110
|
+
- `heraspec/project.md` - Project overview and configuration
|
|
111
|
+
- `heraspec/specs/` - Source of truth specifications
|
|
112
|
+
- `heraspec/changes/` - Active changes in progress
|
|
113
|
+
- `heraspec/skills/` - Reusable skills for AI agents
|
|
114
|
+
- `AGENTS.heraspec.md` - AI agent instructions
|
|
115
|
+
|
|
116
|
+
### Working with Changes
|
|
117
|
+
|
|
118
|
+
1. **Create a change**: Ask AI to create a HeraSpec change, or create manually
|
|
119
|
+
2. **Refine specs**: Review and update delta specs in `heraspec/specs/<change-name>/`
|
|
120
|
+
3. **Implement**: Follow tasks in `heraspec/changes/<change-name>/tasks.md`
|
|
121
|
+
4. **Archive**: Run `heraspec archive <change-name> --yes` when complete
|
|
122
|
+
|
|
123
|
+
### Skills
|
|
124
|
+
|
|
125
|
+
Add skills to your project:
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
# List available skills
|
|
129
|
+
heraspec skill list
|
|
130
|
+
|
|
131
|
+
# Add a skill
|
|
132
|
+
heraspec skill add ui-ux
|
|
133
|
+
heraspec skill add unit-test
|
|
134
|
+
|
|
135
|
+
# View skill details
|
|
136
|
+
heraspec skill show ui-ux
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
For more information, see the [HeraSpec documentation](https://github.com/PolyXGO/HeraSpec#readme).
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
*This section is automatically updated by `heraspec init`. Last updated: 2026-10-23*
|
|
144
|
+
|
|
145
|
+
|
|
143
146
|
## Installation & Building
|
|
144
147
|
|
|
145
|
-
### From NPM
|
|
148
|
+
### From NPM (Recommended)
|
|
146
149
|
```bash
|
|
147
|
-
npm install -g heraspec
|
|
150
|
+
npm install -g heraspec@latest
|
|
148
151
|
```
|
|
149
152
|
|
|
150
153
|
### From Source (Development)
|
|
@@ -203,7 +206,8 @@ heraspec pack
|
|
|
203
206
|
- ✅ **Clean Architecture Scaffolder** (`heraspec create` for Perfex CRM, WordPress plugins/themes)
|
|
204
207
|
- ✅ **Production Release Packager** (`heraspec pack` with cross-platform compression & strict bloat exclusion)
|
|
205
208
|
- ✅ **Custom Skill Preservation** (Existing projects safely retain custom skills on `heraspec init`)
|
|
206
|
-
- ✅ **Multi-project type support** (WordPress, Perfex CRM, Laravel, React, Vue, Node.js)
|
|
209
|
+
- ✅ **Multi-project type support** (WordPress, Perfex CRM, Content Channels & Multi-Platform Video, Laravel, React, Vue, Node.js)
|
|
210
|
+
- ✅ **Multi-Channel Content Engineering** (7 content skills: strategy, scaffolding, scripting, voice-adapter, prompts, compliance, and MTxStudio vault sync)
|
|
207
211
|
- ✅ **Specification-driven development** with delta specs and conflict-free parallel merging
|
|
208
212
|
- ✅ **AI Integration Ready** (Cursor, Antigravity, Windsurf, Copilot, Claude Desktop)
|
|
209
213
|
- ✅ **Proactive Memory & Semantic Search** (Token savings & architecture tracking)
|