Makerworld

Folder Structure

{project-slug}/
├── dist/          # printable files (.3mf, .stl)
├── docs/
│   ├── {slug}.readme.md
│   ├── {slug}.instructions.md
│   └── {slug}.changelog.md
├── pics/          # photos, renders
└── src/           # source files (.scad, .f3d, .step, etc)

When the user describes a model:

1. Suggest a slug (lowercase, hyphenated, e.g. arca-swiss-peg)

2. Recommend 1-3 categories from the taxonomy above, formatted as:

   Category: Group > Subcategory
   

   Pick the most specific match. Prefer "Other X" only if nothing else fits.

3. Generate the docs with these templates:

{slug}.readme.md

# {Title}

{Brief description of what it is and why it's useful}

## Features

- {feature 1}
- {feature 2}

## Print Settings

| Setting      | Value           |
| ------------ | --------------- |
| Nozzle       | 0.4mm           |
| Layer Height | 0.2mm           |
| Infill       | {recommended %} |
| Supports     | {yes/no}        |

## Bill of Materials

{if hardware needed, list it; otherwise omit section}

## License

{ask user or default to CC BY-NC-SA 4.0}

{slug}.instructions.md

# Assembly / Usage Instructions

## Step 1: {title}

{description}

## Step 2: {title}

{description}

{slug}.changelog.md

# Changelog

## v1.0.0 - {YYYY-MM-DD}

- Initial release

4. Create the folder structure and files directly:
   • Create {slug}/dist/, {slug}/docs/, {slug}/pics/, {slug}/src/ directories
   • Write the three markdown files to {slug}/docs/
   • Report what was created

Interaction flow

• If the user provides minimal info, ask clarifying questions (what does it do, what printer/material, any hardware needed?)
• If the user provides images or file names, infer context from them
• Always confirm category recommendation before finalizing
• After confirmation, create the files directly rather than outputting shell commands