Skip to content

A CLI tool for managing project specifications and AI-powered development workflow

License

Notifications You must be signed in to change notification settings

PolyXGO/HeraSpec

Repository files navigation

HeraSpec

npm version license node version build status

downloads stars forks issues


🌐 Website💻 GitHub📦 NPM📚 Documentation

HeraSpec is a specification-based development framework that helps you:

  • Plan before coding by creating detailed project specifications
  • Track changes through delta specifications
  • Work across multiple project types (WordPress, Laravel, React, etc.)
  • Integrate with AI tools for better development workflow

Important Note

Note: HeraSpec is a workflow that I have synthesized, tested, and am currently applying to my work. I constantly refine it to fit small and medium projects, especially for solo freelancers working alone: coding on demand, selling plugins, modules, themes, and software on platforms like Envato.

Therefore, there may be many components and structures that are not strictly standardized or suitable for large and complex processes. In such cases, please skip or adjust them accordingly—ask your AI Agents to tailor it to your needs!

If you have any suggestions for new skills to supplement HeraSpec, please let me know! Good luck with love!

Installation

npm install -g heraspec

Quick Start

# Initialize a new project
heraspec init

# Create your first change proposal
heraspec change create "add-user-authentication"

# Start working on the change
heraspec change start "add-user-authentication"

Documentation

Features

  • ✅ Multi-project type support (WordPress, Laravel, React, Vue, etc.)
  • ✅ Specification-driven development
  • ✅ AI integration ready
  • ✅ Change tracking and management
  • ✅ Delta specifications
  • ✅ Task management with skills system

AI Integration

Integrate with AI tools for better development workflow: Cursor, Antigravity, Windsurf, Copilot, and Claude Desktop. HeraSpec automatically generates specifications that AI tools can understand and implement.

Supported AI Tools

  • Cursor - Native AGENTS.md support for automatic change creation
  • Antigravity - AGENTS.md integration for spec-driven development
  • Windsurf - AI-powered workflow with HeraSpec specifications
  • Copilot - Enhanced development with structured specs
  • Claude Desktop - MCP-ready architecture for AI assistance

Showcase

Here are some products built partially or entirely using the HeraSpec framework:

Plugin WordPress cho Phong Thủy Huyền Học

Plugin WordPress khác

Support

If you find this source code helpful, consider buying me a coffee to support my work! ☕

Buy Me A Coffee

-or-

Donate QR Code

License

MIT License - see LICENSE file for details.