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

# Roadmap

> Plan large features and migrations with a Roadmap of Initiatives and Milestones.

Plan major initiatives and large features with your app's **Roadmap**.

<div className="screenshot ocean">
  <img src="https://mintcdn.com/zeus-0f6dadbf/i5jQeGeipSWnAIox/images/apps/roadmap-overview.png?fit=max&auto=format&n=i5jQeGeipSWnAIox&q=85&s=aa565330206ed71a98e7245ab17ebbdc" alt="Build a CRM Initiative with seven Milestones in completed, in progress, and not started statuses" width="850" height="768" data-path="images/apps/roadmap-overview.png" />
</div>

### What are Initiatives?

An Initiative is major, high-level goal that takes multiple steps to accomplish. Hercules creates Initiatives when you first start building a new app, when you use [Plan mode](/ai/agent-modes), or when you want to make major changes to your app. Initiatives contain Milestones.

Examples might include *"Build a CRM"*, *"Redesign the app so it's mobile-first"*, *"Internationalize my app"*

### What are Milestones?

A Milestone is a single feature that Hercules can accurately build in one turn. Milestones are almost always build functionality that is testable at the end of implementation.

Examples might include *"Add comment and likes"*, *"Build checkout page"*, *"Add admin dashboard"*

### Can I edit the roadmap?

Yes. Use the **Roadmap** tab to add/edit/delete Milestones and Initiatives. You can also ask [Hercules](/ai/how-it-works) in chat, for example "add a milestone for invoicing".

### How do I get Hercules to build a Milestones?

We recommend you click **Continue** in the Milestone upsell at the top of your chat input.

If you want to build a specific milestone can also click "Show All Milestones" in the upsell and click "Build it". You can also just ask Hercules any time.

<div className="screenshot fire">
  <img src="https://mintcdn.com/zeus-0f6dadbf/i5jQeGeipSWnAIox/images/apps/roadmap-progress-banner.png?fit=max&auto=format&n=i5jQeGeipSWnAIox&q=85&s=463f0f7269a095def0727168515317c3" alt="In progress milestone banner with Continue button" width="716" height="160" data-path="images/apps/roadmap-progress-banner.png" />
</div>

### Additional FAQ

<AccordionGroup>
  <Accordion title="Why does Hercules build one milestone at a time?">
    Stopping between Milestones lets you test, give feedback, and fix issues before moving on. This
    avoids stacking errors across Milestones and ultimately saves you money.

    We are launching the ability for you to run multiple Milestones at once very soon.
  </Accordion>

  <Accordion title="Does Plan mode create an initiative?">
    Yes. [Plan mode](/ai/agent-modes) interviews you, drafts the Initiative and Milestones, and
    confirms with you before any code is written.
  </Accordion>

  <Accordion title="What are product & design notes?">
    Short descriptions that capture product requirements, UX preferences, and any other important considersations or constraints. Hercules
    reads them every time it builds a Milestone in that Initiative. We strongly recommend keeping them minimal.

    <div className="screenshot floss">
      <img src="https://mintcdn.com/zeus-0f6dadbf/i5jQeGeipSWnAIox/images/apps/roadmap-product-design-notes.png?fit=max&auto=format&n=i5jQeGeipSWnAIox&q=85&s=c03549fc92b67d5db7ea26d2310a0492" alt="Screenshot of adding product and design notes in roadmap" width="944" height="398" data-path="images/apps/roadmap-product-design-notes.png" />
    </div>
  </Accordion>

  <Accordion title="What are engineering notes?">
    Short descriptions that capture non-obvious technical details like key files, data models, backend routes, system design, or implementation details.
    Hercules usually only creates these in [Plan Mode](/ai/agent-modes).
  </Accordion>

  <Accordion title="How do I change a milestone's status?">
    Set the Milestone to **Not started**, **In progress**, **On hold**, **Completed**, or
    **Cancelled**. You can also ask Hercules in chat, for example "mark the dashboard milestone as
    completed".
  </Accordion>

  <Accordion title="How does Hercules AI show Initiatives and Milestones inside the chat?">
    Newly created and recently edited initiatives show like this.

    <div className="screenshot peach">
      <img src="https://mintcdn.com/zeus-0f6dadbf/i5jQeGeipSWnAIox/images/apps/roadmap-plan.png?fit=max&auto=format&n=i5jQeGeipSWnAIox&q=85&s=5ea7ac5cc8cc74ceba16e5514c2990ad" alt="An initiative with 7 milestones for a wholesale CRM" width="996" height="850" data-path="images/apps/roadmap-plan.png" />
    </div>

    Milestones that are updated to in progress status show like this

    <div className="screenshot mint">
      <img src="https://mintcdn.com/zeus-0f6dadbf/i5jQeGeipSWnAIox/images/apps/roadmap-milestone-in-progress.png?fit=max&auto=format&n=i5jQeGeipSWnAIox&q=85&s=58a22450cca00222b4804bb11687e4ab" alt="In progress milestone status indicator" width="530" height="70" data-path="images/apps/roadmap-milestone-in-progress.png" />
    </div>

    Milestones that are updated to completed status

    <div className="screenshot floss">
      <img src="https://mintcdn.com/zeus-0f6dadbf/i5jQeGeipSWnAIox/images/apps/roadmap-milestone-completed.png?fit=max&auto=format&n=i5jQeGeipSWnAIox&q=85&s=e3e33e6435ee99c97fbf5c0b56fb36e2" alt="Completed milestone status indicator" width="568" height="70" data-path="images/apps/roadmap-milestone-completed.png" />
    </div>
  </Accordion>

  <Accordion title="How do I change an initiative's status?">
    Set the Initiative to **Draft**, **Approved**, **In progress**, **On hold**, **Completed**, or
    **Cancelled**. The status also updates automatically based on its Milestones (for example, it
    moves to **Completed** when all Milestones are completed or cancelled).
  </Accordion>
</AccordionGroup>