us — User stories with acceptance criteria
Product-backlog stories: epic, role, goal, benefit, acceptance criteria, story points and MoSCoW priority.
- Dominio
- software engineering / agile
- Versión
- 1
- Padre
- — (raíz)
- Clave de registros
stories- Separador de lista
,- Archivo
- forks/us/contract.json
Campos por posición
| # | Tipo | Descripción | Parte |
|---|---|---|---|
id | str | (unique: True) | núcleo |
epic | str | núcleo | |
role | str | núcleo | |
goal | str | núcleo | |
benefit | str | núcleo | |
acceptance | list | (min: 1 · max: 10) | núcleo |
sp | int | (min: 1 · max: 100) | núcleo |
priority | enum | (valores: must, should, could, wont) | núcleo |
Ejemplo válido
us|n=12|d=20260603|l=en|t=SIMA backlog|sprint=S3
US-01|EP-01|student|upload a recorded lecture|I can study it later in small pieces|audio up to 200 MB accepted,credit estimate shown before confirming|5|must
US-02|EP-01|student|paste a transcript instead of audio|I can skip transcription when I already have notes|plain text accepted,same pipeline from generation stage|3|should
US-03|EP-02|student|see the generated question bank|I can check what will be asked|items listed with Bloom level,download as JSON|3|must
US-04|EP-02|system|generate items in .mini|token cost per bank drops|n matches record lines,parser reports zero errors|8|must
US-05|EP-03|reviewer|flag incoherent items|students never see broken questions|declarative stems detected,repair trace stored|5|must
US-06|EP-03|reviewer|verify facts against sources|the bank is trustworthy|web or EduQG context attached,report lists weak items|8|should
US-07|EP-04|student|keep my progress per course|I know what to review next|theta stored per profile,dashboard shows level|5|must
US-08|EP-05|student|take an adaptive quiz|questions match my level|next item chosen by information,stops at SE threshold|8|must
US-09|EP-05|student|review flashcards|I retain key concepts|cards derived from the bank,spaced repetition schedule|5|should
US-10|EP-05|student|see a concept map|I understand how topics connect|edges from the bank,clickable nodes|3|could
US-11|EP-05|student|solve matching and cloze exercises|I practise in different ways|two exercise types,scored instantly|5|could
US-12|EP-04|admin|audit credit consumption|billing is transparent|ledger per user,export CSV|3|should
Con el ZIP opcional extraído, valida con mini --forks forks validate forks/us/fixtures/valid.mini.
Notas de la familia
.mini-us — Historias de usuario con criterios de aceptación#
Prefijo: us Versión: 1 Padre: — Dominio: ingeniería de software / ágil
Historias del backlog de producto: épica, rol, objetivo, beneficio, criterios de aceptación, puntos de historia y prioridad MoSCoW.
Estructura del registro#
id:str | epic:str | role:str | goal:str | benefit:str | acceptance:list<str>[1..10] | sp:int[1..100] | priority:enum{must|should|could|wont}
| # | campo | tipo | notas |
|---|---|---|---|
| 1 | id |
str |
núcleo |
| 2 | epic |
str |
núcleo |
| 3 | role |
str |
núcleo |
| 4 | goal |
str |
núcleo |
| 5 | benefit |
str |
núcleo |
| 6 | acceptance |
list<str>[1..10] |
núcleo |
| 7 | sp |
int[1..100] |
núcleo |
| 8 | priority |
enum{must|should|could|wont} |
núcleo |
Claves de cabecera#
| clave | tipo | requerida | descripción |
|---|---|---|---|
d |
str |
no | fecha de generación AAAAMMDD |
l |
str |
no | código de idioma |
t |
str |
no | |
sprint |
str |
no | |
n |
int |
sí | número de registros |
v |
int |
no | versión del contrato |
Ejemplo#
us|n=12|d=20260603|l=en|t=SIMA backlog|sprint=S3
US-01|EP-01|student|upload a recorded lecture|I can study it later in small pieces|audio up to 200 MB accepted,credit estimate shown before confirming|5|must
US-02|EP-01|student|paste a transcript instead of audio|I can skip transcription when I already have notes|plain text accepted,same pipeline from generation stage|3|should
…
Fixtures#
fixtures/valid.mini ↔ fixtures/canonical.json (ida y vuelta), fixtures/escaping.mini ↔ fixtures/escaping.json, y los casos negativos bad_count.mini, bad_arity.mini, bad_type.mini.
Bloque de prompt#
Genera la especificación transferible con mini prompt us.
us — User stories with acceptance criteria
Product-backlog stories: epic, role, goal, benefit, acceptance criteria, story points and MoSCoW priority.
- Domain
- software engineering / agile
- Version
- 1
- Parent
- — (root)
- Records key
stories- List separator
,- File
- forks/us/contract.json
Fields by position
| # | Type | Description | Part |
|---|---|---|---|
id | str | (unique: True) | core |
epic | str | core | |
role | str | core | |
goal | str | core | |
benefit | str | core | |
acceptance | list | (min: 1 · max: 10) | core |
sp | int | (min: 1 · max: 100) | core |
priority | enum | (values: must, should, could, wont) | core |
Valid example
us|n=12|d=20260603|l=en|t=SIMA backlog|sprint=S3
US-01|EP-01|student|upload a recorded lecture|I can study it later in small pieces|audio up to 200 MB accepted,credit estimate shown before confirming|5|must
US-02|EP-01|student|paste a transcript instead of audio|I can skip transcription when I already have notes|plain text accepted,same pipeline from generation stage|3|should
US-03|EP-02|student|see the generated question bank|I can check what will be asked|items listed with Bloom level,download as JSON|3|must
US-04|EP-02|system|generate items in .mini|token cost per bank drops|n matches record lines,parser reports zero errors|8|must
US-05|EP-03|reviewer|flag incoherent items|students never see broken questions|declarative stems detected,repair trace stored|5|must
US-06|EP-03|reviewer|verify facts against sources|the bank is trustworthy|web or EduQG context attached,report lists weak items|8|should
US-07|EP-04|student|keep my progress per course|I know what to review next|theta stored per profile,dashboard shows level|5|must
US-08|EP-05|student|take an adaptive quiz|questions match my level|next item chosen by information,stops at SE threshold|8|must
US-09|EP-05|student|review flashcards|I retain key concepts|cards derived from the bank,spaced repetition schedule|5|should
US-10|EP-05|student|see a concept map|I understand how topics connect|edges from the bank,clickable nodes|3|could
US-11|EP-05|student|solve matching and cloze exercises|I practise in different ways|two exercise types,scored instantly|5|could
US-12|EP-04|admin|audit credit consumption|billing is transparent|ledger per user,export CSV|3|should
With the optional ZIP extracted, validate with mini --forks forks validate forks/us/fixtures/valid.mini.
Family notes
.mini-us — User stories with acceptance criteria#
Prefix: us Version: 1 Parent: — Domain: software engineering / agile
Product-backlog stories: epic, role, goal, benefit, acceptance criteria, story points and MoSCoW priority.
Record layout#
id:str | epic:str | role:str | goal:str | benefit:str | acceptance:list<str>[1..10] | sp:int[1..100] | priority:enum{must|should|could|wont}
| # | field | type | notes |
|---|---|---|---|
| 1 | id |
str |
core |
| 2 | epic |
str |
core |
| 3 | role |
str |
core |
| 4 | goal |
str |
core |
| 5 | benefit |
str |
core |
| 6 | acceptance |
list<str>[1..10] |
core |
| 7 | sp |
int[1..100] |
core |
| 8 | priority |
enum{must|should|could|wont} |
core |
Header keys#
| key | type | required | description |
|---|---|---|---|
d |
str |
no | generation date YYYYMMDD |
l |
str |
no | language code |
t |
str |
no | |
sprint |
str |
no | |
n |
int |
yes | number of records |
v |
int |
no | contract version |
Example#
us|n=12|d=20260603|l=en|t=SIMA backlog|sprint=S3
US-01|EP-01|student|upload a recorded lecture|I can study it later in small pieces|audio up to 200 MB accepted,credit estimate shown before confirming|5|must
US-02|EP-01|student|paste a transcript instead of audio|I can skip transcription when I already have notes|plain text accepted,same pipeline from generation stage|3|should
…
Fixtures#
fixtures/valid.mini ↔ fixtures/canonical.json (round-trip), fixtures/escaping.mini ↔ fixtures/escaping.json, and the negative cases bad_count.mini, bad_arity.mini, bad_type.mini.
Prompt block#
Generate the transferable specification with mini prompt us.