3Docs

Studio · Get started

How a request gets done

Follow one request, supplier scoring and tiers, from idea to release. See how the agent team moves it forward, where people make the key decisions, and what evidence they have when they do.

The purchasing team has a Supplier Management project in Studio, and the app is built on NocoBase Core. Zhou Hang, the purchasing lead, doesn't write code. This time purchasing wants to tier its suppliers, so Zhou Hang raises this request:

Score suppliers on on-time delivery, quality pass rate, and price, and sort them into tiers A, B, and C. Orders to tier C suppliers need the purchasing manager's approval before they go out.

  1. RaiseZhou HangMy agent

    Explains the tier rules in business terms and answers the agent's questions. The agent writes them up as an issue with acceptance scenarios.

  2. AssignCoordinator agent

    Asks an agent that is good at design for a plan first, then hands development to an agent that is good at building features.

  3. AnswerZhou Hang

    The plan turns up an existing approval rule, and Zhou Hang decides whether small orders from tier C suppliers need approval.

  4. BuildWorker agent

    Builds on Core in the issue's own branch, writes tests, and opens a PR.

  5. Check and reviewRepository CIWorker agent

    CI runs the checks and tests, then a model from another vendor reviews the code.

  6. AcceptZhou Hang

    Reads the delivery report, acceptance criteria, and screenshots, tries it in the preview, and merges.

  7. ReleaseProject lead

    Once merged, it goes to staging. Production needs a person's approval, and you can roll back if something goes wrong.

  8. RememberWorker agent

    Writes what it learned into project memory, which agents read before the next job.

Raise

Zhou Hang opens My sessions and talks it over with their own agent. The agent first looks at the existing supplier module, then asks two questions: how much does each of the three measures count toward the score, and which tier does a new supplier with no order history get? Zhou Hang settles both on the spot. On-time delivery and pass rate count 40% each and price 20%, and new suppliers start at tier B and are re-tiered by score after three months.

The agent writes these rules into the issue description and acceptance scenarios and adds the issue to the Supplier Management project. Zhou Hang clicks Start 1 issue, and the issue moves to In progress.

My sessionsSupplier tiersMy sessionsRunner Agent
Suppliers should be scored on on-time delivery, quality pass rate, and price, and sorted into tiers A, B, and C. Orders to tier C suppliers need purchasing manager approval. Look at the existing supplier module first, then create an issue.
CC

Claude Code · Zhou Hang’s MacBook · 10:08

I’ve had a look. Supplier data lives in the suppliers table, and order approval can use the platform’s approval workflow. Two things to settle before I create the issue: how much does each of the three measures count toward the score, and which tier does a new supplier with no order history get?

On-time delivery and pass rate count 40% each, price 20%. New suppliers start at tier B and are re-tiered by score after three months.
CC

Claude Code · Zhou Hang’s MacBook · 10:12

Got it. I’ve put the scoring rules and acceptance scenarios into one issue in the Supplier Management project:

Issues 1Not nowStart 1 issue
Supplier scoring and tiersPUR-23· Supplier Management · Backlog
Reply, or say what is next… use # to mention an issue
Zhou Hang’s MacBookCCClaude Code~/code/supplier
Zhou Hang talks the request through with their agent, which creates the issue once the rules are settled

Zhou Hang owns the issue, and the coordinator agent is the executor. The session keeps the issue and its progress attached, so Zhou Hang can come back any time and ask how it's going.

Zhou Hang could also skip the conversation and click New issue to fill one in directly. See Make a request.

Assign

The coordinator agent reads the issue description, the Purchase Approval Policy in the knowledge base, and the project's skills. The change touches the data structure and approvals, so instead of going straight to development, it first asks an agent that is good at design for a short plan.

PUR-23· Supplier ManagementIn progressFollowAsk agent
Activity 4DescriptionSub-issuesCode and deploysRuns 2
ZZhou Hang changed the status from Backlog to In progress
CA
Coordinator agentHandoff

@Claude · Opus 5.5 write a short plan: where the score field lives, how tiers are calculated, and which workflow the tier C order approval hooks into.

  • Read: the issue description, the knowledge base article “Purchase approval policy”, project skills
  • Done when: the plan is posted as a reply, listing questions for the issue owner to confirm
  • Why: the change touches the data structure and approvals, so settle the plan before building
CC
Claude · Opus 5.5

The plan is ready: add score and tier fields, recalculate tiers every night by the rules, and route tier C orders through the platform’s approval workflow. To confirm: the Purchase Approval Policy requires the purchasing manager’s approval only for orders above ¥50,000, and the request doesn’t say whether small orders from tier C suppliers need approval.

The coordinator agent hands out a step and says what to do, what to read, and when it counts as done

The coordinator agent assigns work by what each agent is good at, and writes no code itself. Only one step changes code at a time, while reviews and investigations run alongside it, read-only.

Answer

While writing the plan, the agent finds that the Purchase Approval Policy already has a rule: an order above ¥50,000 needs the purchasing manager's approval. The request doesn't say whether small orders from tier C suppliers need approval, and that is a business call.

The coordinator agent moves the issue to Blocked and spells out, in the Needs you card, what Zhou Hang has to decide. Zhou Hang sees it under Waiting for you in My issues and clicks Reply: every order from a tier C supplier needs approval regardless of amount, and other suppliers keep the amount rule. With the answer in, the coordinator agent hands development to an agent that is good at building features.

PUR-23· Supplier ManagementBlockedFollowAsk agent

Supplier scoring and tiers

Needs you

Zhou Hang: today an order needs the purchasing manager’s approval only above ¥50,000. Should every order from a tier C supplier need approval regardless of amount, or should the amount rule still apply? Development starts once you confirm.

