# Project

Project bundles agents and steps to carry out work. On each step you decide how much to delegate to an agent. **In a workflow**, adding a step where a person decides stops the work there for review. What a run did can be traced afterwards, one run at a time.

**If you are working out how to fit it into the work**, start from [“What to settle for the work” in the Design Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/design-guide.md#what-to-settle-for-the-work); **if you are revisiting work that is already running**, start from [“Revisiting it from the track record” in the Record Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/record-guide.md#revisiting-it-from-the-track-record).

[How it works](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/concepts/project-and-steps.md)

### [Understand the mechanics](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/concepts/project-and-steps.md)

[Learn what happens inside before you configure anything.](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/concepts/project-and-steps.md)

[→](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/concepts/project-and-steps.md)

[Quickstart](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/quickstart/workflow.md)

### [Run something small](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/quickstart/workflow.md)

[Try out what you have read.](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/quickstart/workflow.md)

[→](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/quickstart/workflow.md)

[Guides](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/design-guide.md)

### [Configure it for your work](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/design-guide.md)

[The criteria for deciding which option to take.](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/design-guide.md)

[→](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/design-guide.md)

[References](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/reference/settings-ref.md)

### [Look things up](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/reference/settings-ref.md)

[Limits, defaults, and the wording used on screen.](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/reference/settings-ref.md)

[→](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/reference/settings-ref.md)

## How a project is built

A project has steps, and you place agents on those steps (some steps hold no agent: a review step, an external automation and a branch). You give an agent a goal (instructions) for what to do and guardrails for what it must not do, and you attach playbooks and skills. A step where a person decides holds no agent: a reviewer looks at the output of the preceding step and decides. Each run leaves a run record of what it did.

| Term                        | Meaning                                                                                                                                                                                                                                                                       |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Project**                 | The unit that groups steps and agents. Can be classified with tags                                                                                                                                                                                                            |
| **Step**                    | Where you place an agent. One step can hold several. A review step, an external automation step and a branch step hold none                                                                                                                                                   |
| **Agent**                   | The worker. A goal (instructions) and guardrails define how it behaves, and playbooks and skills are attached to it. Reusable across steps and projects                                                                                                                       |
| **Playbook**                | The procedure you can attach to an agent, at most one. It sets out the steps of work you repeat, each with its purpose, guidance and success criteria. The agent adjusts the steps to suit the request                                                                        |
| **Skill**                   | A way of carrying out one particular piece of work. An agent can have several. You register a document describing the method, together with scripts or other files if it needs them                                                                                           |
| **Placement**               | Each single agent placed on a step. Place the same agent on two steps and you have two placements. In a cycle the schedule is set at this level too                                                                                                                           |
| **Review step**             | A step where a person decides. A reviewer looks at the output of the preceding step and chooses one of three: advance to the next step, send it back, or reject it (when advancing, the output can also be edited). The request that reaches the reviewer is a review request |
| **Run record**              | The detail of a single run. It traces the request, the evidence, what was done, the confirmation and the result. The list of runs is the “Execution history”; the record of operations inside a project is “Records (audit trail)”                                            |
| **Execution rules**         | The setting that decides which operations an agent may perform. A project inherits the execution rules set for the whole tenant and can only tighten them                                                                                                                     |
| **Ledger**                  | A connector the project's agents read from and write to as a shared record. You designate one by marking a connector “Use as ledger”. Marking it does nothing on its own: what is read and written there, and how, is settled by each agent's goal (instructions)             |
| **Connection confirmation** | A review request raised when a connector has “Confirm before connecting” set: the run stops before an agent uses that connector. On approval, it starts again. It works in both workflows and cycles                                                                          |

One more word comes up when you create an agent: **Claw**. A Claw is tied to a conversation and runs on a schedule you set. It is not something you use in a project — it appears **only as something to copy an agent's contents from**. Only the contents are copied; triggers such as the time are not carried over.

## The two types

You choose the type when you create a project. **It cannot be changed afterwards.**

|                               | Cycle                                                                                                                                       | Workflow                                                                                                                                                                                                          |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **How it starts**             | Each placed agent runs on a schedule you set for it. A webhook or email can also start it                                                   | You start it manually. It can also start at a set time, from the external API or by email. When it starts at a set time, you can choose which step it starts from                                                 |
| **How it progresses**         | Agents do not wait for each other. Each runs on its own schedule                                                                            | One run advances through the steps. A step begins after the previous one finishes. It can also divide into lanes partway and go forward in them at the same time, or pick the lane to pass through by a condition |
| **How it ends**               | It does not end. It keeps running until you stop it                                                                                         | Each run ends — Done, Rejected, Failed or Cancelled                                                                                                                                                               |
| **Examples of work it suits** | Picking up incoming requests and giving a first response. Checking the state at a set interval and raising an alert when something is wrong | Taking one application, doing the work, and finishing it through a reviewer. Running once at month end to produce a report                                                                                        |

## How you use it

1

### Choose the work

Decide what to hand over, what counts as done, and where the results go.

2

### Decide what to connect to

Add the external services this project uses, and authenticate them.

3

### Decide how much to delegate

Lay out the steps, place the agents, and decide which operations are allowed.

4

### Use it with review

In a workflow, a person decides at a review step and moves it on.

5

### Revisit with the record

Look at the track record, and revisit what to fix and how reviews are set.

Where to read at each stage.

- **Choose the work** — how much to hand over, what counts as done, where to divide projects, and where the results go ([Design Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/design-guide.md#what-to-settle-for-the-work))
- **Decide what to connect to** — [Connection Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/connection-guide.md)
- **Decide how much to delegate** — type, steps and agents ([Design Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/design-guide.md)), which operations are allowed ([Execution Rules Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/control-guide.md)), how it starts ([Trigger Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/trigger-guide.md))
- **Use it with review** — where people decide ([Review Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/review-guide.md)), who looks where ([Record Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/record-guide.md#where-to-look)), clearing what needs a person ([Record Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/record-guide.md#clearing-what-needs-a-person-action-needed)), how to stop it ([Trigger Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/trigger-guide.md#stopping-and-resuming))
- **Revisit with the record** — read the track record, choose what to fix, try it before applying, and compare against when the work is done ([Record Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/record-guide.md#revisiting-it-from-the-track-record))

## Where things are in the UI

A project has a row of tabs. “Workflow history” is for workflows only, so a workflow has six and a cycle has five.

| Tab                   | What you see                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Overview**          | From the top: “Project overview” (a description of what the work does, written by AI from the purpose, steps and Agent settings, or the project description when it cannot be written; not shown when there is neither), “Results of this work” for the period you choose (a sentence on the results, metrics (KPI), runs per day and more), the diagram of the steps and agents (“Workflow shape”, where the right-hand column switches between “Basic info”, “Metrics” and “Latest artifacts” for each step; “Latest artifacts” is not shown to people who open the project only through the organization operations role), for a cycle the band of the last 24 hours for each agent, and at the bottom “Project info” (a one-line summary; “Show All” opens all of it). See the workflow runs in progress under Workflow history. The basics, such as the purpose and members, and the settings for Launch, Connectors (MCP, A2A), Registered Agents, Human review, Execution rules, Notifications and Records and access open with “Show All” under “Project info” |
| **Execution history** | The list of runs. Opening one shows its run record. The record of operations inside the project (Records (audit trail)) is here too                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Workflow history**  | Recent workflow runs, including finished ones                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Action needed**     | What needs a person (awaiting approval, overdue, failed, awaiting rework, sweep failed, run past its deadline, stalled). You can approve the rows you select, extend their deadlines and so on, in one go                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Library**           | Files shared in the project. Versions are kept, and the files can be handed to the agents on the steps                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Settings**          | Basic information, Triggers and notifications, Connectors (MCP, A2A), Members and Execution rules                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

Steps and agents are edited in a separate editor screen, not in the tabs. An owner sees “Edit” at the top of the project screen.

The “**Glossary**”, which explains the words on screen one sentence each, opens from the project list when nothing is listed under “My Projects” (except while a search term is entered), from beside the “Basic information” heading on the Settings tab, and from beside the description line on “Home”. The “**Getting started**” card, which sets out the first steps, appears on the list in the same case, when nothing is listed under “My Projects”, on “Home” when there are no projects, and on the Overview of a project created within the last 7 days with no runs in the selected period (once closed, it no longer appears in that browser).

**Projects can also be used through the external API** ([external API documentation](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/api/agent/reference/api-reference-projects.md)).

## Use It from an AI Client

Install the AGENTIC STAR plugin in Claude Code, Codex, or Claude, and you can work with projects just by asking. For example:

- "Create a workflow that drafts an internal announcement every morning at 9:00 and ends after I review it"
- "Find out why recent runs did not go well, and fix them"
- "Go through this morning's approval requests for me, checking what each contains"
- "Show me the success rate of each project for the last 30 days"

For how to install the plugin and connect, see [AI Client Connection Guide (MCP) — Install the Plugin](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/api/agent/guide/ai-client-guide.md#plugin). The AI can only do what the connected account or system integration is allowed to do.

## How it works

What the screens do not tell you is collected here. Read this before you start configuring.

- [**Projects and steps**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/concepts/project-and-steps.md) — a step is where you place an agent. A review step holds no agent. A playbook is the procedure and a skill is the method; both belong to the agent
- [**Cycle and workflow**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/concepts/cycle-and-workflow.md) — in a cycle each placement runs independently. The type cannot be changed afterwards
- [**Who decides what**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/concepts/roles.md) — roles in the admin console and project roles are different things. Even an owner cannot decide a review unless they are named as a reviewer or are a reviewer's delegate (only a review request raised from an agent's result and a connection confirmation have, as a rule, every owner as their reviewers)
- [**Human review**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/concepts/human-review.md) — a review step decides whether the work moves on. It is not a mechanism for stopping an agent mid-run
- [**How much to delegate**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/concepts/delegation.md) — execution rules can only tighten, never loosen. Where they apply, and where your own responsibility begins
- [**Records and metrics**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/concepts/records-and-metrics.md) — read a run record through five questions. The agent completion rate is not a measure of business outcome

## Quickstart

[Finish one at a time](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/quickstart/workflow.md)

### [Workflow](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/quickstart/workflow.md)

[Create the steps, set the reviewers, and run your first workflow.](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/quickstart/workflow.md)

[→](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/quickstart/workflow.md)

[Keep it running](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/quickstart/cycle.md)

### [Cycle](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/quickstart/cycle.md)

[Place agents on steps, set the schedule they run on, and get the first sweep going.](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/quickstart/cycle.md)

[→](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/quickstart/cycle.md)

## Guides

- [**Design Guide**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/design-guide.md) — what to settle for the work, how to divide it, and how much to delegate to each step and agent
- [**Execution Rules Guide**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/control-guide.md) — which operations an agent may perform. How the global basic rules are inherited, and how to write forbidden operations
- [**Review Guide**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/review-guide.md) — who decides, and where. How reviewers are chosen, and what happens when the deadline passes
- [**Trigger Guide**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/trigger-guide.md) — when it runs and how to stop it. Choosing between a set time, a per-agent schedule, a call from outside, and manual
- [**Connection Guide**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/connection-guide.md) — what to connect to, and where to notify
- [**Record Guide**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/record-guide.md) — how to read the results, and what to revisit from the track record

## References

- [**Settings Reference**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/reference/settings-ref.md) — the fixed values: number of steps, number of skills, deadlines, how to write times
- [**Run Results Reference**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/reference/results-ref.md) — what each displayed result means, and the formula for the agent completion rate
- [**Records Reference**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/reference/events-ref.md) — the events that are recorded, the CSV columns, and what an export contains
- [**Glossary**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/reference/glossary.md) — how the words on screen map to the words in records and settings
- [**Roles Reference**](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/reference/roles-ref.md) — what owners, operators, members, the organization operations role, organization admins and system administrators can each do
