moai-workflow-pencil-integration

Write batch operations in pencil-plan.md using the I(parentId, props), M(nodeId, parentId, index), and R(nodeId) DSL, grouped under ## Batch N headings. The Skill parses the file, executes each batch via mcp__pencil__batch_design, and verifies layouts automatically.

Phase B2.6 invokes the integration only when .moai/design/pencil-plan.md exists and at least one .pen file exists in .moai/design/ or the project root. If either condition fails, the phase skips gracefully and proceeds to Phase B3.

This error occurs when mcp__pencil__get_editor_state reports a connection failure or the open document does not match the detected .pen file. Restart Claude Desktop or open the correct .pen file in Pencil, then retry.

Batches exceeding 25 operations are split into sub-batches of at most 25 operations while preserving order. Sub-batches execute sequentially, each with its own batch_design call, layout snapshot check, and screenshot archival.

The parser scans the entire file and collects every unrecognized token as {line_number, offending_text} entries rather than halting on the first error. It returns PENCIL_PLAN_SYNTAX_ERROR with the complete list so all issues can be fixed in one pass.