smaqit

smaQit is a spec-driven development kit designed to orchestrate agentic software development workflows. It enables teams to describe requirements, which specification agents then convert into stateful specs. Implementation agents subsequently transform these specs into working, tested, and deployed applications. The toolkit emphasizes auditability, clear boundaries, and reproducible workflows. Key features include a single installer that embeds necessary tools like PlantUML MCP and JavaScript/WASM renderers, requiring only Node.js 22+ as a host prerequisite. It enforces visual design gates using UML-style PlantUML/PNG pairs linked to active specifications, ensuring they are reviewed before implementation. Requirements are traceable from input to spec to implementation, and specifications track their lifecycle through draft, implemented, deployed, and validated states. Agents are bounded to specific layers or phases to prevent scope creep and self-validate their outputs. smaQit currently supports GitHub Copilot (VS Code), Claude Code, and OpenAI Codex. Installation is performed via a curl script, placing agents and skills in user directories. After initializing with `smaqit init`, users can invoke the `smaqit.development` agent to build applications from specs. The toolkit includes CLI commands for scaffolding, status checks, validation, and design rendering. It also integrates with GitHub Actions to automatically install smaqit before Copilot coding agent sessions. The system is designed to preserve user data and custom extensions during updates or reinstallation.