MasteryMade · Operations PRD

PRD 12: Batch MANUAL.md Generation

PRD 12 of 12 Depends: PRD 1
Parent: Master Registry v1.0 — Sections 09, 12 · Owner: Lane D (Agent Swarms)

12.1 Purpose

24 active skills, zero MANUAL.md, zero HC pages. High-leverage batch operation: agent swarm reads each SKILL.md → generates MANUAL.md + HC page + registry entry. Once complete, every skill is discoverable, documented, and has a self-healing changelog.

12.2 Agent Swarm Spec

Input per skill

{ "skill_name":"expert-research", "skill_md_path":"/mnt/skills/user/expert-research/SKILL.md",
  "skill_md_content":"...", "registry_section":"6a", "gate_access":[2,3] }

Transformation rules

SKILL.md field	MANUAL.md field	Transformation
name	Identity → name	Direct copy
description	Identity → purpose	Rewrite: "This service [does X] for [audience] by [method]."
Trigger patterns	Capabilities → triggers	Extract activation conditions
Core logic	Capabilities → what it does	Summarize as input→output pairs
Dependencies	Dependencies table	Identify other skills/services called
(not in SKILL.md)	Failure modes	AI-generated: "Given this logic, what could go wrong?"
(not in SKILL.md)	Changelog	"Generated from SKILL.md by agent swarm, [date]"

Generation prompt

You are generating a MANUAL.md for "{skill_name}".
SKILL.md content: {content}
Template: {template}

RULES:
- Identity = one sentence, what + why
- Capabilities = specific input→output pairs, not vague descriptions
- "Does NOT do" = at least 2 explicit boundaries
- Failure modes = at least 3 ways this could fail, with recovery
- Changelog starts with "Generated from SKILL.md by agent swarm, {date}"
- Do NOT invent capabilities not in SKILL.md
- If I/O format is vague, note "Format TBD" rather than guessing

12.3 Quality Gate

Automated checks

All required sections present (Identity, Capabilities, Dependencies, Failure Modes, Changelog). Generated capabilities don't contradict SKILL.md. Valid markdown. Input/output schemas are valid JSON Schema or marked TBD.

Human review (sampled)

First 3 generated: full human review (Jason). After 3 approved: spot-check every 5th. If quality degrades: pause, adjust prompt.

12.4 HC Page Generation

Convert markdown to HTML with MasteryMade CSS
Embed hc-metadata (service identity, capabilities, compliance tier)
Embed hc-instructions (behavioral rules for AI consumers)
Embed hc-context-public (I/O schemas)
Publish to plan.jasondmacdonald.com/manual/[skill-name]
Register in command center
Update services table: manual_path, hc_url, updated_at

12.5 Priority Ordering

Priority	Skills	Count	Rationale
1 (foundation)	calibrate, handoff, morning-kickstart, session-close	4	Standalone, daily use
2 (operating system)	321-exec, 321-framework-jason, jason-guardian, 2026-execution	4	Personal framework, high usage
3 (content)	jason-writer, jason-editor, blue-ocean, linkedin-growth, prompt-architect	5	Content pipeline (PRD 8)
4 (expert pipeline)	expert-research, expert-doc-processor, expert-clone-scorer, expert-test-extractor, expert-os-deployment	5	Core extraction (PRD 4)
5 (infrastructure)	n8n-builder + 6 n8n skills	7	Build infrastructure
6 (specialized)	meta-arch, arch, leverage, meeting trackers, extract-to-lists	6	Lower frequency

Total: 31 skills across all tiers.

12.6 Post-Generation Integration

Org registry services table has all skills registered
plan.jasondmacdonald.com/manual/ has page per skill
Master Registry Section 12 updatable: MANUAL.md column → links
Any skill discoverable via registry query
Future skills auto-generate MANUAL.md on creation (enhance skill-creator)

12.7 Acceptance Criteria

Agent swarm processing all 24+ SKILL.md files
Each generates valid MANUAL.md with all required sections
First 3 manuals pass full human review
Quality gate catching format/completeness issues
HC pages published to plan.jasondmacdonald.com/manual/[name]
All skills registered in org registry services table
Command center registrations for all HC pages
No capabilities invented beyond SKILL.md source
Failure modes populated (at least 3 per skill)
Changelog initialized with generation record
Master Registry Section 12 updatable with links

↑ Registry ← PRD 11

MASTERYMADE — PRD 12 of 12

Dominia Facta. Build what compounds.