feat(ipa): Add <Workflow> evaluation-steps component

docusaurus.config.ts

@@ -7,6 +7,12 @@ import { themes } from "prism-react-renderer";
 import parseFrontMatter from "./src/plugins/parsePrincipleFrontMatter";
 
 const config: Config = {
+  customFields: {
+    // Workflows are primarily agent-executed evaluation steps; hide them
+    // from the rendered site. Flip to true to show them again.
+    showWorkflows: false,
+  },
+
   title: "IPA - Improvement Proposal for APIs",
   url: "https://mongodb.github.io", // Your website URL
   baseUrl: "/ipa/",

ipa/dev/component-fixtures.mdx

@@ -9,7 +9,12 @@ description:
   production builds."
 ---
 
-import { Guidelines, Guideline, Example } from "@site/src/components/ipa";
+import {
+  Guidelines,
+  Guideline,
+  Example,
+  Workflow,
+} from "@site/src/components/ipa";
 
 # Component fixtures
 
@@ -113,3 +118,55 @@ name: list-resources
 ```
 
 </Example.Incorrect>
+
+## `<Workflow>`
+
+`<Workflow>` renders the manual evaluation steps of a guideline as a numbered
+reading list inside a collapsible accordion. It is intentionally stateless —
+interactivity can be layered on later if reviewers ask for it.
+
+:::note The site currently sets `showWorkflows: false` in
+`docusaurus.config.ts`, so the fixtures below render nothing. Flip the flag to
+`true` to preview them. :::
+
+### Inside a guideline
+
+The primary use: a guideline documents the steps a reviewer or agent follows to
+evaluate the rule. The component renders the same regardless of the guideline's
+metadata.
+
+<Guideline
+  id="IPA-9999-must-use-american-english"
+  state="adopt"
+  effort="check"
+  given="spec"
+>
+  API producers must use American English for all user-facing text in the API
+  specification.
+
+  <Workflow>
+    <Workflow.Step>
+      Scan every user-facing string in the specification (descriptions,
+      summaries, enum values, field names).
+    </Workflow.Step>
+    <Workflow.Step>
+      For each string, check for common British English spellings (e.g.,
+      "cancelled", "colour", "authorise", "behaviour", "organisation").
+    </Workflow.Step>
+    <Workflow.Step>
+      Consult Merriam-Webster's dictionary for the preferred American English
+      form.
+    </Workflow.Step>
+    <Workflow.Step>
+      Flag any non-American spelling as a violation.
+    </Workflow.Step>
+  </Workflow>
+</Guideline>
+
+### Standalone with a custom title
+
+<Workflow title="Implementation steps">
+  <Workflow.Step>Add the field to the OpenAPI schema.</Workflow.Step>
+  <Workflow.Step>Regenerate the SDK clients.</Workflow.Step>
+  <Workflow.Step>Update the changelog entry.</Workflow.Step>
+</Workflow>

package.json

@@ -41,6 +41,8 @@
     "@docusaurus/theme-search-algolia": "^3.8.1",
     "@easyops-cn/docusaurus-search-local": "^0.51.1",
     "clsx": "^2.1.1",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "zod": "^4.3.6"
   }
 }