From fcc068bce9aa763c1123b55b6289a00eb10acbab Mon Sep 17 00:00:00 2001
From: jyviko <2501648+jyviko@users.noreply.github.com>
Date: Fri, 16 Oct 2026 08:55:34 -0400
Subject: [PATCH] docs: the ring-and-pillow layout's papers and the meshing
 skill's plan step (#455)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UhhZMBTviDQxZvwnyP89fo
---
 docs/meshing/literature.md         | 7 +++++++
 skills/fieldcraft-meshing/SKILL.md | 5 +++--
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/docs/meshing/literature.md b/docs/meshing/literature.md
index 7e0072c..af7a988 100644
--- a/docs/meshing/literature.md
+++ b/docs/meshing/literature.md
@@ -1097,6 +1097,13 @@ onto points, then smoothed). No code, manual or text of any commercial mesher wa
 - **Worst-element repair**: compass search on the local smallest scaled Jacobian (optimization-
   based smoothing, L. A. Freitag, C. Ollivier-Gooch, IJNME 40:3979–4002, 1997; metric: P. M. Knupp,
   SIAM J. Sci. Comput. 23(1):193–218, 2001).
+- **Ring-and-pillow layout of a mesh plan** (`mesh.plan`, #455): a swept body whose section is at
+  an angle to the axes (a crank arm) is blocked as an annulus round each boss's hole and a carved
+  grid over the rest, with a layer of blocks inserted between the grid's boundary and the walls
+  it faces: pillowing, S. A. Mitchell, T. J. Tautges, *Pillowing doublets: refining a mesh to
+  ensure that faces share at most one edge*, Proc. 4th International Meshing Roundtable, 231–240,
+  1995, here between a carved grid and the geometry, as the grid-based method projects its
+  boundary layer onto the surface (B1.1, Schneiders 1996).
 
 ### B10. Extrusion up to a surface (implemented in `fieldcraft-mesh::hex::extrude_to`, `mesh.hex.extrude`)
 
diff --git a/skills/fieldcraft-meshing/SKILL.md b/skills/fieldcraft-meshing/SKILL.md
index 0ce6172..14aafa5 100644
--- a/skills/fieldcraft-meshing/SKILL.md
+++ b/skills/fieldcraft-meshing/SKILL.md
@@ -46,8 +46,9 @@ keep the good half and mirror it.
 1. `mesh.plan {"body", "size"?, "layers"?}`: the block plan from the features. Nothing is meshed.
 2. Read the plan before applying it:
    - `mesher`: `project` (one block topology over the body: O-grid rings round circles, blend
-     layers along fillets, chamfers and shell walls) is the target; `cells`/`sweep` is the
-     fallback.
+     layers along fillets, chamfers and shell walls; for a section at an angle to the axes, such
+     as a crank arm, an annulus round each boss's hole and a carved grid with a pillow layer to
+     the outline) is the target; `cells`/`sweep` is the fallback.
    - `rings`: centre, radius, frame half-side. Frames should be near square with even margins.
    - `cuts`: each with its feature and reason.
    - `notes`: why the body did not fit the projection layout.