Τι είναι το Superpowers framework

Πώς το χρησιμοποιεί το AI (Ο Εσωτερικός Μηχανισμός)

1. Bootstrap Check (using-superpowers): Πριν εκτελέσει οποιαδήποτε ενέργεια, το AI ελέγχει αν το αίτημα ταιριάζει με κάποιο ενεργό skill.
2. Brainstorming: Δεν γράφει ούτε γραμμή κώδικα. Κάνει ερωτήσεις, εντοπίζει edge cases, προτείνει εναλλακτικές και συντάσσει ένα σύντομο design doc.
3. Writing Plans: Σπάει το approved design σε μικρά tasks των 2-5 λεπτών, αναγράφοντας συγκεκριμένα file paths και τεστ επαλήθευσης.
4. Git Worktree Isolation: Ανοίγει ξεχωριστό Git worktree/branch για να μην πειράξει το ενεργό working directory.
5. Enforced TDD Cycle:
   • RED: Γράφει πρώτα ένα unit/integration test που αποτυγχάνει.
   • GREEN: Γράφει τον ελάχιστο κώδικα ώστε να περάσει το test.
   • REFACTOR: Καθαρίζει τον κώδικα. (Κανόνας του framework: Αν γραφτεί παραγωγικός κώδικας πριν το τεστ, διαγράφεται).
6. Code Review Gate: Ένας ξεχωριστός sub-agent ή prompt loop ελέγχει αν ο κώδικας τηρεί αυστηρά τις προδιαγραφές πριν γίνει commit/merge.

Πώς το εγκαθιστάς & το χρησιμοποιείς στο VS Code

Μέθοδος Α: Μέσω Claude Code / Terminal Agent (Επίσημο Repo)

# Εγκατάσταση του Superpowers plugin
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Μέθοδος Β: Μέσω GitHub Copilot / Cursor / Roo Code / Cline

1. Κλωνοποίησε τα skills στο root του project σου:

git clone https://github.com/obra/superpowers.git .superpowers

2. Στο αρχείο κανόνων του workspace σου (π.χ. .github/copilot-instructions.md, .cursorrules ή .clinerules), πρόσθεσε την εντολή bootstrap

Markdown

# Superpowers Methodology Enforced
Before answering any feature request, bug fix, or refactoring:
1. Always evaluate `.superpowers/skills/` to locate the required skill.
2. Follow the workflow strictly: Never jump to coding without brainstorming and creating a test plan.
3. Apply Test-Driven Development (TDD): write the failing test first, verify failure, then implement.

Παράδειγμα Πρακτικής Χρήσης

Το Prompt σου στο VS Code Chat:

"Θέλω να φτιάξουμε ένα rate limiter middleware που να επιτρέπει 100 requests ανά ώρα ανά IP διεύθυνση."

Τι κάνει ένα AI Χωρίς Superpowers:

Τι κάνει το AI Με το Superpowers ενεργό:

1. Ενεργοποιεί το brainstorming:

   "Πριν ξεκινήσουμε, ας καθορίσουμε το design:

   1. Πού θα κρατάμε τα hit counters; Σε Memory Map ή σε Redis cache;

   2. Τι HTTP response θέλουμε στο limit breach (429 Too Many Requests);

   3. Πώς διαβάζουμε την IP (Direct socket ή μέσω reverse proxy headers όπως X-Forwarded-For);"

2. Γράφει το Implementation Plan (writing-plans):
   Αφού απαντήσεις, δημιουργεί αρχείο plans/rate-limiter.md με βήματα 1 έως 4 και τις ακριβείς εντολές δοκιμών.
3. Εκτελεί με TDD (test-driven-development):
   
   
   • Φτιάχνει το αρχείο tests/rateLimiter.test.ts.
   • Τρέχει το test runner στο τερματικό σου: Test fails (RED).
   • Φτιάχνει το middleware/rateLimiter.ts με την ελάχιστη λογική.
   • Ξανατρέχει το test: Test passes (GREEN).
4. Ζητά Review: Ρωτά αν θέλεις να κάνει commit στο worktree branch ή να συγχωνεύσει τις αλλαγές.

Πώς ξέρεις ότι δουλεύει;

• Δεν γράφει αμέσως κώδικα: Αν στην πρώτη σου ερώτηση απαντήσει κάνοντας ερωτήσεις διερεύνησης (Socratic refinement) και ζητήσει επιβεβαίωση αρχιτεκτονικής, το framework λειτουργεί.
• Βλέπεις αναφορές σε skills: Στα logs/chat του AI θα δεις status όπως Reading .superpowers/skills/brainstorming/SKILL.md ή Invoking tdd-workflow.
• Αποτυχία πριν την επιτυχία: Θα παρατηρήσεις ότι το agent εκτελεί εντολές στο τερματικό για να βεβαιωθεί ότι το τεστ απέτυχε πριν γράψει τον κανονικό κώδικα.
• Κανένα "phantom done": Το AI δεν λέει ποτέ «Έτοιμο!» χωρίς να παραθέσει output από τερματικό που πιστοποιεί ότι τα verification tests πέρασαν.

Πλεονεκτήματα

• Μηδενικό Regression: Επειδή κάθε task συνοδεύεται υποχρεωτικά από τεστ, το AI δεν χαλάει υπάρχουσες λειτουργίες.
• Ασφάλεια Codebase: Χάρη στα Git worktrees, αν το AI αποτύχει ή ακολουθήσει λάθος δρόμο, το main branch μένει εντελώς ανέγγιχτο.
• Προβλέψιμο κόστος & Token Efficiency: Αντί για ατελείωτα prompt-response loops διορθώνοντας bugs, το AI ακολουθεί συγκεκριμένο checklist και τελειώνει τη δουλειά με την πρώτη σωστά.
• Επιβολή Software Architecture: Μπορείς να προσθέσεις δικά σου custom skills (π.χ. απαγόρευση direct DB queries έξω από τα repositories), και το AI θα τα τηρεί απαρέγκλιτα.