started prompt mechanics

docs/frontmatter.md

@@ -6,6 +6,8 @@ icon: lucide/braces
 
 This page defines the `SKILL.md` frontmatter and FastMCP metadata contract.
 
+Prompt modules use the same contract style in `docs/prompts/<prompt-id>/PROMPT.md` with prompt-specific capability and optional typed argument metadata.
+
 ## Anthropic Frontmatter Support
 
 Across Anthropic API and Agent Skills surfaces:
@@ -97,6 +99,35 @@ Rules for `x-personal-mcp`:
 5. `depends_on` is optional and lists other skill ids.
 6. `references` is an optional map keyed by `ref-id` for overrides and nested entries.
 
+Prompt-specific additions:
+
+1. `arguments` is an optional map keyed by argument name.
+2. Each argument supports `type`, optional `description`, optional `required`, optional `default`, and optional `enum`.
+3. `type` must be one of `string`, `number`, `integer`, `boolean`, `array`, or `object`.
+4. Prompt `capabilities` must include `resource://prompts/<prompt-id>/document`.
+
+Example prompt frontmatter:
+
+```yaml
+---
+name: initial-test-structure
+description: Generate a baseline pytest test layout for a target scope.
+x-personal-mcp:
+    id: initial-test-structure
+    version: 1.0.0
+    tags:
+        - pytest
+        - testing
+    capabilities:
+        - resource://prompts/initial-test-structure/document
+    arguments:
+        target_scope:
+            type: string
+            description: Target package or module under test.
+            required: true
+---
+```
+
 Reference entry rules:
 
 1. `ref-id` is lowercase kebab-case.