spekkio

Spekkio is an innovative tool designed to extract value from vibe-coded applications, often referred to as "slapps" or AI "slop apps," by reverse engineering their specifications. This approach addresses the common issue faced by developers and industry veterans alike: applications that function intermittently but still hold significant value. Spekkio transforms the chaotic nature of these apps into structured insights, facilitating better maintenance and development practices.

Key Features:

• Intent Understanding: Spekkio begins by collecting information regarding the original intent of the application builders, ensuring a clear understanding of what the app is supposed to achieve.
• Behavioral Baseline Maintenance: The tool keeps the existing slapp as a behavioral baseline to manage safe refactoring and evolution of the application.
• Behavior-Driven Development (BDD) Scenarios: By generating BDD scenarios that reflect the current behavior of the app, Spekkio supports more effective testing and development.

Workflow Overview:

The process is illustrated through the extract mechanism:

Existing code (vibe-coded)
    ↓
/spekkio.extract
    ↓
spec.md (inferred user stories, acceptance criteria)
features/*.feature (characterization scenarios)
    ↓
Human review: "Is this what we actually want?"
    ↓
Adjust spec (remove bugs-as-features, add missing intent)
    ↓
Normal Spec Kit flow from here

The extraction process comprises six phases, producing outputs that assist in revealing anomalies typically found in vibe-coded apps such as missing validations, security vulnerabilities, dead code, inconsistent error handling, and lack of test coverage:

Post-Extraction Analysis:

After extraction, users can:

1. Review and update the checklist to confirm or modify each user story.
2. Address anomalies by distinguishing intentional features from bugs.
3. Transfer approved scenarios from the characterization directory to intended scenarios.
4. Leverage the detailed specifications as a reliable source of truth for future development.

End-to-End Example:

An example FastAPI ATM application, located in examples/atm/, is available to demonstrate the extraction tool in action with intentional anomalies for educational purposes. To run it, use:

/spekkio.extract examples/atm

Visual Reporting:

Post-extraction, users can access screenshots detailing various reports, including an overview and specific filter views for human input and anomalies, helping in the assessment and refinement stages.