A world-class, spec-driven development framework for building production-ready, AI-native applications. Use for any new project to ensure adherence to the most advanced 2026 best practices in architecture, security, testing, and deployment.
This skill provides a universal, seven-stage framework for developing production-ready, AI-native applications. It enforces a "Specification-as-Source-of-Truth" mindset, ensuring that every aspect of the project is defined, testable, secure, and documented before and during implementation, following the most advanced 2026 community best practices from Google, GitHub, and Thoughtworks.
spec.md) is the primary artifact. Code is the last-mile implementation of that intent.Follow these stages sequentially. Each stage has a Quality Gate—a set of questions you must answer before proceeding—and a clear Delegate/Review/Own model for human-AI collaboration.
| Stage | Focus | Key Activities | Reference Guides |
|---|---|---|---|
| 1. Specify | User Journey & Requirements | Create spec.md defining user stories, goals, and non-functional requirements. | references/00-specvibe.md |
| 2. Plan | Technical Architecture | Create PLAN.md, select tech stack, define architecture, and break down the spec into tasks. | references/02-backend.md, references/03-frontend.md |
| 3. Test | Behavior-Driven Definition | Write failing unit, integration, and E2E tests based on the spec and plan. | references/05-testing.md |
| 4. Implement | Code Generation & Refinement | Write (or generate) code to make the tests pass, following a chunked iteration strategy. | references/08-ai-collaboration.md |
| 5. Review | Quality & Security Assurance | Conduct automated and human code reviews, focusing on security, logic, and maintainability. | references/04-security.md |
| 6. Document | Knowledge Capture | Automatically generate and manually refine user and developer documentation. | references/09-documentation.md |
| 7. Deploy | CI/CD & Observability | Containerize, set up CI/CD pipelines, and implement full observability. | references/06-devops.md, references/07-error-handling.md |
Goal: Define what to build and why in a structured spec.md.
spec.md using the templates/spec-template.md.spec.md clearly define the user, their problem, and the proposed solution?Goal: Translate the spec.md into a concrete technical plan.
spec.md to the AI and ask it to generate a PLAN.md detailing the architecture, data models (using references/01-schema-and-types.md), API contracts (using templates/openapi-template.yaml), and a task breakdown.Goal: Define the application's behavior through a comprehensive, failing test suite.
spec.md and PLAN.md. Refer to references/05-testing.md.Goal: Write clean, efficient code that makes all tests pass.
references/08-ai-collaboration.md.Goal: Ensure the implemented code is secure, robust, and maintainable.
references/04-security.md (OWASP 2025).Goal: Create clear, comprehensive documentation for both users and developers.
spec.md. Refer to references/09-documentation.md.Goal: Automate deployment and ensure the application is observable and reliable in production.
references/06-devops.md.references/07-error-handling.md).