A methodology and set of AI-powered skills, hai-stack aims to transform AI programming assistants into reliable collaborators. It addresses the common issue of "casual" AI interaction by formalizing a workflow from idea to delivery, aiming to reduce wasted effort, mitigate scope creep, and ensure verifiable outcomes. This system benefits developers and technical users seeking structured, efficient AI-assisted software development.

How It Works

The core methodology follows Idea → Frame → PRD → Goal → Architecture → TDD → Audit → Report, with each stage mapped to specific AI skills. Unique skills like geju, goudi, and hai-razor counteract AI biases—timidity, vagueness, and over-complexity—by guiding towards broader perspectives, concrete steps, or essential simplicity. This structured approach validates ideas, defines solutions, tests implementations, and synchronizes documentation, reducing randomness in AI-human collaboration.

Quick Start & Requirements

Clone the repository and run make link to install skills via symbolic links to ~/.claude/skills/ and ~/.codex/skills/. Basic usage requires no dependencies. Generating PNG screenshots from HTML reports requires Node.js and Playwright.

Highlighted Details

• AI Bias Mitigation: Features geju (opens perspective), goudi (grounds visions), and hai-razor (applies Occam's Razor) to counter specific AI tendencies.
• Full Lifecycle Coverage: Includes skills for idea validation (hai-idea), architecture review (hai-architecture), TDD (hai-tdd), documentation auditing (hai-audit-docs-against-code), and visual reporting (hai-visual-report).
• Structured Outputs: Skills generate scorecards, kill-lists, goal documents, and visually appealing HTML reports or shareable image cards.
• Code Quality Tools: Offers linters (hai-ast-grep), code reviewers (clean-code-reviewer), and component diagnostics (react-component-diagnosis).

Maintenance & Community

No specific information regarding maintainers, community channels, or project roadmap was found in the provided content.

Licensing & Compatibility

The license type and compatibility notes for commercial use or closed-source linking are not specified in the provided content.

Limitations & Caveats

Project stability (e.g., alpha/beta status) and known bugs are not explicitly detailed. Core functionality requires no installation, but visual output generation (PNGs) depends on Node.js with Playwright.