This project designs and supplies everything you need to build your own set of home audio speakers. It's not one file β it's a small workspace at /home/mike/speaker-build holding a team of four specialist helpers, the one shared "brain" the whole design lives in, and a set of PDFs and tools for cutting wood.
The current plan is a stereo pair of 2-way bookshelf speakers β one woofer + one tweeter in each 11.5"Γ9.5"Γ12" ported cabinet, ~$300 for both, built from a single sheet of MDF.
Four role-defined helpers write their findings into the shared spec. Each owns one slice of the design:
Chooses drivers, sets the tonal goal and crossover points. Answers: "what makes good sound?"
Box volume, port tuning, panel cut list, driver placement. Answers: "what wood, cut how?"
Exact capacitor/inductor/resistor values, wiring, safe amp load. Answers: "what parts connect what?"
Checks every part is for sale today, builds the priced Bill of Materials, guards your budget.
Their full job briefs live in the team/ folder. You don't need to read them to use this β just know each decision is double-checked by the role that owns it.
| File | What it is for | Open when⦠|
|---|---|---|
hub.html | The control room β one card per specialist with one-click "brief" buttons | You want to talk to the team or run work |
design-studio.html | Plain form editor for every spec value | You want to change numbers quickly |
design-studio-visual.html | Visual editor β drawing updates as you type, plus idea photos | You're exploring sizes or a new design |
shopping_list.html | Everything to buy with links & prices | Ordering parts |
build_guide.html | Panel cut list, sheet layout, 9-step assembly | Cutting & gluing wood |
build_checklist.html | Unbox β bench checklist pairing parts to steps | Parts arrive / at the workbench |
reports/baffle_template.pdf | Full-size 1:1 drilling templates (front + back) | Marking hole positions on the wood |
reports/build_report.html | Combined report from all team sections | You want the whole spec in one read |
state/spec.md | The shared brain β every decision and all sections | Nothing direct β it's what the team writes to |
tools/ | The engine β report generator + template generator | Regenerating outputs after a change |
The project follows a fixed order so later steps never contradict earlier ones:
Each specialist writes only its own section of the shared spec β that's how the report stays consistent without anyone overwriting each other.
Use the visual Design Studio (design-studio-visual.html) when you're thinking about how it looks, or the form Studio (design-studio.html) when you only need to change a number.
spec.md, rebuild the report, and regenerate the drilling templates at your new size.localStorage) and lets you export. To actually save into the spec, run the save from inside the Hermes chat (or paste the exported text back to me).baffle_template.pdf β it's 8 pages: 4 for the front baffle, 4 for the back.The full 9-step version with the sheet-layout diagram is in build_guide.html.
| Term | Plain meaning |
|---|---|
| 2-way | Two drivers per speaker: a woofer (bass/mid) and a tweeter (treble). |
| Bass-reflex / ported | A box with a tuned tube (port) that reinforces the bass so a small box can go low. |
| Sealed | A closed box, no port. Tighter bass, less depth, needs more power. |
| Crossover | A small circuit that sends bass to the woofer and treble to the tweeter. |
| Cutout Γ | The diameter of the hole you cut for a driver. Bigger than the flange screws to. Your template marks exactly this. |
| Tuning (Hz) | The bass frequency the port resonates at; ~45 Hz is a good bookshelf target. |
| F3 | The low end where bass starts rolling off; lower F3 = deeper bass. |
| BOM | Bill of Materials β the full shopping list with prices. |
| Impedance (Ξ©) | The electrical "load" a speaker puts on the amp; 8 Ξ© is a safe, common value. |
| Sensitivity (dB) | How loud the speaker is on a watt; higher = louder/easier to drive. |
| localStorage | Your browser's built-in note pad β Design Studio saves edits there. |