xiaoju
d63d58ccb5
- Move 15 old workflow-* packages to legacy-packages/ (inactive, preserved for reference)
- Rename templates/ → examples/ for clarity
- Rewrite docs/architecture.md to reflect current uwf architecture
- Active packages remain in packages/: cli-uwf, uwf-agent-hermes, uwf-agent-kit, uwf-moderator, uwf-protocol, workflow-util
小橘 🍊（NEKO Team）
53 lines
2.0 KiB
Markdown
53 lines
2.0 KiB
Markdown
# @uncaged/workflow-template-develop
|
|
|
|
Reference **develop** workflow template: plan phases, implement in a loop, review, test, then commit.
|
|
|
|
Export a pure `WorkflowDefinition` (`developWorkflowDefinition`) and role/moderator pieces. Workflow instantiation (`createWorkflow(definition, binding)`) happens in the workflow instance layer, not in this template package.
|
|
|
|
## Install
|
|
|
|
```bash
|
|
bun add @uncaged/workflow-template-develop @uncaged/workflow zod
|
|
```
|
|
|
|
In this monorepo: `workspace:*` for `@uncaged/workflow-template-develop` and `@uncaged/workflow`.
|
|
|
|
## Usage
|
|
|
|
```typescript
|
|
import { createWorkflow } from "@uncaged/workflow";
|
|
import { developWorkflowDefinition } from "@uncaged/workflow-template-develop";
|
|
|
|
const run = createWorkflow(developWorkflowDefinition, binding);
|
|
```
|
|
|
|
## Roles
|
|
|
|
| Role | Purpose |
|
|
|------|---------|
|
|
| **planner** | Break work into ordered phases (hashes) |
|
|
| **coder** | Implement current phase; repeats until phases complete or limits hit |
|
|
| **reviewer** | Code review gate (`approved` vs send back to coder) |
|
|
| **tester** | Verify via tests/build/lint (`passed` vs send back to coder) |
|
|
| **committer** | Final commit step |
|
|
|
|
Also exported: role factories/meta schemas (`plannerRole`, `coderRole`, …), `DevelopMeta`, `developRoles`.
|
|
|
|
## Moderator flow
|
|
|
|
1. **Start** → `planner`
|
|
2. After **planner** → `coder`
|
|
3. After **coder** → if all planned phases are done (or last phase completed) → `reviewer`; else `coder` again, until `maxRounds` then `END`
|
|
4. After **reviewer** → if approved → `tester`; else `coder` (or `END` if out of rounds)
|
|
5. After **tester** → if passed → `committer`; else `coder` (or `END` if out of rounds)
|
|
6. After **committer** → `END`
|
|
|
|
## API overview
|
|
|
|
| Export | Description |
|
|
|--------|-------------|
|
|
| `developWorkflowDefinition` | `description`, `roles`, `developModerator` |
|
|
| `developModerator` | `Moderator<DevelopMeta>` |
|
|
| `buildDevelopDescriptor` | `buildDescriptor({ … })` for bundle metadata |
|
|
| `DEVELOP_WORKFLOW_DESCRIPTION` | Human-readable one-liner |
|