aidd  by paralleldrive

Accelerate sustainable software development with AI agents

Created 8 months ago
259 stars

Top 97.8% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

AI-Driven Development (AIDD) Framework addresses the challenge of AI-generated code becoming unmaintainable and buggy at scale by providing a structured approach to AI-Driven Development. It targets engineers and power users seeking to leverage AI for rapid development while ensuring code quality, security, and maintainability. The benefit is transforming AI speed into sustainable velocity for production-ready software.

How It Works

AIDD implements a methodology where AI systems manage code generation, testing, and documentation. It utilizes SudoLang, a typed pseudocode language, for structured AI orchestration and prompt engineering. The framework automates key software engineering processes, including specification-driven development, Test-Driven Development (TDD), and code reviews, ensuring AI-generated code aligns with project goals and best practices.

Quick Start & Requirements

  • Install/Run: npx aidd --help for general usage. For project setup: npx aidd my-project or npx aidd --cursor my-project for Cursor editor integration.
  • Prerequisites: Node.js 16.0.0+ (with ESM support), Unix/Linux shell (or WSL), any LLM (Claude 4.5 Sonnet recommended).
  • Links: SudoLang GitHub Repository (for editor syntax highlighting).

Highlighted Details

  • SudoLang: A declarative, constraint-based pseudocode language designed for AI prompting, offering improved reasoning, reduced token costs (20-30% fewer), and enhanced prompt maintainability over natural language.
  • AIDD CLI: Automates project bootstrapping and AI system setup, including optional integration with the Cursor editor via a .cursor symlink.
  • Vision Document (vision.md): Serves as the definitive source of truth for AI agents, outlining project vision, goals, constraints, and architectural decisions to guide AI development.
  • Agent Workflows: Predefined commands (/discover, /task, /execute, /review, /user-test) orchestrate AI agents through structured development processes from product discovery to release.
  • AIDD Server Framework: A lightweight, composable, and type-safe Node.js backend framework featuring function composition, secure configuration, and integrated authentication middleware.

Maintenance & Community

Contributions are welcomed via CONTRIBUTING.md. No specific community channels or notable contributors are detailed in the provided README.

Licensing & Compatibility

  • License: MIT.
  • Compatibility: Permissive MIT license generally allows for commercial use and integration with closed-source projects.

Limitations & Caveats

The framework's effectiveness is tied to the capabilities of the underlying LLM, with specific recommendations provided. While optimized for the Cursor editor, integration with other environments may require manual configuration. Development requires Node.js 16.0.0+ and a compatible shell environment.

Health Check
Last Commit

9 hours ago

Responsiveness

Inactive

Pull Requests (30d)
32
Issues (30d)
12
Star History
61 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.