docs: add workflows/ chapter blank for review (PRD §5.4)
This commit is contained in:
@@ -0,0 +1,189 @@
|
||||
---
|
||||
status: draft-for-review
|
||||
type: chapter-template
|
||||
edition: 2026
|
||||
vertical: # real-estate | financial-advisors | fractional-c-suite | higher-ed | communities | technology
|
||||
title: ""
|
||||
authors: []
|
||||
recipe_ids: [XX-01, XX-02]
|
||||
last_updated: 2026-08-31
|
||||
---
|
||||
|
||||
# Chapter structure (for review)
|
||||
|
||||
This is the blank chapter, matching PRD §5.4 (locked 2026-08-31). Review the shape before anyone writes a real vertical.
|
||||
|
||||
**How to use it.** Copy this file to `workflows/[vertical-slug].md` (example: `workflows/real-estate.md`). Replace `XX` with the vertical prefix. Leave this file as the blank.
|
||||
|
||||
**What a chapter is.** A substantial essay for one vertical. Full workflows sit inside the argument, at the point they earn, not in an appendix and not as a stack of cards.
|
||||
|
||||
**What a workflow is.** The unit of practice. Read it, run the Try-it (~15 min), share the result. That Try-it is what counts as activation.
|
||||
|
||||
**Rules that do not move.**
|
||||
- Skip-to-Try-it at the top. Activation does not wait for the essay.
|
||||
- Safeguards before Method. Data handling is read before anyone pastes a client list.
|
||||
- Method shows real tool output, not a description of it.
|
||||
- Nested recipes stay open. Do not hide Method behind "click to reveal."
|
||||
- Every recipe has a stable ID and a heading it can link to.
|
||||
- No chatbot on the page. No crypto or Web3 language.
|
||||
- PDF must match this stack: essay + in-place recipes.
|
||||
|
||||
**Vertical prefixes**
|
||||
|
||||
| Vertical | Slug | ID prefix |
|
||||
|:--|:--|:--|
|
||||
| Real Estate | `real-estate` | `RE` |
|
||||
| Financial Advisors | `financial-advisors` | `FA` |
|
||||
| Fractional C-Suite | `fractional-c-suite` | `CS` |
|
||||
| Higher Ed | `higher-ed` | `HE` |
|
||||
| Communities | `communities` | `CM` |
|
||||
| Technology | `technology` | `TE` |
|
||||
|
||||
Fill every `[bracket]`. Two nested recipes are shown so the essay-wraps-workflow pattern is obvious. Add more at the points in the argument they belong. Delete the unused slot rather than leaving a hollow block.
|
||||
|
||||
---
|
||||
|
||||
# [Chapter title]
|
||||
|
||||
[Vertical] · 2026 edition · [Author names]
|
||||
|
||||
## What this chapter is for
|
||||
|
||||
[One short promise. The job this vertical's reader is trying to get done this week, and what they will be able to run by the end of the chapter.]
|
||||
|
||||
**Skip to a Try-it:** [XX-01](#xx-01) · [XX-02](#xx-02)
|
||||
|
||||
## [Essay: the stakes]
|
||||
|
||||
[Why this work is hard here. Specific to the vertical, not a generic AI preamble. Name the actual failure: a listing that stalls, a client file that leaks, a committee that will not move.]
|
||||
|
||||
## [Essay: constraints]
|
||||
|
||||
[What you cannot ignore in this vertical. Tools people already use. Compliance, clients, time. What "done" looks like for them.]
|
||||
|
||||
## [Essay: how we work here]
|
||||
|
||||
[The practice this chapter argues for. Then the first workflow, at the moment the argument needs proof.]
|
||||
|
||||
---
|
||||
|
||||
<a id="xx-01"></a>
|
||||
|
||||
### [Job title. This is the workflow title, written as the job.]
|
||||
|
||||
**XX-01** · v0.1 · ~[N] min · ~$[cost or "free with tools you already have"]
|
||||
|
||||
#### Problem
|
||||
|
||||
[The real task. One job, not a category.]
|
||||
|
||||
#### Actors
|
||||
|
||||
- Who runs it: [role]
|
||||
- Who is affected: [client, student, team]
|
||||
- What the model is allowed to do: [draft / classify / retrieve]. What a human must still do: [send / approve / file]
|
||||
|
||||
#### Setup
|
||||
|
||||
- Tools: [named tools, versions if it matters]
|
||||
- Sample files: [what we ship with this recipe, or "use the anonymized packet below"]
|
||||
- Cost: [model/tool cost if known. If unknown, say so.]
|
||||
|
||||
#### Safeguards
|
||||
|
||||
Read this before the steps.
|
||||
|
||||
- Data handling: [what never goes into the prompt. What is ok if stripped.]
|
||||
- Human oversight: [the checkpoint before anything leaves the building]
|
||||
- Failure modes: [how this goes wrong in this vertical]
|
||||
- Escalation: [who you call, and when you stop]
|
||||
|
||||
#### Method
|
||||
|
||||
Ordered steps. Paste the actual tool output inside the step that produced it. A screenshot or a quoted block beats a paraphrase.
|
||||
|
||||
1. [Step]
|
||||
```
|
||||
[real output]
|
||||
```
|
||||
2. [Step]
|
||||
3. [Step]
|
||||
|
||||
#### Evidence
|
||||
|
||||
[What "it worked" looks like. An artifact, a number, a before/after. Not "the user felt more confident."]
|
||||
|
||||
#### Try it (~15 min)
|
||||
|
||||
- Sample data: [what they use so they do not need a live client]
|
||||
- What to produce: [the artifact]
|
||||
- Done when: [a check they can mark. Completing this is activation.]
|
||||
|
||||
#### Share the result
|
||||
|
||||
[What they post: the outcome, not the workflow text. Point at the community template when it exists. Events, not content.]
|
||||
|
||||
**Author:** [name] · **Sources:** [links or citations] · **Last updated:** [date]
|
||||
|
||||
---
|
||||
|
||||
## [Essay continues]
|
||||
|
||||
[The argument picks back up. What the first recipe proved, what it did not. Then the next workflow, when the next claim needs proof.]
|
||||
|
||||
---
|
||||
|
||||
<a id="xx-02"></a>
|
||||
|
||||
### [Second job title]
|
||||
|
||||
**XX-02** · v0.1 · ~[N] min · ~$[cost]
|
||||
|
||||
#### Problem
|
||||
|
||||
[ ]
|
||||
|
||||
#### Actors
|
||||
|
||||
[ ]
|
||||
|
||||
#### Setup
|
||||
|
||||
[ ]
|
||||
|
||||
#### Safeguards
|
||||
|
||||
[ ]
|
||||
|
||||
#### Method
|
||||
|
||||
1. [ ]
|
||||
2. [ ]
|
||||
|
||||
#### Evidence
|
||||
|
||||
[ ]
|
||||
|
||||
#### Try it (~15 min)
|
||||
|
||||
[ ]
|
||||
|
||||
#### Share the result
|
||||
|
||||
[ ]
|
||||
|
||||
**Author:** [name] · **Sources:** [ ] · **Last updated:** [date]
|
||||
|
||||
---
|
||||
|
||||
## Further workflows in this vertical
|
||||
|
||||
- [XX-01](#xx-01) — [job title]
|
||||
- [XX-02](#xx-02) — [job title]
|
||||
- [Later IDs, once assigned]
|
||||
|
||||
## Sources
|
||||
|
||||
[Chapter-level sources. Recipe-level citations stay on the recipe.]
|
||||
|
||||
**Last updated:** 2026-08-31
|
||||
Reference in New Issue
Block a user