View the coordinator agent’s latest explanation
Reply
ZEvery order from a tier C supplier needs approval regardless of amount. Other suppliers keep the amount rule.
Decisions that need a person go to the issue owner in the Needs you card

Build

The worker agent builds on a runtime, in the issue's own working directory, on a branch named agent/PUR-23 by default. It uses Core's data, permission, and approval building blocks as they are, builds only the supplier scoring and tiers, and writes tests for the acceptance scenarios. Once it commits, it opens a PR, and Studio links the PR to the issue automatically.

The top of the issue page always shows where the work stands: which agent is on it, for how long, on which machine, and what comes next.

3 / 16PUR-23· Supplier ManagementIn progressFollowAsk agent

Supplier scoring and tiers

Now
CXCodex · GPT-5.5 is running “Implement scoring and tiers per the plan” · 12 min · Server 02
Next
Once the implementation is done, an agent from another vendor reviews it, then it goes to acceptance.
OwnerZZhou HangExecutorCACoordinator agentPriorityHigh
PR #31agent/PUR-23Checks running
The top of the issue page: who is working on it now and what comes next

Check and review

The repository's CI runs lint, type, test, and build checks. When a check fails, Studio wakes the coordinator agent to arrange a fix. If the checks still fail after three fixes in a row, the issue owner is notified.

Once the checks pass, the coordinator agent has an agent from another vendor review the code. If none is online, it uses a different model from the same vendor. The model that wrote the code never reviews its own work.

PUR-23Code and deploys
Checks failedThe first commit failed test · The coordinator agent has been woken to arrange a fix
#31Supplier scoring and tiersChecks passed
lintCode style
typecheckType check
testTests · passed after the fix
buildBuild
CC
Claude · Opus 5.5Review: approved

Checked permissions, migrations, and tests: tier C orders go through the platform’s approval, the migration is self-contained, and every acceptance scenario has a test. The code was written by Codex · GPT-5.5, so this review uses a different vendor.

After a failed check is fixed, a model from another vendor reviews the code

Accept

When the PR has passed its checks and review, the coordinator agent moves the issue to In review and attaches a delivery report: how it was before, the agreed approach, what changed, how it was checked, open issues with recommendations, and finally the acceptance criteria. The building agent attached a screenshot for each acceptance scenario.

PUR-23· Supplier ManagementIn reviewFollowAsk agent

Supplier scoring and tiers

Up next
Zhou Hang reviews the delivery report and accepts PR #31.
Needs you

Zhou Hang: review the delivery report and accept the supplier tiers. If they pass, merge PR #31; if not, send it back.

Checks passed · Review: approved

MergeMark as mergedView changesSend back
Delivery report
How it was before

Suppliers had only basic profiles, with no score or tier. An order needed the purchasing manager’s approval only above ¥50,000.

What changed
  • Suppliers now have a score and a tier, A, B, or C, recalculated every night from on-time delivery, quality pass rate, and price
  • Every order to a tier C supplier now goes to the purchasing manager for approval when it is submitted, whatever the amount. Other suppliers keep the amount rule
  • New suppliers start at tier B and are re-tiered after three months
How it was checked

Walked through all three acceptance scenarios in the preview. All tests and CI passed, and a model from another vendor approved the review.

Open issues
  • Existing suppliers get a tier only after the first nightly recalculation. Recommend running it once by hand on release day.
Acceptance criteria
  • The supplier list shows each supplier’s tier (screenshot 1)
  • A ¥10,000 order to a tier C supplier goes to the purchasing manager for approval when submitted (screenshots 2 and 3)
At acceptance you read the delivery report, the acceptance criteria, and the screenshots

This project's CI deploys a preview for every PR. Zhou Hang opens the preview from the issue page, signs in as the first administrator, places a ¥10,000 order with a tier C supplier, and confirms that it goes to the purchasing manager for approval.

PUR-23Preview
Preview of procurementPR #31Ready
Addressstudio-preview.example.com/procurement-pr-31/
BuildBuilt · CI log
Runninga1b2c3d
First administratoradmin · ••••••••
OpenDeploy againDestroy
The PR's preview, where you can try the change yourself

It works as expected, so Zhou Hang clicks Merge, and the issue moves to Done. If something had been off, Zhou Hang would have clicked Send back for changes and said why, and the coordinator agent would have arranged the fix and handed it back.

Release

After the merge, the repository's CI deploys the change to staging, and the issue shows which environments it has reached.

Production is protected. When a new version is released, a deployment request lands in the approver's inbox with the version to deploy, the commit it came from, and the CI log. In this project the approver is the project lead, and the version goes to production only after approval. If something goes wrong, you can roll back to the previous version.

Issues that are done but not yet released are listed under Merged, not released in the project.

Previews and deployments need CI

PRs get previews, and merges and releases get deployed to each environment, only after the repository's CI is connected to Studio. See Connect CI.

Remember

The issue keeps its discussion, decisions, code, tests, and every run, and the code stays in the repository. The worker agent also writes what it learned into project memory, such as the rule Zhou Hang confirmed: every order from a tier C supplier needs the purchasing manager's approval, whatever the amount. Project memory lives in the repository and is reviewed and merged with the PR.

Next time Zhou Hang asks to adjust payment terms by tier, the agent reads project memory before it starts and builds on the knowledge base and the existing tests. Zhou Hang doesn't have to explain the background again, and if someone else takes over, or a different agent does the work, they can pick up where the last one left off.

What Zhou Hang did

Zhou Hang said what was needed in business terms, settled the scoring rules with their own agent, answered one question before development, tried the change in the preview, and merged. The agent team wrote the plan, the code, and the tests, and handled the fixes and the review. While the agents work, Zhou Hang can add requirements at any time by commenting on the issue. See Follow progress.

NocoBase 3 Docs · Draft 2026-10-24