HvA HBO-ICT Afstudeerrapport — Outline Skill
What this skill does
Given a long source document (Dutch or English), produce a thesis outline that
conforms to the HvA HBO-ICT "Richtlijnen Afstudeerrapport" (Januari 2024). The
output is a scaffold: each section has a heading, a brief description of what
belongs there (in Dutch, since the thesis itself is in Dutch), and any content
from the source that already fits that section is slotted in underneath.
Sections the source doesn't cover are marked explicitly so the student knows
what's still missing. The skill does not invent content, does not write
prose for missing sections, and does not summarise the source in the student's
voice.
When to use
- Student or supervisor uploads a stage-plan, internal report, opdrachtbrief,
or early draft and wants it turned into the right structure.
- A long document needs to be reorganised into the fixed HvA chapter order.
- A supervisor wants a quick "gap analysis" showing which required sections are
already covered and which are empty.
Not for: finished theses that need proofreading, citation formatting only, or
cover-page generation alone.
Workflow
1. Read the source carefully
If the source is a PDF, docx, or other binary, extract the full text first.
Read all of it before writing the outline — partial reading produces a wrong
map of what the source covers.
2. Classify the source
Before slotting content, identify what kind of document you are dealing with:
- Opdrachtomschrijving / stage-brief — usually feeds into 1.1 (context) and
1.2 (probleemvraag); rarely has methodologie or resultaten.
- Tussenrapport / stage-plan — feeds inleiding + methodologie; conclusies
usually missing.
- Onderzoeksdraft — may already have kernhoofdstukken; needs restructuring
into the HvA order.
- Bedrijfsdocumentatie — mostly context, rarely has probleemvraag.
This classification tells you where most of the existing material will land and
which sections will be mostly [ONTBREEKT].
3. Produce the outline
Follow the vaste volgorde from the richtlijnen exactly. Items in
parentheses are optional — include them as empty placeholders only if the
source mentions them.
1. Omslag / voorblad
2. Titelpagina
3. (Voorwoord) — alleen opnemen als de bron dit noemt
4. Samenvatting
5. Inhoudsopgave — wordt automatisch gegenereerd; toon als placeholder
6. Inleiding
7. Kernhoofdstukken — decimaal genummerd, begin bij hoofdstuk 2
8. Conclusies
9. Aanbevelingen
10. (Noten)
11. Bronnenlijst — APA of IEEE
12. (Nawoord / reflectie)
13. (Begrippenlijst)
14. Bijlagen — apart genummerd (Bijlage A, B, C…)
4. Content placement rules
Each section has a fixed required-content list per the richtlijnen. Use
these as the sub-structure:
- Omslag/voorblad — titel, (ondertitel), naam bedrijf, auteur, begeleiders (HvA + bedrijf).
- Titelpagina — alles van de omslag + studentennummer, plaats & datum, versie, onderwijsinstelling, opleiding, HvA-begeleider, bedrijfsgegevens, stageperiode. Géén citaten, géén dankwoorden.
- Samenvatting — max 1 pagina, bevat: onderwerp, probleemomschrijving, probleemvraag, onderzoeksmethode, belangrijkste resultaten, belangrijkste conclusies.
- Inleiding — aanleiding, onderwerp/context, probleemstelling, procedure, leeswijzer. Géén "ik/jij/wij".
- Hoofdstuk 1 — Context van de opdracht: 1.1 bedrijf/organisatie · 1.2 opdrachtomschrijving · 1.3 analyse van de opdracht · 1.4 probleemvraag · (1.5 definities) · (1.6 randvoorwaarden) · 1.7 deelvragen.
- Hoofdstuk 2 — (Onderzoeks)methodebeschrijving en -verantwoording: welke methoden, waarom gekozen, hoe uitgevoerd. Als AI-tools zijn gebruikt: vermeld werkwijze hier en prompts in de bijlagen.
- Hoofdstuk 3 — Onderzoek naar hoofd- en deelvragen: één paragraaf per deelvraag.
- Hoofdstuk 4 — Ontwerp en realisatie (indien van toepassing): architectuur, keuzes, één voorbeeldtabel/scherm/user story in de tekst, de rest in bijlagen.
- Hoofdstuk 5 — Testresultaten en evaluatie (of: analyse van resultaten).
- (Hoofdstuk 6 — Implementatie / uitvoering) (alleen indien relevant).
- Conclusies — kort antwoord op de probleemvraag, géén nieuwe informatie, tegenwoordige tijd.
- Aanbevelingen — duidelijk gescheiden van conclusies; volgen uit de conclusies.
- Bronnenlijst — APA of IEEE, consequent één stijl; AI-gebruik wordt hier vermeld.
- Bijlagen — apart genummerd (A, B, C…); o.a. reflectie, onderzoeksplan, volledige user stories, prompts aan AI-tools, vragenlijsten.
5. Handling gaps
For every required sub-section where the source has no content, write:
[ONTBREEKT — nog te schrijven door student]
For optional sections the source doesn't mention, omit them entirely
rather than leaving empty optional sections.
For sub-sections where the source has partial content, place what exists
and add:
[AANVULLEN — bron dekt alleen X, Y mist nog]
6. Content slotting — what to pull vs. paraphrase
- Pull verbatim: concrete facts — company name, opdrachtgever, dates,
technical constraints, deelvragen if explicitly phrased, named methodologies.
- Paraphrase briefly: long narrative passages → condense to 1–3 bullet
points in Dutch, so the student sees what's there without it being a
finished draft.
- Do NOT invent: do not extrapolate a probleemvraag if the source does
not contain one. Do not guess methodologie. Flag as
[ONTBREEKT].
7. Voice and language
- The outline's structural labels (section headings, placement notes) are
in Dutch — this is a Dutch-language thesis.
- Pulled source content stays in its original language inside the outline.
If the source is English and the final thesis will be Dutch, mark these
passages with
[VERTALEN] so the student translates them later.
- Never use "ik", "jij", "wij" in the outline's structural notes (the
richtlijnen forbid it in the thesis itself, except in voorwoord/reflectie).
- Never write about the student in third person either ("De
Afstudeerder…") — this is explicitly prohibited.
8. Formatting conventions from the richtlijnen
The outline must itself follow the document conventions the thesis will use,
so the student can carry it straight over:
- Decimale nummering:
1, 1.1, 1.1.1 — maximum drie niveaus. No Roman numerals.
- Geen punt of dubbele punt achter een kopje.
- Opsommingen: liggende streepjes (
– or -), not bullets.
- Getallen: getallen onder de 20 in woorden; getallen met meeteenheden, data of bedragen altijd in cijfers.
- Bronverwijzingen: APA of IEEE — kies één stijl en markeer bovenaan de bronnenlijst welke is gekozen. Meng geen stijlen.
9. AI-tool disclosure (verplicht per richtlijnen)
The richtlijnen require explicit transparency when AI-tools are used. If the
student used an AI tool (including this skill) for the outline or later
drafting, include in the outline:
- A note under Hoofdstuk 2 (methoden) describing the AI-werkwijze.
- A placeholder Bijlage: AI-prompts en -antwoorden.
- An APA/IEEE-style source entry for each AI-tool used.
Reference for APA-style AI citation: the HvA library's
"AI gegenereerde content in APA-stijl" page (linked in the richtlijnen).
Output format
Produce the outline as Markdown, so it can be pasted into Word, Google Docs,
or opencode. Structure:
# Afstudeerrapport — Outline
*Gegenereerd uit: [bronbestand]. Volgt richtlijnen HvA HBO-ICT, Januari 2024.*
## Dekkingsoverzicht (gap-analyse)
| Sectie | Status | Notitie |
|---|---|---|
| Samenvatting | ONTBREEKT | nog te schrijven |
| 1. Context | GEDEKT | bedrijf en opdracht aanwezig |
| 1.4 Probleemvraag | ONTBREEKT | bron noemt doel, niet de vraag |
| …etc |
---
## 1. Omslag / voorblad
…
## 2. Titelpagina
…
## 3. Samenvatting
[ONTBREEKT — nog te schrijven door student. Max 1 pagina, bevat: …]
## 4. Inleiding
…
## Hoofdstuk 1 — Context van de opdracht
### 1.1 Het bedrijf
*Uit bron:*
- …
### 1.2 Opdrachtomschrijving
*Uit bron:*
- …
### 1.3 Analyse van de opdracht
[ONTBREEKT — nog te schrijven]
### 1.4 Probleemvraag
[AANVULLEN — bron beschrijft doel maar niet de vraag zelf]
…enzovoort…
The dekkingsoverzicht at the top is mandatory — it is the supervisor's
quick look at what's done and what isn't.
Do not
- Do not draft the thesis prose for the student. The outline is scaffolding,
not content.
- Do not invent probleemvragen, deelvragen, methodes, or resultaten.
- Do not rewrite the richtlijnen; follow them exactly as described above.
- Do not switch citation style mid-outline.
- Do not reorder the vaste volgorde — it is fixed.
- Do not include an auto-generated full inhoudsopgave; leave it as a
placeholder (
[Wordt automatisch gegenereerd in Word]).
Quick checklist before delivering the outline
1---2name: hva-thesis-outline3description: Converts a long source document (opdrachtbeschrijving, stage-plan, intern rapport, draft, bedrijfsbrief, onderzoeksnotities) into a properly structured afstudeerrapport-outline following the HvA HBO-ICT richtlijnen (Januari 2024). Use this skill whenever a user mentions HvA, HBO-ICT, Hogeschool van Amsterdam, afstudeerrapport, afstudeerscriptie, BSc thesis, bachelor thesis, thesis outline, afstudeeropdracht, or asks to "structure", "outline", "convert", "turn into a thesis", or "make a thesis skeleton" from any longer document. Also trigger when a student or supervisor shares a draft, stage-report, or project-brief and wants it reorganised into chapters. Produces a Dutch-language outline with the fixed sections (omslag → titelpagina → samenvatting → inhoudsopgave → inleiding → kernhoofdstukken → conclusies → aanbevelingen → bronnenlijst → bijlagen) and pulls existing content from the source into the right places.4---5
6# HvA HBO-ICT Afstudeerrapport — Outline Skill
7
8## What this skill does
9
10Given a long source document (Dutch or English), produce a **thesis outline** that
11conforms to the HvA HBO-ICT "Richtlijnen Afstudeerrapport" (Januari 2024). The
12output is a scaffold: each section has a heading, a brief description of what
13belongs there (in Dutch, since the thesis itself is in Dutch), and any content
14from the source that already fits that section is slotted in underneath.
15
16Sections the source doesn't cover are marked explicitly so the student knows
17what's still missing. The skill does **not** invent content, does not write
18prose for missing sections, and does not summarise the source in the student's
19voice.
20
21## When to use
22
23- Student or supervisor uploads a stage-plan, internal report, opdrachtbrief,
24 or early draft and wants it turned into the right structure.
25- A long document needs to be reorganised into the fixed HvA chapter order.
26- A supervisor wants a quick "gap analysis" showing which required sections are
27 already covered and which are empty.
28
29Not for: finished theses that need proofreading, citation formatting only, or
30cover-page generation alone.
31
32## Workflow
33
34### 1. Read the source carefully
35
36If the source is a PDF, docx, or other binary, extract the full text first.
37Read all of it before writing the outline — partial reading produces a wrong
38map of what the source covers.
39
40### 2. Classify the source
41
42Before slotting content, identify what kind of document you are dealing with:
43
44- **Opdrachtomschrijving / stage-brief** — usually feeds into 1.1 (context) and
45 1.2 (probleemvraag); rarely has methodologie or resultaten.
46- **Tussenrapport / stage-plan** — feeds inleiding + methodologie; conclusies
47 usually missing.
48- **Onderzoeksdraft** — may already have kernhoofdstukken; needs restructuring
49 into the HvA order.
50- **Bedrijfsdocumentatie** — mostly context, rarely has probleemvraag.
51
52This classification tells you where most of the existing material will land and
53which sections will be mostly `[ONTBREEKT]`.
54
55### 3. Produce the outline
56
57Follow the **vaste volgorde** from the richtlijnen exactly. Items in
58parentheses are optional — include them as empty placeholders only if the
59source mentions them.
60
61```
621. Omslag / voorblad
632. Titelpagina
643. (Voorwoord) — alleen opnemen als de bron dit noemt
654. Samenvatting
665. Inhoudsopgave — wordt automatisch gegenereerd; toon als placeholder
676. Inleiding
687. Kernhoofdstukken — decimaal genummerd, begin bij hoofdstuk 2
698. Conclusies
709. Aanbevelingen
7110. (Noten)
7211. Bronnenlijst — APA of IEEE
7312. (Nawoord / reflectie)
7413. (Begrippenlijst)
7514. Bijlagen — apart genummerd (Bijlage A, B, C…)
76```
77
78### 4. Content placement rules
79
80**Each section has a fixed required-content list per the richtlijnen.** Use
81these as the sub-structure:
82
83- **Omslag/voorblad** — titel, (ondertitel), naam bedrijf, auteur, begeleiders (HvA + bedrijf).
84- **Titelpagina** — alles van de omslag + studentennummer, plaats & datum, versie, onderwijsinstelling, opleiding, HvA-begeleider, bedrijfsgegevens, stageperiode. Géén citaten, géén dankwoorden.
85- **Samenvatting** — max 1 pagina, bevat: onderwerp, probleemomschrijving, probleemvraag, onderzoeksmethode, belangrijkste resultaten, belangrijkste conclusies.
86- **Inleiding** — aanleiding, onderwerp/context, probleemstelling, procedure, leeswijzer. Géén "ik/jij/wij".
87- **Hoofdstuk 1 — Context van de opdracht**: 1.1 bedrijf/organisatie · 1.2 opdrachtomschrijving · 1.3 analyse van de opdracht · 1.4 probleemvraag · (1.5 definities) · (1.6 randvoorwaarden) · 1.7 deelvragen.
88- **Hoofdstuk 2 — (Onderzoeks)methodebeschrijving en -verantwoording**: welke methoden, waarom gekozen, hoe uitgevoerd. Als AI-tools zijn gebruikt: vermeld werkwijze hier en prompts in de bijlagen.
89- **Hoofdstuk 3 — Onderzoek naar hoofd- en deelvragen**: één paragraaf per deelvraag.
90- **Hoofdstuk 4 — Ontwerp en realisatie** *(indien van toepassing)*: architectuur, keuzes, één voorbeeldtabel/scherm/user story in de tekst, de rest in bijlagen.
91- **Hoofdstuk 5 — Testresultaten en evaluatie** *(of: analyse van resultaten)*.
92- **(Hoofdstuk 6 — Implementatie / uitvoering)** *(alleen indien relevant)*.
93- **Conclusies** — kort antwoord op de probleemvraag, géén nieuwe informatie, tegenwoordige tijd.
94- **Aanbevelingen** — duidelijk gescheiden van conclusies; volgen uit de conclusies.
95- **Bronnenlijst** — APA of IEEE, consequent één stijl; AI-gebruik wordt hier vermeld.
96- **Bijlagen** — apart genummerd (A, B, C…); o.a. reflectie, onderzoeksplan, volledige user stories, prompts aan AI-tools, vragenlijsten.
97
98### 5. Handling gaps
99
100For every required sub-section where the source has **no** content, write:
101
102```
103[ONTBREEKT — nog te schrijven door student]
104```
105
106For optional sections the source doesn't mention, **omit them entirely**
107rather than leaving empty optional sections.
108
109For sub-sections where the source has **partial** content, place what exists
110and add:
111
112```
113[AANVULLEN — bron dekt alleen X, Y mist nog]
114```
115
116### 6. Content slotting — what to pull vs. paraphrase
117
118- **Pull verbatim**: concrete facts — company name, opdrachtgever, dates,
119 technical constraints, deelvragen if explicitly phrased, named methodologies.
120- **Paraphrase briefly**: long narrative passages → condense to 1–3 bullet
121 points in Dutch, so the student sees what's there without it being a
122 finished draft.
123- **Do NOT invent**: do not extrapolate a probleemvraag if the source does
124 not contain one. Do not guess methodologie. Flag as `[ONTBREEKT]`.
125
126### 7. Voice and language
127
128- The outline's **structural labels** (section headings, placement notes) are
129 in Dutch — this is a Dutch-language thesis.
130- **Pulled source content** stays in its original language inside the outline.
131 If the source is English and the final thesis will be Dutch, mark these
132 passages with `[VERTALEN]` so the student translates them later.
133- **Never use "ik", "jij", "wij"** in the outline's structural notes (the
134 richtlijnen forbid it in the thesis itself, except in voorwoord/reflectie).
135- **Never write about the student in third person** either ("De
136 Afstudeerder…") — this is explicitly prohibited.
137
138### 8. Formatting conventions from the richtlijnen
139
140The outline must itself follow the document conventions the thesis will use,
141so the student can carry it straight over:
142
143- **Decimale nummering**: `1`, `1.1`, `1.1.1` — maximum drie niveaus. No Roman numerals.
144- **Geen punt of dubbele punt achter een kopje.**
145- **Opsommingen**: liggende streepjes (`–` or `-`), not bullets.
146- **Getallen**: getallen onder de 20 in woorden; getallen met meeteenheden, data of bedragen altijd in cijfers.
147- **Bronverwijzingen**: APA **of** IEEE — kies één stijl en markeer bovenaan de bronnenlijst welke is gekozen. Meng geen stijlen.
148
149### 9. AI-tool disclosure (verplicht per richtlijnen)
150
151The richtlijnen require explicit transparency when AI-tools are used. If the
152student used an AI tool (including this skill) for the outline or later
153drafting, include in the outline:
154
155- A note under **Hoofdstuk 2 (methoden)** describing the AI-werkwijze.
156- A placeholder **Bijlage: AI-prompts en -antwoorden**.
157- An APA/IEEE-style source entry for each AI-tool used.
158
159Reference for APA-style AI citation: the HvA library's
160"AI gegenereerde content in APA-stijl" page (linked in the richtlijnen).
161
162## Output format
163
164Produce the outline as **Markdown**, so it can be pasted into Word, Google Docs,
165or opencode. Structure:
166
167```markdown
168# Afstudeerrapport — Outline
169
170*Gegenereerd uit: [bronbestand]. Volgt richtlijnen HvA HBO-ICT, Januari 2024.*
171
172## Dekkingsoverzicht (gap-analyse)
173
174| Sectie | Status | Notitie |
175|---|---|---|
176| Samenvatting | ONTBREEKT | nog te schrijven |
177| 1. Context | GEDEKT | bedrijf en opdracht aanwezig |
178| 1.4 Probleemvraag | ONTBREEKT | bron noemt doel, niet de vraag |
179| …etc |
180
181---
182
183## 1. Omslag / voorblad
184…
185
186## 2. Titelpagina
187…
188
189## 3. Samenvatting
190[ONTBREEKT — nog te schrijven door student. Max 1 pagina, bevat: …]
191
192## 4. Inleiding
193…
194
195## Hoofdstuk 1 — Context van de opdracht
196
197### 1.1 Het bedrijf
198*Uit bron:*
199- …
200
201### 1.2 Opdrachtomschrijving
202*Uit bron:*
203- …
204
205### 1.3 Analyse van de opdracht
206[ONTBREEKT — nog te schrijven]
207
208### 1.4 Probleemvraag
209[AANVULLEN — bron beschrijft doel maar niet de vraag zelf]
210
211…enzovoort…
212```
213
214The **dekkingsoverzicht** at the top is mandatory — it is the supervisor's
215quick look at what's done and what isn't.
216
217## Do not
218
219- Do not draft the thesis prose for the student. The outline is scaffolding,
220 not content.
221- Do not invent probleemvragen, deelvragen, methodes, or resultaten.
222- Do not rewrite the richtlijnen; follow them exactly as described above.
223- Do not switch citation style mid-outline.
224- Do not reorder the vaste volgorde — it is fixed.
225- Do not include an auto-generated full inhoudsopgave; leave it as a
226 placeholder (`[Wordt automatisch gegenereerd in Word]`).
227
228## Quick checklist before delivering the outline
229
230- [ ] Vaste volgorde wordt exact gevolgd?
231- [ ] Dekkingsoverzicht / gap-analyse aanwezig?
232- [ ] Elke ontbrekende verplichte subsectie expliciet gemarkeerd als `[ONTBREEKT]`?
233- [ ] Decimale nummering (max 3 niveaus) consistent?
234- [ ] Geen "ik/jij/wij" in structuurnotities?
235- [ ] AI-gebruik gemeld (als van toepassing)?
236- [ ] Bronverwijzingsstijl APA **of** IEEE gekozen, niet gemixt?
237- [ ] Bijlage-nummering apart (A, B, C…) en niet meegenummerd met hoofdstukken?
aibot88