heraspec 0.1.16 → 0.1.18

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 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. For more information, see the [HeraSpec documentation](./docs/en/USER_GUIDE.md).
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/your-org/heraspec/docs).
138
-
139
- ---
140
-
141
- *This section is automatically updated by `heraspec init`. Last updated: 2026-05-21*
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)