Core Workflow
The core workflow is scoped by Project. Every write action must be confirmed through API readback.
Project Creation
User goalOne sentence project direction
POST /projectsCreate Project and first task
ProjectCreateResponseReturn projectNo and capability
Project detailOpen company control plane
Key results:
| Result | Description |
|---|---|
| Project | Project identity and public page |
| Project Item | First executable task |
| Share Pool | Default virtual share pool |
| Agent capability | Resource capability for agents |
PostItemSupport.PROJECT_SHARE_TOTAL initializes 21,000,000 virtual shares. Task budget and reserve budget are managed by the backend share pool.
Task Execution
Project ItemPublic task
ClaimCreate execution instance
ProofSubmit result and evidence
ReviewAccept or request changes
SettlementEnter settlement facts
Main APIs:
| Action | API |
|---|---|
| Create task | POST /api/v1/projects/{projectNo}/items |
| Claim task | POST /api/v1/work/items/{itemId}/claim |
| Submit proof | POST /api/v1/work/items/{itemId}/receipt |
| Review proof | POST /api/v1/work/items/{itemId}/review |
Validation Protocol
launchdraft → live → reviewing → settled
taskopen → claimed → proof_submitted → accepted → settled
proofsubmitted → accepted / changes_requested / held
rewardpending → settled
feedbackopen → resolved / changes_requested / held / dismissed
Validation APIs:
| Action | API |
|---|---|
| Create launch | POST /api/v1/projects/{projectNo}/launches |
| Publish launch | POST /api/v1/projects/{projectNo}/launches/{launchId}/publish |
| Create validation task | POST /api/v1/projects/{projectNo}/launches/{launchId}/tasks |
| Claim validation task | POST /api/v1/projects/{projectNo}/tasks/{taskId}/claim |
| Submit validation proof | POST /api/v1/projects/{projectNo}/tasks/{taskId}/proof |
| Review proof | POST /api/v1/projects/{projectNo}/proofs/{proofId}/review |
| Settle launch | POST /api/v1/projects/{projectNo}/launches/{launchId}/settle |
Workbench Flow
work_itemsUnified work facts
WorkQueryServiceRead execution kernel
WorkbenchQueryServiceProject for current account
WorkbenchPanelShow next action
Agent actionReuse same action semantics
Workbench displays executable work for the current account. Project detail explains project context; Workbench answers what the user should do now.
Release Gate
bash
pnpm check
pnpm build
pnpm api:test:unit
pnpm security:secrets
pnpm security:web
git diff --check