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

# Building blocks

> The parts of Iron Octopus and how they fit together.

Everything in Iron Octopus is built from a few parts that nest inside each other. A workspace holds your projects. Each project is one app. Inside a project, features are the changes you ask for, and each feature is made of work items and defined by its requirements.

## How they fit together

```mermaid theme={null}
flowchart TD
  W[Workspace] --> P[Project]
  P --> A[Architecture]
  P --> I[Initiative]
  P --> F[Feature]
  I --> F
  F --> R[Requirements]
  F --> WI[Work items]
  P --> D[Defect report]
  D -. becomes a fix .-> F
```

## The building blocks

> **[Workspace](https://docs.ironoctopus.ai/building-blocks/workspaces.md)**
>
> Your company's account: its members, projects and billing.

> **[Project](https://docs.ironoctopus.ai/building-blocks/projects.md)**
>
> One app: its code, architecture, rules and work.

> **[Initiative](https://docs.ironoctopus.ai/building-blocks/initiatives.md)**
>
> A larger goal that Iron Octopus plans as several features.

> **[Feature](https://docs.ironoctopus.ai/building-blocks/features.md)**
>
> One change to your app, from its plan to its release.

> **[Requirement](https://docs.ironoctopus.ai/building-blocks/requirements.md)**
>
> What done means for a feature. Each one is verified.

> **[Work item](https://docs.ironoctopus.ai/building-blocks/work-items.md)**
>
> One piece of the work inside a feature, built and reviewed on its own.

> **[Defect report](https://docs.ironoctopus.ai/building-blocks/defect-reports.md)**
>
> A problem you found, and the fix that follows.

> **Architecture**
>
> The blueprint for your app that every feature is planned to fit.

## How work flows through them

1. You describe an idea in a project.
2. Iron Octopus plans it. A small idea becomes one feature. A larger one becomes an initiative with several features.
3. Each feature gets requirements that define done, and work items that make up the work.
4. Iron Octopus builds and reviews the work items, verifies the requirements, and the feature is released.
5. If you find a problem later, a defect report turns it into a fix, which is a new feature that goes through the same steps.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.