> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Folder Organization

<Tip>
  Over half of the cases above use "read from local folder." **Organizing folders and selecting them as your working folder** is how you get the most from QoderWork.
</Tip>

This section walks through folder organization using a teacher managing class exam scores.

### Why "Work in a Folder" Matters

QoderWork lets you pick a local folder via **Work in a Folder**. Once selected:

* QoderWork can read all files in that folder without manual uploads
* Outputs are saved back to that folder
* New files you add are picked up automatically

**Put files in the right place; QoderWork handles the rest.**

### 3 Steps to Get Started

<Steps>
  <Step title="Organize a folder on your computer">
    Put files for one task or topic in a single folder. Use clear names and consistent naming.
  </Step>

  <Step title="Select it in QoderWork">
    Create a task, click **Work in a Folder** below the chat, and select that folder. QoderWork can then access everything inside.
  </Step>

  <Step title="Describe what you want in plain language">
    No code or paths needed. Describe the task; QoderWork will find and process the right files.
  </Step>
</Steps>

### Complete Example: Teacher Managing Class Exam Scores

**Scenario**

Ms. Johnson teaches middle-school math. After each exam she gets an Excel score sheet. By semester end she has four exams. She wants to see: who’s improving, who needs attention, and how the class is trending.

<Steps>
  <Step title="Organize the folder">
    She creates `Class-3B-Math-Scores` on her desktop and adds each exam:

    ```plaintext theme={null}
    Desktop/Class-3B-Math-Scores/
    ├── First-Monthly-Exam.xlsx
    ├── Midterm-Exam.xlsx
    ├── Second-Monthly-Exam.xlsx
    └── Final-Exam.xlsx
    ```

    <Tip>
      Include exam name or date in filenames (e.g., `2024-03-Monthly-Exam.xlsx`) so QoderWork can order them by time.
    </Tip>
  </Step>

  <Step title="Select your folder">
    In QoderWork, click **Work in a Folder** and select `Class-3B-Math-Scores`.
  </Step>

  <Step title="Ask QoderWork to analyze">
    In the chat:

    ```plaintext theme={null}
    Read all exam score files in this folder and:
    1. For each exam: class average, high, low, pass rate
    2. Per-student trend across exams
    3. Top 5 most improved and top 5 declining
    4. Create a visual class analysis report
    5. Suggest which students need attention
    ```

    QoderWork reads the Excel files, runs the analysis, and saves the report in the folder.
  </Step>
</Steps>

**Ongoing Use**

After the next exam:

1. Add the new score file to the same folder
2. Open QoderWork (same folder selected)
3. Say: "New exam scores added. Update the analysis report."

Takes under 5 minutes. Over time, QoderWork can spot patterns (e.g., a student slipping from exam 3 onward) for early intervention.

### Same Approach, More Scenarios

The pattern **organize folder → select it via Work in a Folder → describe in natural language** works for many recurring file tasks:

| Role       | Folder structure     | Example prompt                                               |
| ---------- | -------------------- | ------------------------------------------------------------ |
| Teacher    | Scores by class/term | "Analyze all exams and flag students who need attention"     |
| Sales      | Reports by month     | "Compare last 3 months and find fastest-growing products"    |
| Finance    | Receipts by month    | "Sum this quarter's expenses by category"                    |
| Lawyer     | Documents by case    | "Review all contracts and list risk clauses"                 |
| Ops        | Exports by channel   | "Merge all channel data and produce ROI report"              |
| Trade      | Orders by shipment   | "Read all orders and create customs summary"                 |
| Researcher | Papers by project    | "Summarize main points from all papers and write lit review" |

### Folder Management Tips

* **Naming**: Use dates or sequence (e.g., `2024-03-Monthly-Exam.xlsx`, `01-First-Exam.xlsx`) so QoderWork can infer order.
* **One task per folder**: Don’t mix unrelated files. Separate math and English scores for clearer analysis.
* **Consistent format**: Use the same template for similar files (e.g., same Excel columns). QoderWork aligns data more reliably.
* **Subfolders**: For many files, group by time or category. QoderWork can read recursively.
* **Build history**: More data in the folder improves analysis. Get into the habit of saving files in the right place.

### Start Your First Case

<Steps>
  <Step title="Organize a folder">
    Pick a recurring task (e.g., monthly reports, exam scores) and put related files in one folder.
  </Step>

  <Step title="Select your folder">
    Create a task, click **Work in a Folder**, and select that folder.
  </Step>

  <Step title="Use a case as a template">
    Copy a prompt from the cases above and adapt it to your situation.
  </Step>

  <Step title="Iterate">
    First run may not be perfect. Adjust the prompt and refine your template.
  </Step>

  <Step title="Package as Skill (optional)">
    When a flow works well and you use it often, consider packaging it as a Skill for you or your team.
  </Step>
</Steps>

<Note>
  All cases above come from real user feedback and show how QoderWork is used in practice. You can copy and adapt the prompts for your own workflows.
</Note>

## Next Steps

<CardGroup cols={3}>
  <Card title="Viewing Results" icon="folder-open" href="/qoderwork/file-management">
    View and organize AI-generated artifact files
  </Card>

  <Card title="Use Cases" icon="lightbulb" href="/qoderwork/use-cases">
    Ready-to-use prompt templates organized by scenario
  </Card>

  <Card title="User Stories" icon="users" href="/qoderwork/user-stories">
    See how other QoFounders use QoderWork in real workflows
  </Card>
</CardGroup>