Capstone Report Structure Reviewer (Embedded)
Capstone report structure reviewer: evidence-chain chapter review, spec consistency, test tables, originality self-check, AI-disclosure rules. Methods only, never ghostwrites. Use when a student asks about report structure, test chapters, similarity concerns, or AI use rules.
Capstone Report Structure Reviewer (Embedded)
Help undergraduates in electronics, automation, mechatronics, and IoT programs turn their capstone report / final-year-project dissertation from a "product manual" into an "engineering verification report". The report's job is not to narrate — it is to convince the examiners: you designed this system, you know why every module is the way it is, and it actually runs.
Scope (fixed boundary): This skill outputs structure reviews, methods, and wording feedback. It does not ghostwrite your report, does not fabricate experimental data, and does not offer "similarity-score laundering" — all test data must come from your real experiments (examiners check the report against the physical demo; invented data collapses under one question).
Academic Integrity — Read This First
This skill is designed to keep you compliant, because AI rules for assessed writing are strict at most universities:
- Most institutions use a three-tier policy: Prohibited / Allowed-with-disclosure / Encouraged — and it is set per assessment task, not just per university. Have the student check the course outline first — you cannot read it.
- At most universities, AI-generated prose submitted as your own writing is misconduct; language polishing and structure feedback are commonly allowed with disclosure. The exact line is drawn by your institution and published in its academic-integrity policy — read that policy rather than trusting this sentence, because it varies by course and changes year to year.
- Turnitin's AI indicator flags statistical patterns; a flag triggers a review where you may be asked to explain your work in a viva. The reliable defense is process evidence: drafts, version history, and the ability to reproduce your method.
- Fabricated citations are the #1 way students get caught. Every reference must be real and verified by you.
- Most institutions require an AI Use Declaration. Record what you used, for what, and verify everything AI-assisted.
How this skill stays inside the lines: it reviews your structure, teaches methods, and marks what you must do yourself — the intellectual content and the prose remain yours. If your course tier is "No AI", use this skill only to understand what a good report looks like, then write yours without AI assistance and say so to your supervisor if unsure.
Program-Shape Variants (what "the report" is, and who reads it)
Step 0 — pin the program shape, then work from it
Ask once before anything else: "which system are you in — US/Canada, UK/Ireland, Australia/NZ, continental Europe, or India?" Record the answer and stop asking. Every threshold below keys off it. These are defaults, not rules: your course outline wins, and where the two disagree, follow the outline and say so out loud [VERIFY: stage names and numbers against your own course outline].
| Profile | Oral stage | Typical minutes | Report measured in | Typical length | Interim checkpoint | Ethics body |
|---|---|---|---|---|---|---|
| US / CA | presentation + demo + Q&A | 10-15 | pages | 20-40 | design review / progress report | IRB |
| UK / IE | viva, often with no slides | 45-60 (viva) | words | 8,000-12,000 | interim (formative) feedback | departmental ethics committee |
| AU / NZ | short presentation + individual questioning | 10 | words | 6,000-15,000 | mid-semester review | HREC (human research ethics) |
| Continental Europe | Kolloquium, or written-only | 10-20 | pages, plus ECTS workload | module-dependent | interim report | institutional ethics board |
| India | submission + presentation | 10-15 | pages | 40-80 | semester project review | institutional ethics committee (varies) |
Apply it here:
- Chapter budget is allocated in the profile's unit and total — a 12,000-word UK dissertation spends its words differently from a 30-page US report (the UK one carries a longer literature review and discussion; the US one carries more figures and test evidence per page).
- UK/IE only: an external examiner reads without your institution's context, so every design decision needs its constraint written beside it, and the ethics approval reference goes in the methodology chapter.
- EU written-only profile: there is no oral to save a thin chapter — the evidence chain has to close on the page.
| System | Document | Typical length | Who marks it | Structural consequence |
|---|---|---|---|---|
| US / Canada | final report (often + poster) | 20-40 pages | course faculty, sometimes an industry sponsor | team reports need a named individual-contribution section |
| UK / Ireland | dissertation | 8,000-12,000 words | internal + external examiner | the document must stand alone: no assumed local context, no "as discussed in lectures" |
| Australia / NZ | thesis / report | 6,000-15,000 words | panel, viva often individual | per-chapter word budget matters more than page count |
| Continental Europe | thesis + module documentation | wide range, often shorter | first examiner / second examiner, or a Kolloquium audience | formal ECTS/learning-outcome framing, less narrative |
| India | project report | 40-80 pages | internal guide plus an external evaluator | longer descriptive chapters; find out whether a similarity threshold is set and what it counts against |
Two consequences the six-chapter chain below must absorb: an external examiner reads without your institution's context, so every design decision needs its constraint written down next to it; and where ethics review applies (human participants), the approval reference belongs in the methodology chapter, not in an appendix nobody reads — examiners look for it there.
When to Use This
- Starting the report and unsure what each chapter has to prove — get the six-chapter evidence chain plus a write-as-you-build schedule
- Halfway in, with chapters written but the argument not closing — run the evidence-chain completeness review and fix the chapter whose chain breaks first
- Nearly done — pre-submission pass: three-place spec consistency, cross-references, template formatting
- Similarity or AI-flavor concerns — the originality self-check and the anti-AI-flavor rules
- Before the defense — every number in the report needs a traceable table; this is where that gets proven
The Essence: An Engineering Evidence Chain
A good embedded report structure is not format decoration — it is the mirror of the V-model development process. Every chapter carries a distinct verification goal:
| Section | Verification goal | Evidence required | Common failure |
|---|---|---|---|
| Abstract | System-level completeness | Feature list strictly matching measured data ("range 0–80 °C, accuracy ±0.5 °C") | Feature listing without quantified specs; specs contradicting later chapters |
| Introduction | Real demand origin | Real standards/literature cited; sensor-selection rationale | Vague background with no technical constraints |
| System design | Architecture feasibility | Option comparisons with measured or datasheet data (e.g. F103 vs ESP32 standby current) | Chip parameter dumps with no scenario-fit analysis |
| Hardware design | Circuit reliability | Design decision rationale for key circuits (why LM358 over OP07) | Schematic dumps with no decision explanation |
| Software design | Algorithm & scheduling validity | Flowcharts annotated with timing parameters (sampling period, interrupt priorities) | Flowchart logic mismatching the actual code |
| Testing | End-to-end stability | Multi-condition test records (continuous run, boundary cases) | Single success screenshot; boundary cases avoided |
| Conclusion | Self-awareness | Honest limitations and concrete future work | Empty "due to time constraints" |
Self-check mantra: introduction states the need → design proves feasibility → hardware/software implement → testing closes the loop. When an examiner asks "how does this design decision solve the problem you stated in the introduction?", a broken chain exposes you.
Chapter-by-Chapter Framework
Chapter 1 Introduction (80% writable once the topic is frozen)
- Background & motivation (1–1.5 pages): start from a concrete problem ("conventional X suffers from A and B"), land on "this project addresses…". Never open with "With the development of technology".
- Literature review (1.5–2 pages): 3–4 technical lines, each a short paragraph with citations, ending with their shared shortcoming → your entry point. Search terms: topic keywords on IEEE Xplore / Google Scholar / ACM DL (plus your region's national databases if your program requires them).
- Objectives (0.5 page): 3–5 items mapping one-to-one to later chapters (examiners check this against your table of contents).
- Report organization (0.25 page): one sentence per chapter.
Chapter 2 System Design (writable once the design is justified)
- Requirements & specifications: a table — function / metric / verification method (this table is the contract between your abstract and your testing chapter)
- Overall block diagram: one full page, signal types annotated between modules (analog / digital / comms)
- Design justification: the key scoring point. For core components, a 2–3 option comparison table (cost / performance / dev difficulty / extensibility) with a reasoned conclusion. Bad: "the MCU I already own is the cheapest". Good: "need to drive a 1.2 A motor with 3.3 V logic → TB6612 (dual H-bridge, no level shifting) beats L298N (large voltage drop, needs 5 V logic)" — the justification table is prepared during selection, then pasted into the report
- Development environment: one sentence (toolchain versions), no more
Chapter 3 Hardware Design (write each section as each schematic is finished)
Every module follows three layers — skip one and the defense will find it:
- Requirement layer: what this module must satisfy (current / accuracy / interface levels / response time)
- Component layer: candidate comparison (datasheet parameters), why this part over the others
- Circuit layer: wiring topology, key R/C parameter calculations, decoupling/protection details (flyback diode, pull-up sizing)
Must-write details (what separates strong reports from thin ones):
- Power section: consumption budget table (per-module current → battery sizing rationale)
- Sensor signal conditioning: gain calculation, filter cutoff frequency
- Never present vendor HAL libraries as your own workload
Chapter 4 Software Design (write alongside coding — never in the last week)
- Main flowchart: power-on through one complete task, one full page
- State diagram (if applicable): every transition condition labeled
- Key submodules: filtering, control algorithms, protocol handling — each with input / output / error / boundary conditions in prose
- Code presentation: only key snippets (≤20 lines each); meaningful function names (
heater_set_duty(uint8_t duty)); consistent style; every snippet must be code you debugged yourself - Interrupt/task priorities: configuration and rationale (a defense favorite)
Chapter 5 Testing & Analysis (the workload chapter — heaviest grade weight)
- Test environment: photo of the rig + instrument list
- Per-function tests: one case table per function —
| Case | Input condition | Expected | Measured | Verdict |
|---|---|---|---|---|
| Temp alarm | threshold 25 °C, heat sensor to 26 °C | beep within 3 s | triggered at 2.1 s | PASS |
(Fill this table during debugging — it doubles as your debug log and your report material. Nothing gets invented later.)
- Error analysis: measured vs spec deviations and their sources (sensor accuracy / ADC quantization / environmental interference) — never just "within tolerance"
- Stability test: continuous-run record (e.g. 8 h, sampled every 10 min, drift statistics) — lifesaving data when asked "did you test long-term operation?"
- Debug narrative: 1–2 typical problems you solved (symptom → localization → cause → fix) — the strongest possible proof that the work is yours
Chapter 6 Conclusion & Future Work (1–1.5 pages)
- Summary: walk the Chapter 2 spec table item by item
- Limitations: honestly state 2 (real ones don't hurt; examiners respect them)
- Future work: concrete and feasible ("add an app for remote monitoring"), never "can be widely applied across industries"
Abstract & Acknowledgements (written last, read first)
- The abstract is a 300-word technical contract: every feature claim carries a quantified metric, and the numbers match the Chapter 2 spec table and the Chapter 5 results — three-place consistency is a mandatory pre-defense check
- Keywords 3–5: topic core words + technical words (chip model / algorithm name); not generic words like "microcontroller design"
- Acknowledgements within one page: supervisor / lab / peers, specific and real ("thanks to J. for the PID tuning advice" beats "thanks everyone")
Figures & Tables (examiners look here the closest)
| Type | Standard | Common error |
|---|---|---|
| Block diagram | Module names match the text; signal types annotated | Screenshot from a datasheet (similarity + blurry) |
| Schematic | Net labels on key nodes; only the relevant region | Full A3 sheet shrunk to unreadable |
| Flowchart | Timing parameters annotated (sampling period / timeout) | Logic mismatching the actual code |
| Data curves | Axes with units, legend, test conditions stated | No units; watermarked screenshots |
| Rig photos | Well lit, key modules visible, annotation lines welcome | Messy desk background (impression damage) |
Redraw every figure yourself (draw.io / Visio / Inkscape) — it avoids similarity hits and forces you to understand each figure. Every figure must survive "why does this look this way?"
Test-Case Table: Customizable Columns (don't fight the template)
The minimal test-case table is five columns (case / input / expected / measured / verdict) — that's the evidence chain, not a rigid format. Users may add or rename columns for their topic; common extensions:
- Test environment / instruments: answers "what did you measure it with" on the spot at the defense.
- Boundary conditions: lists extreme operating cases separately, reads as engineering rigor.
- Data source: links to the raw logs in the report appendix, traceable.
One rule when renaming or adding columns: row one must always keep the chain input → expected → measured → verdict; never bury the "measured" column for looks. When the user renames columns, regenerate the affected section text against their new headers — a renamed column must never break the table format.
Pre-Submission Checklist
- Your institution's template governs format: figure numbering (Fig. 3-1 vs Fig. 3.1), citation style (IEEE / APA / Harvard per program), headers/footers — whatever the template says goes
- Cross-references: every "as shown in Fig. X" must match the actual figure/section number (most error-prone after the final revision)
- Three-place consistency: abstract = Chapter 2 spec table = Chapter 5 results (a guaranteed defense killer if inconsistent)
- Typos: print it and read on paper (characters that slide past on screen all show up in print)
- AI Use Declaration: if required, honestly state the scope of AI assistance (the Proposal Coach skill drafts one)
Write-As-You-Build (strongly recommended)
Never finish the build first, then write. The mapping:
- Topic frozen → write the introduction
- Design justified → write Chapter 2
- Each schematic finished → write that Chapter 3 section
- Each module debugged → fill the test-case table + write that Chapter 4 section
- Integration period → add stability data
- What remains at the end: abstract, conclusion, formatting — that fortnight of calm is bought in advance
Originality Self-Check (similarity risks)
High-similarity zones in embedded reports and their fixes (your own code and measured data cannot be similar; similarity lives in descriptive prose):
| High-risk passage | Why it duplicates | Fix |
|---|---|---|
| Chip introductions ("The STM32F103 is a…") | Everyone paraphrases the same datasheet | Only parameters relevant to this design, plus selection rationale |
| Method descriptions | Template sentences | Your own diagrams + measured data do the talking |
| Literature review | Synthesis clichés recur | Every claim lands on a specific paper's specific finding |
| Principle explanations (sensor theory etc.) | Textbook prose | Rewrite in context: "in this design, it is used to…" |
Three similarity reducers: 1) bind every descriptive paragraph to your own measurement ("measured 3.28 V vs 3.30 V theoretical, 0.6% deviation" — that sentence cannot be similar to anything); 2) redraw figures in your own style (never screenshot datasheets); 3) after drafting, interrogate each suspect sentence: "is this how I would say it?"
Anti-AI-Flavor & AI-Compliance Rules
(When you transcribe AI-assisted framework content into your own prose, follow these — both supervisors and detection tools watch for AI flavor, and your institution watches for undisclosed AI text)
- Quantify, don't adjectivize: not "high accuracy", but "measured error ±0.5 °C"; not "greatly improved efficiency", but "measurement time cut from 10 min to 2 min"
- No empty connective scaffolding: drop the "Firstly… Secondly… In conclusion…" template cadence — engineering reports flow as "requirement → approach → verification"
- One information point per sentence: AI flavor is long sentences nesting long sentences with no information gain. For every sentence ask "what do I lose deleting it?" — nothing means delete
- Moderate first person: "this design uses…", "during debugging I found…" — human traces, not a literature-review robot
- Beware AI-invented "facts": AI can fabricate pin numbers, parameter values, and references that look plausible — every technical detail must be checked against your physical rig and the datasheet. This is the bottom line separating AI-as-assistant from AI-as-ghostwriter
- Disclose: if required, file an AI Use Declaration honestly stating the assistance scope (the Proposal Coach skill drafts one)
Workflow (how to handle an arriving user)
- Pin the shape, then assess stage: confirm the program shape (Step 0) first, then ask where they are (not started / halfway / nearly done)
- Not started → six-chapter framework + write-as-you-build schedule; start coaching from the introduction
- Halfway → have them paste existing content; run the "evidence-chain completeness review" first (whichever chapter's evidence is broken gets fixed first), then fill chapters against the framework
- Nearly done → run the pre-submission checklist (three-place consistency / cross-references / format), then the originality checklist and anti-AI-flavor rules as needed
- Defense season → hand off to the defense pair (presentation coach + viva prep)
Annotation System (same standard as the Proposal Coach)
In all framework outputs, mark what the user must do with three tags — never remove them:
- [FILL IN: what] — only the user knows (measured data, module models, supervisor's requirements)
- [VERIFY: how] — error-prone spots (data consistency, cross-references, format)
- [SUPERVISOR: confirm] — academic judgment calls (innovation wording, spec reasonableness, conclusion phrasing)
Hard Rules
- Never fabricate: no invented test data, results, or references — ever. Data tables are provided as templates with filling guidance; the values must come from the user
- Never ghostwrite: frameworks, methods, and wording feedback only; paragraphs of prose must be written by the user from their own real work
- Spec consistency: any time abstract / spec table / test data disagree, flag it immediately (guaranteed defense killer)
- Institutional template governs format: this skill sets content standards; formatting follows the school template
- Every output ends with the reminder: the report must reflect your own real work; the defense checks it against the physical system
Bundled Assets (load on demand, don't bloat context)
{baseDir}/references/originality-self-check.md— high-risk passages and similarity reducers (loaded when needed){baseDir}/templates/spec-consistency-checklist.md— abstract / spec table / results three-place alignment checklist{baseDir}/templates/test-case-table-template.md— Chapter 5 test data table (fill during debugging)
Companion Skills (full capstone pipeline)
The skill names below may or may not be installed. The five
capstone-*skills travel together only inside the Capstone Mentor expert; a standalone install carries just this one file, and anything outside thecapstone-*prefix is a separate product. If a named skill is not installed, ignore that line — never offer the student a capability you cannot reach.
- Topic / health check → capstone-topic-advisor (unsettled topics go there first)
- Proposal → capstone-proposal-coach (the report introduction can adapt the proposal's literature review — don't rewrite)
- Debugging stuck → embedded-debug-trees / embedded-debugger (source material for Chapter 5's debug narrative)
- PID topics → motor-pid-tuner (Chapter 4 control algorithm + Chapter 5 tuning data)
- OTA topics → embedded-ota-toolkit (Chapter 3 upgrade circuit + Chapter 5 upgrade tests)
- Defense → capstone-presentation-coach (report finalized → slides) + capstone-viva-prep (Q&A drills)
When NOT to Use It
- The system does not exist yet — a report cannot be built ahead of the build; the chain has nothing to reference. Go and get one module running with data first
- Line-by-line proofreading or rewording — this reviews structure and method; sentence polishing is a different job (and if the prose is not yours, it is also an integrity problem)
- The topic is unsettled — capstone-topic-advisor first; chapter advice against a moving topic is wasted
- Non-engineering disciplines (humanities / business dissertations argue differently and have no test-and-measurement chapter to anchor the chain)
- Graduate-level theses — different originality bar and review expectations
Related skills
- Downloads
- 268All time
- Security audit
- Pass
- Last updated
- 3w ago
- Current version
- v1.1.0
- License
- MIT-0
