60 lines
2.0 KiB
Markdown
60 lines
2.0 KiB
Markdown
# Zopu Work OS — Documentation Map
|
||
|
||
Dense context set for product development and coding agents.
|
||
|
||
## Read order
|
||
|
||
```text
|
||
1. agent-context.md — bootstrap and non-negotiables
|
||
2. product.md — product model and quality doctrine
|
||
3. glossary.md — canonical terminology
|
||
4. dev-loop.md — normative software delivery process
|
||
5. tech.md — architecture, actors, ports, runtimes
|
||
6. design.md — user experience
|
||
7. slices.md — sequential vertical product increments
|
||
8. dev-plan.md — repository execution plan/backlog
|
||
9. evaluation.md — quality measurement and improvement
|
||
```
|
||
|
||
For a runnable development environment, see [`LOCAL_SETUP.md`](LOCAL_SETUP.md).
|
||
|
||
## Use by role
|
||
|
||
| Role | Minimum context |
|
||
| --- | --- |
|
||
| Product/definition agent | agent-context, product, glossary, dev-loop |
|
||
| Architecture/design agent | agent-context, tech, dev-loop, current Work Definition |
|
||
| Coding agent | agent-context, current Design Packet/Slice, tech sections, repository rules |
|
||
| Verifier | agent-context, dev-loop, evaluation, Verification Plan |
|
||
| Frontend agent | agent-context, design, product, current slice |
|
||
| Lead/orchestrator | all documents, current repository state, active decisions |
|
||
|
||
## Document boundaries
|
||
|
||
```text
|
||
product.md what/why
|
||
tech.md system architecture
|
||
design.md interaction behavior
|
||
dev-loop.md how software Work is delivered
|
||
slices.md how Zopu product is incrementally built
|
||
dev-plan.md engineering order and release gates
|
||
evaluation.md how quality and improvements are measured
|
||
glossary.md exact term definitions
|
||
agent-context compact instructions for execution agents
|
||
```
|
||
|
||
## First build target
|
||
|
||
```text
|
||
message
|
||
→ Signal
|
||
→ approved Work Definition
|
||
→ approved Design Packet
|
||
→ one isolated implementation slice
|
||
→ independent verification
|
||
→ exact verified PR
|
||
→ human question/resume
|
||
```
|
||
|
||
Start at `dev-plan.md` backlog item 01. Do not begin dynamic Kit Builder or fleets before Slices 1–7 work reliably.
|