CtrlK
BlogDocsLog inGet started
Tessl Logo

spec-driven-devlopment/spec-as-source

Spec-driven development on OpenSpec, with mechanical spec-as-source enforcement: a custom 'spec-as-source' OpenSpec schema adds file-ownership (targets) and test-verification ([@test]) metadata to every capability spec, three scripts (link check, ownership check, manifest build) keep code and specs from drifting apart, plus requirement-gathering, spec-writer, work-review, and a session-handoff skill with a proactive context-warning hook.

73

Quality

92%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

bug-template.mdskills/handoff-skill/references/

BUG-NNN.md — Template Completo

# BUG-[NNN] — Test [nome-skill] v[versione/target]
> Data: [YYYY-MM-DD HH:MM] | Sessione test: #[N] | Continua da: BUG-[N-1].md (o —)
> Skill/Plugin: [nome] | Operatore: [persona + modello AI]
> Obiettivo rilascio: [es. "v2.2.0", "fix prima del prossimo publish"]

---

## 🎯 Goal
[Quale skill/plugin si sta testando e perché — per quale upgrade o rilascio.
Cambia raramente tra sessioni di test della stessa skill.]

## 🧪 Test Scenarios

| # | Scenario | Input/Comando esatto | Esito |
|---|---|---|---|
| 1 | [descrizione scenario] | [comando, prompt, o sequenza di azioni] | ✅ Pass / ❌ Fail (→ BUG-NNN-01) |
| 2 | [descrizione scenario] | [comando, prompt, o sequenza di azioni] | ✅ Pass |

## 🐛 Bug Tracker

| ID | Scenario | Atteso | Reale | Severità | File:riga | Stato | Fix |
|---|---|---|---|---|---|---|---|
| BUG-[NNN]-01 | [da Test Scenarios #] | [comportamento corretto previsto] | [cosa succede davvero] | Blocker/Major/Minor | [path:riga se noto] | Open | — |
| BUG-[NNN]-02 | ... | ... | ... | ... | ... | Fixed | [commit/descrizione fix] |

Severità:
- **Blocker** — la skill è inusabile o produce un risultato dannoso (es. cancella/sovrascrive dati, pubblica per errore).
- **Major** — comportamento sbagliato ma la skill resta usabile con workaround.
- **Minor** — cosmetico, messaggio poco chiaro, edge case raro.

## 💡 Confirmed Behaviors
[Cosa è stato verificato corretto in questa sessione — non ritestare da zero al prossimo giro salvo regressione sospetta.]

- **[Scenario]**: confermato corretto → [breve nota sul perché/come verificato]

## 🚀 Next Steps
[Fix prioritari, ordinati per severità. Item #1 eseguibile subito senza domande.]

1. [Fix per BUG-[NNN]-01 — cosa cambiare, dove]
2. [Fix per BUG-[NNN]-02]
3. [Scenario ancora da testare, se rimasto fuori da questa sessione]

## 📎 Context Importante (opzionale)
[Solo se serve: ambiente di test usato, dati/fixture necessari per riprodurre, link a issue esterne.]

Regole di aggiornamento (quando BUG-NNN già esiste per quella skill)

  1. Incrementa numero sessione di test, aggiorna data.
  2. Riporta i bug ancora "Open" dell'ultimo BUG-NNN.md come riga iniziale del nuovo Bug Tracker, mantenendo lo stesso ID — non rigenerare ID per bug già esistenti.
  3. Aggiorna lo Stato dei bug chiusi in questa sessione (Open → Fixed) con riferimento al fix.
  4. Appendi nuovi bug trovati con ID che continua la sequenza (BUG-[NNN]-0X), non riusare numeri di bug già chiusi.
  5. Non eliminare mai righe di bug, nemmeno se "Fixed" — la storia serve a non reintrodurre la stessa regressione.

skills

README.md

tile.json