-
Notifications
You must be signed in to change notification settings - Fork 0
improvement: generate schema.json from manifest.md frontmatter #452
Copy link
Copy link
Open
Labels
P1Critical / blocks current releaseCritical / blocks current releasearea:scriptsScript tooling and verificationScript tooling and verificationenhancementNew feature or requestNew feature or requestroadmap:automation-hardeningv0.7 automation contract — registry, verify tiers, agent checks, Zod runtime validationv0.7 automation contract — registry, verify tiers, agent checks, Zod runtime validationroadmap:mcp-serverMCP server exposing workflow.* methods so any LLM client can drive the 12-stage methodologyMCP server exposing workflow.* methods so any LLM client can drive the 12-stage methodologytrack:specorator-improvementImprovement to the Specorator template itselfImprovement to the Specorator template itself
Description
Metadata
Metadata
Assignees
Labels
P1Critical / blocks current releaseCritical / blocks current releasearea:scriptsScript tooling and verificationScript tooling and verificationenhancementNew feature or requestNew feature or requestroadmap:automation-hardeningv0.7 automation contract — registry, verify tiers, agent checks, Zod runtime validationv0.7 automation contract — registry, verify tiers, agent checks, Zod runtime validationroadmap:mcp-serverMCP server exposing workflow.* methods so any LLM client can drive the 12-stage methodologyMCP server exposing workflow.* methods so any LLM client can drive the 12-stage methodologytrack:specorator-improvementImprovement to the Specorator template itselfImprovement to the Specorator template itself
Context
Part of the plugin audit in #444 (§2, R2). The 12
manifest.md/schema.jsonpairs underplugins/are currently maintained manually — creating drift risk. The audit flags this as blocking for the MCP Server (issue #316) because it consumesschema.jsonin production.Work
Add a build step that generates
plugins/*/schema.jsonfrom the YAML frontmatter of each correspondingmanifest.md.High-level approach:
scripts/build-claude-plugin.ts(or a newscripts/generate-plugin-schemas.ts) to:plugins/*/manifest.mdschema.jsonin the same foldergenerate:schemasnpm scriptcheck:schemasnpm script that diffs generated vs. committed — fails CI if stalenpm run verifyConstraints
schema.jsonfiles must match generated output (checked bycheck:schemasin CI)schema.jsondirectlyDefinition of Done
generate:schemasproducesschema.jsonfor all 12 plugin manifest pairscheck:schemasfails if anyschema.jsonis stale vs. itsmanifest.mdnpm run verifyincludescheck:schemasschema.jsonedits required after this landsReferences