-
Notifications
You must be signed in to change notification settings - Fork 0
AcaiSh
acai.sh is a spec-driven development toolkit that formalises software requirements as feature.yaml files with unique traceable identifiers (called ACIDs — Acceptance Criteria IDs). Implementations and tests in the codebase are tagged with these IDs, creating a traceable link from requirement through code to verified behaviour. A CLI lets developers and agents push specs, pull requirements, and check coverage; a dashboard tracks status from specification through implementation, review, and human acceptance.
The design is explicitly oriented toward AI-assisted development workflows, where agents need a machine-readable source of truth to understand what to build and verify what has been built.
Placed in Techniques > Assess at inner position because formalising requirements as traceable, agent-readable artifacts addresses a real gap in AI-assisted development: agents lack a structured way to know which requirements they are satisfying or missing. The ACID identifier system and feature.yaml format are lightweight enough to adopt incrementally. The technique is applicable to any project using AI coding agents and directly complements approaches like Structured-Prompt-Driven Development. Worth assessing on an active project where requirement traceability is a friction point.