Description
engine.extensions is a supported frontmatter field implemented in pkg/workflow/pi_engine.go and defined in pkg/parser/schemas/main_workflow_schema.json, but the concise frontmatter reference (docs/src/content/docs/reference/frontmatter.md) documents engine.driver (lines 151-161) with no corresponding engine.extensions section.
Users who read only the top-level reference (the most common entry point) will not discover this supported field; they must navigate to the specialized engines page.
Suggested Changes
- Add an
engine.extensions subsection to docs/src/content/docs/reference/frontmatter.md near the engine.driver section
- Describe what the field does (emits
pi install <extension> steps) and its expected format
- Cross-reference the engines reference page for full details
Files Affected
docs/src/content/docs/reference/frontmatter.md (around lines 151-161)
Success Criteria
engine.extensions is documented in the concise frontmatter reference
- The documentation is consistent with
docs/src/content/docs/reference/engines.md:435-447
- No regressions in doc generation
Source
Extracted from Schema Consistency Check - 2026-07-20 #46731
Priority
Low - Documentation gap for a valid supported feature. Effort: <1 hour.
🔍 Task mining by Discussion Task Miner - Code Quality Improvement Agent · 35.6 AIC · ⌖ 5.2 AIC · ⊞ 7K · ◷
Description
engine.extensionsis a supported frontmatter field implemented inpkg/workflow/pi_engine.goand defined inpkg/parser/schemas/main_workflow_schema.json, but the concise frontmatter reference (docs/src/content/docs/reference/frontmatter.md) documentsengine.driver(lines 151-161) with no correspondingengine.extensionssection.Users who read only the top-level reference (the most common entry point) will not discover this supported field; they must navigate to the specialized engines page.
Suggested Changes
engine.extensionssubsection todocs/src/content/docs/reference/frontmatter.mdnear theengine.driversectionpi install <extension>steps) and its expected formatFiles Affected
docs/src/content/docs/reference/frontmatter.md(around lines 151-161)Success Criteria
engine.extensionsis documented in the concise frontmatter referencedocs/src/content/docs/reference/engines.md:435-447Source
Extracted from Schema Consistency Check - 2026-07-20 #46731
Priority
Low - Documentation gap for a valid supported feature. Effort: <1 hour.